org.apache.axis.providers.java.EJBProvider

All Implemented Interfaces:: Serializable, Handler

public class EJBProvider extends RPCProvider

A basic EJB Provider

Author:

Carl Woolf (cwoolf@macromedia.com), Tom Jordahl (tomj@macromedia.com), C?dric Chabanois (cchabanois@ifrance.com)

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type

Field

Description

protected static final Class[]

empty_class_array

protected static final Object[]

empty_object_array

protected static org.apache.commons.logging.Log

entLog

static final String

jndiContextClass

static final String

jndiPassword

static final String

jndiURL

static final String

jndiUsername

protected static org.apache.commons.logging.Log

log

static final String

OPTION_BEANNAME

static final String

OPTION_HOMEINTERFACENAME

static final String

OPTION_LOCALHOMEINTERFACENAME

static final String

OPTION_LOCALINTERFACENAME

static final String

OPTION_REMOTEINTERFACENAME

Fields inherited from class org.apache.axis.providers.java.JavaProvider
OPTION_ALLOWEDMETHODS, OPTION_CLASSNAME, OPTION_SCOPE

Fields inherited from class org.apache.axis.providers.BasicProvider
OPTION_EXTRACLASSES, OPTION_WSDL_INPUTSCHEMA, OPTION_WSDL_PORTTYPE, OPTION_WSDL_SERVICEELEMENT, OPTION_WSDL_SERVICEPORT, OPTION_WSDL_SOAPACTION_MODE, OPTION_WSDL_TARGETNAMESPACE

Fields inherited from class org.apache.axis.handlers.BasicHandler
makeLockable, name, options
Constructor Summary

Constructors

Constructor

Description

EJBProvider()
Method Summary

Modifier and Type

Method

Description

protected InitialContext

getCachedContext()

protected InitialContext

getContext(Properties properties)

protected Object

getEJBHome(InitialContext context, String beanJndiName)

protected Class

getServiceClass(String beanJndiName, SOAPService service, MessageContext msgContext)

Get the class description for the EJB Remote or Local Interface, which is what we are interested in exposing to the world (i.e.

protected String

getServiceClassNameOptionName()

Return the option in the configuration that contains the service class name.

protected String

getStrOption(String optionName, Handler service)

Get a String option by looking first in the service options, and then at the Handler's options.

protected Object

invokeMethod(MessageContext msgContext, Method method, Object obj, Object[] argValues)

Override the default implementation such that we can include special handling for ServerException.

protected Object

makeNewServiceObject(MessageContext msgContext, String clsName)

Return a object which implements the service.

Methods inherited from class org.apache.axis.providers.java.RPCProvider
checkMethodName, createResponseBody, getBody, getOperationDesc, processMessage

Methods inherited from class org.apache.axis.providers.java.JavaProvider
getServiceClassName, getServiceObject, initServiceDesc, invoke

Methods inherited from class org.apache.axis.providers.BasicProvider
addOperation, generateWSDL, getOperationName, getOperationNames, getOperationQNames

Methods inherited from class org.apache.axis.handlers.BasicHandler
canHandleBlock, cleanup, getDeploymentData, getName, getOption, getOptions, getUnderstoodHeaders, init, initHashtable, onFault, setName, setOption, setOptionDefault, setOptions, setOptionsLockable

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details
- log
  
  protected static org.apache.commons.logging.Log log
- entLog
  
  protected static org.apache.commons.logging.Log entLog
- OPTION_BEANNAME
  
  public static final String OPTION_BEANNAME
  See Also:
  
  Constant Field Values
- OPTION_HOMEINTERFACENAME
  
  public static final String OPTION_HOMEINTERFACENAME
  See Also:
  
  Constant Field Values
- OPTION_REMOTEINTERFACENAME
  
  public static final String OPTION_REMOTEINTERFACENAME
  See Also:
  
  Constant Field Values
- OPTION_LOCALHOMEINTERFACENAME
  
  public static final String OPTION_LOCALHOMEINTERFACENAME
  See Also:
  
  Constant Field Values
- OPTION_LOCALINTERFACENAME
  
  public static final String OPTION_LOCALINTERFACENAME
  See Also:
  
  Constant Field Values
- jndiContextClass
  
  public static final String jndiContextClass
  See Also:
  
  Constant Field Values
- jndiURL
  
  public static final String jndiURL
  See Also:
  
  Constant Field Values
- jndiUsername
  
  public static final String jndiUsername
  See Also:
  
  Constant Field Values
- jndiPassword
  
  public static final String jndiPassword
  See Also:
  
  Constant Field Values
- empty_class_array
  
  protected static final Class[] empty_class_array
- empty_object_array
  
  protected static final Object[] empty_object_array
Constructor Details
- EJBProvider
  
  public EJBProvider()
Method Details
- makeNewServiceObject
  
  protected Object makeNewServiceObject(MessageContext msgContext, String clsName) throws Exception
  
  Return a object which implements the service.
  
  Overrides:
  
  makeNewServiceObject in class JavaProvider
  
  Parameters:
  
  msgContext - the message context
  
  clsName - The JNDI name of the EJB home class
  
  Returns:
  
  an object that implements the service
  
  Throws:
  
  Exception
- getServiceClassNameOptionName
  
  protected String getServiceClassNameOptionName()
  
  Return the option in the configuration that contains the service class name. In the EJB case, it is the JNDI name of the bean.
  
  Overrides:
  
  getServiceClassNameOptionName in class JavaProvider
- getStrOption
  
  protected String getStrOption(String optionName, Handler service)
  
  Get a String option by looking first in the service options, and then at the Handler's options. This allows defaults to be specified at the provider level, and then overriden for particular services.
  
  Parameters:
  
  optionName - the option to retrieve
  
  Returns:
  
  String the value of the option or null if not found in either scope
- getServiceClass
  
  protected Class getServiceClass(String beanJndiName, SOAPService service, MessageContext msgContext) throws AxisFault
  
  Get the class description for the EJB Remote or Local Interface, which is what we are interested in exposing to the world (i.e. in WSDL).
  
  Overrides:
  
  getServiceClass in class JavaProvider
  
  Parameters:
  
  msgContext - the message context (can be null)
  
  beanJndiName - the JNDI name of the EJB
  
  Returns:
  
  the class info of the EJB remote or local interface
  
  Throws:
  
  AxisFault
- getCachedContext
  
  protected InitialContext getCachedContext() throws NamingException
  
  Throws:
  
  NamingException
- getContext
  
  protected InitialContext getContext(Properties properties) throws AxisFault, NamingException
  
  Throws:
  
  AxisFault
  
  NamingException
- getEJBHome
  
  protected Object getEJBHome(InitialContext context, String beanJndiName) throws AxisFault, NamingException
  
  Throws:
  
  AxisFault
  
  NamingException
- invokeMethod
  
  protected Object invokeMethod(MessageContext msgContext, Method method, Object obj, Object[] argValues) throws Exception
  
  Override the default implementation such that we can include special handling for ServerException.
  Converts ServerException exceptions to InvocationTargetException exceptions with the same cause. This allows the axis framework to create a SOAP fault.
  Overrides:
  
  invokeMethod in class RPCProvider
  
  Parameters:
  
  msgContext - MessageContext
  
  method - the target method.
  
  obj - the target object
  
  argValues - the method arguments
  
  Throws:
  
  Exception
  
  See Also:
  
  RPCProvider.invokeMethod(org.apache.axis.MessageContext, java.lang.reflect.Method, java.lang.Object, java.lang.Object[])

Class EJBProvider

Field Summary

Fields inherited from class org.apache.axis.providers.java.JavaProvider

Fields inherited from class org.apache.axis.providers.BasicProvider

Fields inherited from class org.apache.axis.handlers.BasicHandler

Constructor Summary

Method Summary

Methods inherited from class org.apache.axis.providers.java.RPCProvider

Methods inherited from class org.apache.axis.providers.java.JavaProvider

Methods inherited from class org.apache.axis.providers.BasicProvider

Methods inherited from class org.apache.axis.handlers.BasicHandler

Methods inherited from class java.lang.Object

Field Details

log

entLog

OPTION_BEANNAME

OPTION_HOMEINTERFACENAME

OPTION_REMOTEINTERFACENAME

OPTION_LOCALHOMEINTERFACENAME

OPTION_LOCALINTERFACENAME

jndiContextClass

jndiURL

jndiUsername

jndiPassword

empty_class_array

empty_object_array

Constructor Details

EJBProvider

Method Details

makeNewServiceObject

getServiceClassNameOptionName

getStrOption

getServiceClass

getCachedContext

getContext

getEJBHome

invokeMethod