Package org.atmosphere.config.managed

Class AnnotatedLifecycle

java.lang.Object

org.atmosphere.config.managed.AnnotatedLifecycle

public final class AnnotatedLifecycle
extends Object

Shared lifecycle and injection support for annotated endpoint classes (@ManagedService, @AiEndpoint). Scans for @Ready, @Disconnect, and @PathParam annotations, and handles field injection via InjectableObjectFactory.

Method Summary

Modifier and Type	Method	Description
Method	disconnectMethod()
static Method	findMethod(Class<?> clazz, Class<? extends Annotation> annotation)	Finds the first method annotated with the given annotation.
static boolean	hasPathParamFields(Class<?> clazz)	Checks whether the class has any @PathParam-annotated fields.
boolean	hasPathParams()
Method	heartbeatMethod()
static void	injectFields(AtmosphereFramework framework, Object instance)	Injects @Inject-annotated fields on the target instance at registration time using Atmosphere's InjectableObjectFactory.
void	injectPathParams(Object target, AtmosphereResource resource, String pathTemplate, AtmosphereConfig config)	Injects @PathParam-annotated fields on the target instance for the current request.
void	onDisconnect(Object target, AtmosphereResourceEvent event)	Invokes the @Disconnect-annotated method if present.
void	onHeartbeat(Object target, AtmosphereResourceEvent event)	Invokes the @Heartbeat-annotated method if present.
void	onReady(Object target, AtmosphereResource resource)	Invokes the @Ready-annotated method if present.
Method	readyMethod()
static AnnotatedLifecycle	scan(Class<?> clazz)	Scans the given class for @Ready, @Disconnect methods and @PathParam fields.

Methods inherited from class java.lang.Object

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

Method Details

scan

public static AnnotatedLifecycle scan(Class<?> clazz)

Scans the given class for @Ready, @Disconnect methods and @PathParam fields.

Parameters:

clazz - the annotated endpoint class

Returns:

an immutable lifecycle descriptor

onReady

public void onReady(Object target,
 AtmosphereResource resource)

Invokes the @Ready-annotated method if present. Supports signatures: (), (AtmosphereResource).

onDisconnect

public void onDisconnect(Object target,
 AtmosphereResourceEvent event)

Invokes the @Disconnect-annotated method if present. Supports signatures: (), (AtmosphereResourceEvent).

onHeartbeat

public void onHeartbeat(Object target,
 AtmosphereResourceEvent event)

Invokes the @Heartbeat-annotated method if present. Supports signatures: (), (AtmosphereResourceEvent).

readyMethod

public Method readyMethod()

disconnectMethod

public Method disconnectMethod()

heartbeatMethod

public Method heartbeatMethod()

hasPathParams

public boolean hasPathParams()

injectPathParams

public void injectPathParams(Object target,
 AtmosphereResource resource,
 String pathTemplate,
 AtmosphereConfig config)

Injects @PathParam-annotated fields on the target instance for the current request. Sets the request attribute that PathParamIntrospector expects, then delegates to Utils.inject(Object, Class, AtmosphereResource).

Parameters:

target - the endpoint instance

resource - the current atmosphere resource

pathTemplate - the path template (e.g. "/chat/{room}")

config - the atmosphere configuration

injectFields

public static void injectFields(AtmosphereFramework framework,
 Object instance)

Injects @Inject-annotated fields on the target instance at registration time using Atmosphere's InjectableObjectFactory.

Parameters:

framework - the atmosphere framework

instance - the endpoint instance to inject into

findMethod

public static Method findMethod(Class<?> clazz,
 Class<? extends Annotation> annotation)

Finds the first method annotated with the given annotation. Checks all public methods (including inherited) via Class.getMethods().

Parameters:

clazz - the class to scan

annotation - the annotation to look for

Returns:

the annotated method, or null if not found

hasPathParamFields

public static boolean hasPathParamFields(Class<?> clazz)

Checks whether the class has any @PathParam-annotated fields.

Parameters:

clazz - the class to scan

Returns:

true if at least one field is annotated with @PathParam