Package com.google.web.bindery.requestfactory.server

Class ReflectiveServiceLayer

java.lang.Object

com.google.web.bindery.requestfactory.server.ServiceLayer

com.google.web.bindery.requestfactory.server.ServiceLayerDecorator

com.google.web.bindery.requestfactory.server.ReflectiveServiceLayer

final class ReflectiveServiceLayer
extends ServiceLayerDecorator

Implements all methods that interact with domain objects.

Field Summary

Fields inherited from class com.google.web.bindery.requestfactory.server.ServiceLayerDecorator

next

Fields inherited from class com.google.web.bindery.requestfactory.server.ServiceLayer

top

Constructor Summary

Constructors

Constructor	Description
ReflectiveServiceLayer()

Method Summary

Modifier and Type	Method	Description
<T> T	createDomainObject(Class<T> clazz)	Create an instance of the requested domain type.
Method	getGetter(Class<?> domainType, String property)	Determine the method to invoke when retrieving the given property.
Object	getId(Object domainObject)	Return the persistent id for a domain object.
Class<?>	getIdType(Class<?> domainType)	Returns the type of object the domain type's findFoo() or Locator.getId() expects to receive.
Object	getProperty(Object domainObject, String property)	Retrieve the named property from the domain object.
Type	getRequestReturnType(Method contextMethod)	Compute the return type for a method declared in a RequestContext by analyzing the generic method declaration.
Method	getSetter(Class<?> domainType, String property)	Determine the method to invoke when setting the given property.
Object	getVersion(Object domainObject)	May return null to indicate that the domain object has not been persisted.
Object	invoke(Method domainMethod, Object... args)	Invoke a domain service method.
boolean	isLive(Object domainObject)	This implementation attempts to re-load the object from the backing store.
<T> T	loadDomainObject(Class<T> clazz, Object id)	Load an object from the backing store.
List<Object>	loadDomainObjects(List<Class<?>> classes, List<Object> domainIds)	Load multiple objects from the backing store.
void	setProperty(Object domainObject, String property, Class<?> expectedType, Object value)	Sets a property on a domain object.
<T> Set<ConstraintViolation<T>>	validate(T domainObject)	Invoke a JSR 303 validator on the given domain object.

Methods inherited from class com.google.web.bindery.requestfactory.server.ServiceLayerDecorator

createLocator, createServiceInstance, createServiceLocator, die, getDomainClassLoader, getNext, getTop, report, report, requiresServiceLocator, resolveClass, resolveClientType, resolveDomainClass, resolveDomainMethod, resolveLocator, resolveRequestContext, resolveRequestContextMethod, resolveRequestFactory, resolveServiceClass, resolveServiceLocator, resolveTypeToken

Methods inherited from class com.google.web.bindery.requestfactory.server.ServiceLayer

create

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ReflectiveServiceLayer

ReflectiveServiceLayer()

Method Details

createDomainObject

public <T> T createDomainObject(Class<T> clazz)

Description copied from class: ServiceLayer

Create an instance of the requested domain type.

Overrides:

createDomainObject in class ServiceLayerDecorator

Type Parameters:

T - the requested domain type

Parameters:

clazz - the requested domain type

Returns:

an instance of the requested domain type

getGetter

public Method getGetter(Class<?> domainType,
 String property)

Description copied from class: ServiceLayer

Determine the method to invoke when retrieving the given property.

Overrides:

getGetter in class ServiceLayerDecorator

Parameters:

domainType - a domain entity type

property - the name of the property to be retrieved

Returns:

the Method that should be invoked to retrieve the property or null if the method could not be located

getId

public Object getId(Object domainObject)

Description copied from class: ServiceLayer

Return the persistent id for a domain object. May return null to indicate that the domain object has not been persisted. The value returned from this method must be a simple type (e.g. Integer, String) or a domain type for which a mapping to an EntityProxy or Value proxy exists.

The values returned from this method may be passed to ServiceLayer.loadDomainObject(Class, Object) in the future.

Overrides:

getId in class ServiceLayerDecorator

Parameters:

domainObject - a domain object

Returns:

the persistent id of the domain object or null if the object is not persistent

getIdType

public Class<?> getIdType(Class<?> domainType)

Description copied from class: ServiceLayer

Returns the type of object the domain type's findFoo() or Locator.getId() expects to receive.

Overrides:

getIdType in class ServiceLayerDecorator

Parameters:

domainType - a domain entity type

Returns:

the type of the persistent id value used to represent the domain type

getProperty

public Object getProperty(Object domainObject,
 String property)

Description copied from class: ServiceLayer

Retrieve the named property from the domain object.

Overrides:

getProperty in class ServiceLayerDecorator

Parameters:

domainObject - the domain object being examined

property - the property name

Returns:

the value of the property

getRequestReturnType

public Type getRequestReturnType(Method contextMethod)

Description copied from class: ServiceLayer

Compute the return type for a method declared in a RequestContext by analyzing the generic method declaration.

Overrides:

getRequestReturnType in class ServiceLayerDecorator

getSetter

public Method getSetter(Class<?> domainType,
 String property)

Description copied from class: ServiceLayer

Determine the method to invoke when setting the given property.

Overrides:

getSetter in class ServiceLayerDecorator

Parameters:

domainType - a domain entity type

property - the name of the property to be set

Returns:

the Method that should be invoked to set the property or null if the method could not be located

getVersion

public Object getVersion(Object domainObject)

Description copied from class: ServiceLayer

May return null to indicate that the domain object has not been persisted. The value returned from this method must be a simple type (e.g. Integer, String) or a domain type for which a mapping to an EntityProxy or Value proxy exists.

Overrides:

getVersion in class ServiceLayerDecorator

Parameters:

domainObject - a domain object

Returns:

the version of the domain object or null if the object is not persistent

invoke

public Object invoke(Method domainMethod,
 Object... args)

Description copied from class: ServiceLayer

Invoke a domain service method. The underlying eventually calls Method.invoke(Object, Object...).

Overrides:

invoke in class ServiceLayerDecorator

Parameters:

domainMethod - the method to invoke

args - the arguments to pass to the method

Returns:

the value returned from the method invocation

isLive

public boolean isLive(Object domainObject)

This implementation attempts to re-load the object from the backing store.

Overrides:

isLive in class ServiceLayerDecorator

Parameters:

domainObject - a domain entity

Returns:

true if domainObject could be retrieved at a later point in time

loadDomainObject

public <T> T loadDomainObject(Class<T> clazz,
 Object id)

Description copied from class: ServiceLayer

Load an object from the backing store. This method may return null to indicate that the requested object is no longer available.

Overrides:

loadDomainObject in class ServiceLayerDecorator

Type Parameters:

T - the type of object to load

Parameters:

clazz - the type of object to load

id - an id previously returned from ServiceLayer.getId(Object)

Returns:

the requested object or null if it is irretrievable

loadDomainObjects

public List<Object> loadDomainObjects(List<Class<?>> classes,
 List<Object> domainIds)

Description copied from class: ServiceLayer

Load multiple objects from the backing store. This method is intended to allow more efficient access to the backing store by providing all objects referenced in an incoming payload.

The default implementation of this method will delegate to ServiceLayer.loadDomainObject(Class, Object).

Overrides:

loadDomainObjects in class ServiceLayerDecorator

Parameters:

classes - type type of each object to load

domainIds - the ids previously returned from ServiceLayer.getId(Object)

Returns:

the requested objects, elements of which may be null if the requested objects were irretrievable

setProperty

public void setProperty(Object domainObject,
 String property,
 Class<?> expectedType,
 Object value)

Description copied from class: ServiceLayer

Sets a property on a domain object.

Overrides:

setProperty in class ServiceLayerDecorator

Parameters:

domainObject - the domain object to operate on

property - the name of the property to set

expectedType - the type of the property

value - the new value

validate

public <T> Set<ConstraintViolation<T>> validate(T domainObject)

Description copied from class: ServiceLayer

Invoke a JSR 303 validator on the given domain object. If no validator is available, this method is a no-op.

Overrides:

validate in class ServiceLayerDecorator

Type Parameters:

T - the type of data being validated

Parameters:

domainObject - the domain objcet to validate

Returns:

the violations associated with the domain object