org.apache.axis.providers.java

Class JavaProvider

java.lang.Object

org.apache.axis.handlers.BasicHandler

org.apache.axis.providers.BasicProvider

org.apache.axis.providers.java.JavaProvider

All Implemented Interfaces:

java.io.Serializable, Handler

Direct Known Subclasses:

MsgProvider, RPCProvider

public abstract class JavaProvider
extends BasicProvider

Base class for Java dispatching. Fetches various fields out of envelope, looks up service object (possibly using session state), and delegates envelope body processing to subclass via abstract processMessage method.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static Log	entLog
protected static Log	log
static java.lang.String	OPTION_ALLOWEDMETHODS
static java.lang.String	OPTION_CLASSNAME
static java.lang.String	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 and Description
JavaProvider()

Method Summary

Modifier and Type	Method and Description
protected java.lang.Class	getServiceClass(java.lang.String clsName, SOAPService service, MessageContext msgContext) Returns the Class info about the service class.
protected java.lang.String	getServiceClassName(Handler service) Return the class name of the service
protected java.lang.String	getServiceClassNameOptionName() Return the option in the configuration that contains the service class name
java.lang.Object	getServiceObject(MessageContext msgContext, Handler service, java.lang.String clsName, IntHolder scopeHolder) Get the service object whose method actually provides the service.
void	initServiceDesc(SOAPService service, MessageContext msgContext) Fill in a service description with the correct impl class and typemapping set.
void	invoke(MessageContext msgContext) Invoke the message by obtaining various common fields, looking up the service object (via getServiceObject), and actually processing the message (via processMessage).
protected java.lang.Object	makeNewServiceObject(MessageContext msgContext, java.lang.String clsName) Default java service object comes from simply instantiating the class wrapped in jc
abstract void	processMessage(MessageContext msgContext, SOAPEnvelope reqEnv, SOAPEnvelope resEnv, java.lang.Object obj) Process the current message.

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 Detail

log

protected static Log log

entLog

protected static Log entLog

OPTION_CLASSNAME

public static final java.lang.String OPTION_CLASSNAME

See Also:

Constant Field Values

OPTION_ALLOWEDMETHODS

public static final java.lang.String OPTION_ALLOWEDMETHODS

See Also:

Constant Field Values

OPTION_SCOPE

public static final java.lang.String OPTION_SCOPE

See Also:

Constant Field Values

Constructor Detail

JavaProvider

public JavaProvider()

Method Detail

getServiceObject

public java.lang.Object getServiceObject(MessageContext msgContext,
                                         Handler service,
                                         java.lang.String clsName,
                                         IntHolder scopeHolder)
                                  throws java.lang.Exception

Get the service object whose method actually provides the service. May look up in session table.

Throws:

java.lang.Exception

processMessage

public abstract void processMessage(MessageContext msgContext,
                                    SOAPEnvelope reqEnv,
                                    SOAPEnvelope resEnv,
                                    java.lang.Object obj)
                             throws java.lang.Exception

Process the current message. Side-effect resEnv to create return value.

Parameters:

msgContext - self-explanatory

reqEnv - the request envelope

resEnv - the response envelope

obj - the service object itself

Throws:

java.lang.Exception

invoke

public void invoke(MessageContext msgContext)
            throws AxisFault

Invoke the message by obtaining various common fields, looking up the service object (via getServiceObject), and actually processing the message (via processMessage).

Parameters:

msgContext - the MessageContext to process with this Handler.

Throws:

AxisFault - if the handler encounters an error

makeNewServiceObject

protected java.lang.Object makeNewServiceObject(MessageContext msgContext,
                                                java.lang.String clsName)
                                         throws java.lang.Exception

Default java service object comes from simply instantiating the class wrapped in jc

Throws:

java.lang.Exception

getServiceClassName

protected java.lang.String getServiceClassName(Handler service)

Return the class name of the service

getServiceClassNameOptionName

protected java.lang.String getServiceClassNameOptionName()

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

getServiceClass

protected java.lang.Class getServiceClass(java.lang.String clsName,
                                          SOAPService service,
                                          MessageContext msgContext)
                                   throws AxisFault

Returns the Class info about the service class.

Throws:

AxisFault

initServiceDesc

public void initServiceDesc(SOAPService service,
                            MessageContext msgContext)
                     throws AxisFault

Fill in a service description with the correct impl class and typemapping set. This uses methods that can be overridden by other providers (like the EJBProvider) to get the class from the right place.

Specified by:

initServiceDesc in class BasicProvider

Throws:

AxisFault