Package org.cometd.annotation

Class ClientAnnotationProcessor

java.lang.Object

org.cometd.annotation.ClientAnnotationProcessor

public class ClientAnnotationProcessor
extends Object

Processes annotations in client-side service objects.

Service objects must be annotated with Service at class level to be processed by this processor, for example:

 @Service
 public class MyService
 {
     @Listener(Channel.META_CONNECT)
     public void metaConnect(Message message)
     {
         // Do something
     }
 }
 

The processor is used in this way:

 ClientSession bayeux = ...;
 ClientAnnotationProcessor processor = ClientAnnotationProcessor.get(bayeux);
 MyService s = new MyService();
 processor.process(s);
 

See Also:

ServerAnnotationProcessor

Field Summary

Fields

Modifier and Type	Field	Description
protected org.slf4j.Logger	logger

Constructor Summary

Constructors

Constructor	Description
ClientAnnotationProcessor(ClientSession clientSession)
ClientAnnotationProcessor(ClientSession clientSession, Object... injectables)

Method Summary

Modifier and Type	Method	Description
protected static Object	callPublic(Object target, Method method, Object... arguments)
protected static void	checkMethodsPublic(Object bean, Class<? extends Annotation> annotationClass)
protected static void	checkSignaturesMatch(Method method, Class<?>[] expectedTypes, List<String> paramNames)
boolean	deprocess(Object bean)	Performs the opposite processing done by process(Object) on callbacks methods annotated with Listener and Subscription, and on lifecycle methods annotated with PreDestroy.
boolean	deprocessCallbacks(Object bean)	Performs the opposite processing done by processCallbacks(Object) on callback methods annotated with Listener and Subscription.
protected List<Method>	findAnnotatedMethods(Object bean, Class<? extends Annotation> annotationClass)
protected Object	getField(Object bean, Field field)
protected Object	invokePrivate(Object bean, Method method, Object... args)
protected static Object	invokePublic(Object target, Method method, Object[] arguments)
boolean	process(Object bean)	Processes dependencies annotated with Session, callbacks annotated with Listener and Subscription and lifecycle methods annotated with PostConstruct.
protected boolean	processInjectable(Object bean, Object injectable)
protected boolean	processInjectables(Object bean, List<Object> injectables)
protected List<String>	processParameters(Method method)
boolean	processPostConstruct(Object bean)	Processes lifecycle methods annotated with PostConstruct.
boolean	processPreDestroy(Object bean)	Processes lifecycle methods annotated with PreDestroy.
protected void	setField(Object bean, Field field, Object value)

Methods inherited from class java.lang.Object

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

Field Details

logger

protected final org.slf4j.Logger logger

Constructor Details

ClientAnnotationProcessor

public ClientAnnotationProcessor(ClientSession clientSession)

ClientAnnotationProcessor

public ClientAnnotationProcessor(ClientSession clientSession, Object... injectables)

Method Details

process

public boolean process(Object bean)

Processes dependencies annotated with Session, callbacks annotated with Listener and Subscription and lifecycle methods annotated with PostConstruct.

Parameters:

bean - the annotated service instance

Returns:

true if at least one dependency or callback has been processed, false otherwise

processPostConstruct

public boolean processPostConstruct(Object bean)

Processes lifecycle methods annotated with PostConstruct.

Parameters:

bean - the annotated service instance

Returns:

true if at least one lifecycle method has been invoked, false otherwise

deprocess

public boolean deprocess(Object bean)

Performs the opposite processing done by process(Object) on callbacks methods annotated with Listener and Subscription, and on lifecycle methods annotated with PreDestroy.

Parameters:

bean - the annotated service instance

Returns:

true if at least one deprocessing has been performed, false otherwise

See Also:

process(Object)

deprocessCallbacks

public boolean deprocessCallbacks(Object bean)

Performs the opposite processing done by processCallbacks(Object) on callback methods annotated with Listener and Subscription.

Parameters:

bean - the annotated service instance

Returns:

true if the at least one callback has been deprocessed

processPreDestroy

public boolean processPreDestroy(Object bean)

Processes lifecycle methods annotated with PreDestroy.

Parameters:

bean - the annotated service instance

Returns:

true if at least one lifecycle method has been invoked, false otherwise

findAnnotatedMethods

protected List<Method> findAnnotatedMethods(Object bean, Class<? extends Annotation> annotationClass)

processParameters

protected List<String> processParameters(Method method)

invokePrivate

protected Object invokePrivate(Object bean, Method method, Object... args)

invokePublic

protected static Object invokePublic(Object target, Method method, Object[] arguments) throws Throwable

Throws:

Throwable

callPublic

protected static Object callPublic(Object target, Method method, Object... arguments)

getField

protected Object getField(Object bean, Field field)

setField

protected void setField(Object bean, Field field, Object value)

checkMethodsPublic

protected static void checkMethodsPublic(Object bean, Class<? extends Annotation> annotationClass)

checkSignaturesMatch

protected static void checkSignaturesMatch(Method method, Class<?>[] expectedTypes, List<String> paramNames)

processInjectables

protected boolean processInjectables(Object bean, List<Object> injectables)

processInjectable

protected boolean processInjectable(Object bean, Object injectable)