org.glassfish.api.invocation

Class InvocationManagerImpl

java.lang.Object

org.glassfish.api.invocation.InvocationManagerImpl

All Implemented Interfaces:

InvocationManager

@Service
 @Singleton
public class InvocationManagerImpl
extends Object
implements InvocationManager

Constructor Summary

Constructors

Constructor and Description
InvocationManagerImpl()

Method Summary

Modifier and Type	Method and Description
List	getAllInvocations()
<T extends ComponentInvocation> T	getCurrentInvocation() return the Invocation object of the component being called
<T extends ComponentInvocation> T	getPreviousInvocation() return the Inovcation object of the caller return null if none exist (e.g.
boolean	isInvocationStackEmpty() return true iff no invocations on the stack for this thread
ApplicationEnvironment	peekAppEnvironment() Gets the current application environment on the current thread
List<? extends ComponentInvocation>	popAllInvocations()
void	popAppEnvironment() To be called by the infrastructure to indicate that some user code not associated with any Java EE specification is finished being called.
<T extends ComponentInvocation> void	postInvoke(T inv) To be called by a Container to indicate that the Container has just completed the invocation of a method on a component.
<T extends ComponentInvocation> void	preInvoke(T inv) To be called by a Container to indicate that the Container is about to invoke a method on a component.
void	pushAppEnvironment(ApplicationEnvironment env) To be called by the infrastructure to indicate that some user code not associated with any Java EE specification may be called.
void	putAllInvocations(List<? extends ComponentInvocation> invocations)
void	registerComponentInvocationHandler(ComponentInvocation.ComponentInvocationType type, RegisteredComponentInvocationHandler handler)

Methods inherited from class java.lang.Object

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

Constructor Detail

InvocationManagerImpl

public InvocationManagerImpl()

Method Detail

preInvoke

public <T extends ComponentInvocation> void preInvoke(T inv)
                                               throws InvocationException

Description copied from interface: InvocationManager

To be called by a Container to indicate that the Container is about to invoke a method on a component. The preInvoke and postInvoke must be called in pairs and well-nested.

Specified by:

preInvoke in interface InvocationManager

Parameters:

inv - the Invocation object

Throws:

InvocationException

postInvoke

public <T extends ComponentInvocation> void postInvoke(T inv)
                                                throws InvocationException

Description copied from interface: InvocationManager

To be called by a Container to indicate that the Container has just completed the invocation of a method on a component. The preInvoke and postInvoke must be called in pairs and well-nested.

Specified by:

postInvoke in interface InvocationManager

Parameters:

inv - the Invocation object

Throws:

InvocationException

isInvocationStackEmpty

public boolean isInvocationStackEmpty()

return true iff no invocations on the stack for this thread

Specified by:

isInvocationStackEmpty in interface InvocationManager

Returns:

getCurrentInvocation

public <T extends ComponentInvocation> T getCurrentInvocation()

return the Invocation object of the component being called

Specified by:

getCurrentInvocation in interface InvocationManager

Type Parameters:

T -

Returns:

getPreviousInvocation

public <T extends ComponentInvocation> T getPreviousInvocation()
                                                        throws InvocationException

return the Inovcation object of the caller return null if none exist (e.g. caller is from another VM)

Specified by:

getPreviousInvocation in interface InvocationManager

Type Parameters:

T -

Returns:

Throws:

InvocationException

getAllInvocations

public List getAllInvocations()

Specified by:

getAllInvocations in interface InvocationManager

popAllInvocations

public List<? extends ComponentInvocation> popAllInvocations()

Specified by:

popAllInvocations in interface InvocationManager

putAllInvocations

public void putAllInvocations(List<? extends ComponentInvocation> invocations)

Specified by:

putAllInvocations in interface InvocationManager

registerComponentInvocationHandler

public void registerComponentInvocationHandler(ComponentInvocation.ComponentInvocationType type,
                                               RegisteredComponentInvocationHandler handler)

Specified by:

registerComponentInvocationHandler in interface InvocationManager

pushAppEnvironment

public void pushAppEnvironment(ApplicationEnvironment env)

Description copied from interface: InvocationManager

To be called by the infrastructure to indicate that some user code not associated with any Java EE specification may be called. In particular must be called by the Weld integration layer to indicate the application environment in which the portable extensions are running

The pushAppEnvironment and popAppEnvironment must be called in pairs and well-nested.

Specified by:

pushAppEnvironment in interface InvocationManager

Parameters:

env - may not be null. Information about the application environment

peekAppEnvironment

public ApplicationEnvironment peekAppEnvironment()

Description copied from interface: InvocationManager

Gets the current application environment on the current thread

Specified by:

peekAppEnvironment in interface InvocationManager

Returns:

The current ApplicationEnvironment, or null if there is none

popAppEnvironment

public void popAppEnvironment()

Description copied from interface: InvocationManager

To be called by the infrastructure to indicate that some user code not associated with any Java EE specification is finished being called. In particular must be called by the Weld integration layer to indicate the application environment in which the portable extensions are running

The pushAppEnvironment and popAppEnvironment must be called in pairs and well-nested.

Specified by:

popAppEnvironment in interface InvocationManager