Package com.google.web.bindery.requestfactory.apt

Class State

java.lang.Object

com.google.web.bindery.requestfactory.apt.State

Direct Known Subclasses:

State.ForTesting

class State
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	State.ForTesting	Slightly tweaked implementation used when running tests.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) final TypeMirror	baseProxyType
(package private) final Elements	elements
(package private) final DeclaredType	entityProxyIdType
(package private) final DeclaredType	entityProxyType
(package private) final DeclaredType	extraTypesAnnotation
(package private) final Filer	filer
(package private) final DeclaredType	instanceRequestType
(package private) final DeclaredType	locatorType
(package private) final DeclaredType	objectType
(package private) final DeclaredType	requestContextType
(package private) final DeclaredType	requestFactoryType
(package private) final DeclaredType	requestType
(package private) final Set<TypeElement>	seen
(package private) final DeclaredType	serviceLocatorType
(package private) final Types	types
(package private) final DeclaredType	valueProxyType

Constructor Summary

Constructors

Constructor	Description
State(ProcessingEnvironment processingEnv)

Method Summary

Modifier and Type	Method	Description
void	addMapping(ExecutableElement clientMethod, ExecutableElement domainMethod)	Add a mapping from a client method to a domain method.
void	addMapping(TypeElement clientType, TypeElement domainType)	Add a mapping from a client type to a domain type.
void	checkExtraTypes(Element x)	Check an element for an ExtraTypes annotation.
void	debug(Element elt, String message, Object... args)	Print a warning message if verbose mode is enabled.
void	executeJobs()
DeclaredType	findType(Class<?> clazz)	Utility method to look up raw types from class literals.
Map<Element,Element>	getClientToDomainMap()	Returns a map of client elements to their domain counterparts.
boolean	isClientOnly()
boolean	isMappingRequired(TypeElement element)
boolean	isPoisoned()
boolean	isTransportableType(TypeMirror asType)	Verifies that the given type may be used with RequestFactory.
void	maybeScanContext(TypeElement requestContext)
void	maybeScanFactory(TypeElement factoryType)
void	maybeScanProxy(TypeElement proxyType)
boolean	mustResolveAllAnnotations()
void	poison(Element elt, String message)	Emits a fatal error message attached to an element.
void	requireMapping(TypeElement interfaceElement)
(package private) boolean	respectAnnotations()	This switch allows the RfValidatorTest code to be worked on in the IDE without causing compilation failures.
void	setClientOnly(boolean clientOnly)	Set to true to indicate that only JVM-client support code needs to be generated.
void	setMustResolveAllMappings(boolean requireAllMappings)	Set to true if it is an error for unresolved ProxyForName and ServiceName annotations to be left over.
(package private) static TypeMirror	viewAs(DeclaredType desiredType, TypeMirror searchFrom, State state)	Used to take a FooRequest extends Request<Foo> and find the Request<Foo> type.
void	warn(Element elt, String message)	Emits a warning message, unless the element or an enclosing element are annotated with a @SuppressWarnings("requestfactory").

Methods inherited from class java.lang.Object

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

Field Details

baseProxyType

final TypeMirror baseProxyType

elements

final Elements elements

entityProxyIdType

final DeclaredType entityProxyIdType

entityProxyType

final DeclaredType entityProxyType

extraTypesAnnotation

final DeclaredType extraTypesAnnotation

filer

final Filer filer

instanceRequestType

final DeclaredType instanceRequestType

locatorType

final DeclaredType locatorType

objectType

final DeclaredType objectType

requestContextType

final DeclaredType requestContextType

requestFactoryType

final DeclaredType requestFactoryType

requestType

final DeclaredType requestType

serviceLocatorType

final DeclaredType serviceLocatorType

seen

final Set<TypeElement> seen

types

final Types types

valueProxyType

final DeclaredType valueProxyType

Constructor Details

State

public State(ProcessingEnvironment processingEnv)

Method Details

viewAs

static TypeMirror viewAs(DeclaredType desiredType,
 TypeMirror searchFrom,
 State state)

Used to take a FooRequest extends Request<Foo> and find the Request<Foo> type.

addMapping

public void addMapping(ExecutableElement clientMethod,
 ExecutableElement domainMethod)

Add a mapping from a client method to a domain method.

addMapping

public void addMapping(TypeElement clientType,
 TypeElement domainType)

Add a mapping from a client type to a domain type.

checkExtraTypes

public void checkExtraTypes(Element x)

Check an element for an ExtraTypes annotation. Handles both methods and types.

debug

public void debug(Element elt,
 String message,
 Object... args)

Print a warning message if verbose mode is enabled. A warning is used to ensure that the message shows up in Eclipse's editor (a note only makes it into the error console).

executeJobs

public void executeJobs()

findType

public DeclaredType findType(Class<?> clazz)

Utility method to look up raw types from class literals.

getClientToDomainMap

public Map<Element,Element> getClientToDomainMap()

Returns a map of client elements to their domain counterparts. The keys may be RequestContext or Proxy types or methods within those types.

isClientOnly

public boolean isClientOnly()

isMappingRequired

public boolean isMappingRequired(TypeElement element)

isPoisoned

public boolean isPoisoned()

isTransportableType

public boolean isTransportableType(TypeMirror asType)

Verifies that the given type may be used with RequestFactory.

See Also:

• TransportableTypeVisitor

maybeScanContext

public void maybeScanContext(TypeElement requestContext)

maybeScanFactory

public void maybeScanFactory(TypeElement factoryType)

maybeScanProxy

public void maybeScanProxy(TypeElement proxyType)

mustResolveAllAnnotations

public boolean mustResolveAllAnnotations()

poison

public void poison(Element elt,
 String message)

Emits a fatal error message attached to an element. If the element or an eclosing type is annotated with SkipInterfaceValidation the message will be dropped.

requireMapping

public void requireMapping(TypeElement interfaceElement)

setClientOnly

public void setClientOnly(boolean clientOnly)

Set to true to indicate that only JVM-client support code needs to be generated.

setMustResolveAllMappings

public void setMustResolveAllMappings(boolean requireAllMappings)

Set to true if it is an error for unresolved ProxyForName and ServiceName annotations to be left over.

warn

public void warn(Element elt,
 String message)

Emits a warning message, unless the element or an enclosing element are annotated with a @SuppressWarnings("requestfactory").

respectAnnotations

boolean respectAnnotations()

This switch allows the RfValidatorTest code to be worked on in the IDE without causing compilation failures.