Package 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	Description
InvocationManagerImpl()

Method Summary

Modifier and Type	Method	Description
List<ComponentInvocation>	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
void	popAppEnvironment()	To be called by the infrastructure to indicate that some user code not associated with any Jakarta EE specification is finished being called.
<T extends ComponentInvocation> void	postInvoke(T invocation)	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 invocation)	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 Jakarta EE specification may be called.
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 Details

InvocationManagerImpl

public InvocationManagerImpl()

Method Details

preInvoke

public <T extends ComponentInvocation> void preInvoke(T invocation)
                                               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:

invocation - the Invocation object

Throws:

InvocationException

postInvoke

public <T extends ComponentInvocation> void postInvoke(T invocation)
                                                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:

invocation - 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

getCurrentInvocation

public <T extends ComponentInvocation> T getCurrentInvocation()

return the Invocation object of the component being called

Specified by:

getCurrentInvocation in interface InvocationManager

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

Throws:

InvocationException

getAllInvocations

public List<ComponentInvocation> getAllInvocations()

Specified by:

getAllInvocations 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 Jakarta 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 Jakarta 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