org.glassfish.ejb.api

Interface EJBInvocation

All Known Implementing Classes:

EjbInvocation

public interface EJBInvocation

This interface provides access to the exported portions of the ejb invocation object.

Author:

Kenneth Saks

Method Summary

Modifier and Type	Method and Description
boolean	authorizeWebService(Method method) Use the underlying container to authorize this invocation
javax.ejb.EJBContext	getEJBContext()
Object	getJaccEjb() Used by JACC implementation to get an enterprise bean instance for the EnterpriseBean policy handler.
Object	getMessage() This is for EJB JAXWS only.
Method	getMethod()
Object[]	getMethodParams()
Method	getWebServiceMethod()
Object	getWebServiceTie()
boolean	isAWebService()
boolean	isCallerInRole(String role)
<T> void	setMessage(T message) This is for EJB JAXWS only.
void	setMessageContext(javax.xml.rpc.handler.MessageContext context) Used for setting JAX-RPC message context.
void	setWebServiceContext(Object webServiceContext)
void	setWebServiceMethod(Method method)
void	setWebServiceTie(Object tie) Used by JAX-RPC pre/postHandler classes

Method Detail

getEJBContext

javax.ejb.EJBContext getEJBContext()

Returns:

runtime EJBContext of this invocation

getMessage

Object getMessage()

This is for EJB JAXWS only.

Returns:

the JAXWS message

setMessage

<T> void setMessage(T message)

This is for EJB JAXWS only.

Parameters:

message - an unconsumed message

isAWebService

boolean isAWebService()

Returns:

true if it is a webservice invocation

getMethod

Method getMethod()

Returns:

the Java Method object for this Invocation

getMethodParams

Object[] getMethodParams()

Returns:

the Method parameters for this Invocation

getJaccEjb

Object getJaccEjb()

Used by JACC implementation to get an enterprise bean instance for the EnterpriseBean policy handler. The jacc implementation should use this method rather than directly accessing the ejb field.

Returns:

EnterpriseBean instance or null if not applicable for this invocation.

authorizeWebService

boolean authorizeWebService(Method method)
                     throws Exception

Use the underlying container to authorize this invocation

Parameters:

method - method to be invoked

Returns:

true if the invocation was authorized by the underlying container

Throws:

Exception

isCallerInRole

boolean isCallerInRole(String role)

Returns:

true if the SecurityManager reports that the caller is in role

setWebServiceTie

void setWebServiceTie(Object tie)

Used by JAX-RPC pre/postHandler classes

Parameters:

tie - an instance of com.sun.xml.rpc.spi.runtime.Tie

setMessageContext

void setMessageContext(javax.xml.rpc.handler.MessageContext context)

Used for setting JAX-RPC message context.

getWebServiceTie

Object getWebServiceTie()

Returns:

instance of com.sun.xml.rpc.spi.runtime.Tie

setWebServiceMethod

void setWebServiceMethod(Method method)

Parameters:

method - - web service endpoint method

getWebServiceMethod

Method getWebServiceMethod()

Returns:

web service endpoint Method

setWebServiceContext

void setWebServiceContext(Object webServiceContext)

Parameters:

webServiceContext - JAX-WS web service context used for the invocation