RPCProvider (JAXRPC API) - JBoss 4.0.1 sp1 jaxrpc API Documentation 英文版文档

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.apache.axis.providers.java
Class RPCProvider

java.lang.Object
  org.apache.axis.handlers.BasicHandler
      org.apache.axis.providers.BasicProvider
          org.apache.axis.providers.java.JavaProvider
              org.apache.axis.providers.java.RPCProvider

All Implemented Interfaces:: Handler, Serializable

Direct Known Subclasses:: EJBProvider

public class RPCProvider
extends JavaProvider

Implement message processing by walking over RPCElements of the envelope body, invoking the appropriate methods on the service object.

Author:: Doug Davis (dug@us.ibm.com)
See Also:: Serialized Form

Field Summary

static String RPC_INVOCATION
          The key for the invocation object in the MessageContext

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

OPTION_ALLOWEDMETHODS, OPTION_CLASSNAME, OPTION_CLASSPATH, OPTION_IS_STATIC, OPTION_SCOPE, OPTION_WSDL_INPUTSCHEMA, OPTION_WSDL_PORTTYPE, OPTION_WSDL_SERVICEELEMENT, OPTION_WSDL_SERVICEPORT, OPTION_WSDL_TARGETNAMESPACE

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

makeLockable, name, options

Constructor Summary

RPCProvider()


Method Summary

protected void checkMethodName(MessageContext msgContext, String allowedMethods, String methodName)
          Throw an AxisFault if the requested method is not allowed.

RPCInvocation createRPCInvocation(MessageContext msgContext, SOAPEnvelopeAxisImpl reqEnv, SOAPEnvelopeAxisImpl resEnv, Object obj)


protected Object invokeMethod(MessageContext msgContext, Method method, Object obj, Object[] argValues)
          This method encapsulates the method invocation.

protected Object invokeTarget(RPCInvocation invocation)
          Unwraps the invocation and calls invokeMethod

void processMessage(MessageContext msgContext, SOAPEnvelopeAxisImpl reqEnv, SOAPEnvelopeAxisImpl resEnv, Object obj)
          Process the current message.

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

generateWSDL, getServiceClass, getServiceClassName, getServiceClassNameOptionName, getServiceObject, initServiceDesc, invoke, makeNewServiceObject, processException

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

addOperation, 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

RPC_INVOCATION

public static final String RPC_INVOCATION

The key for the invocation object in the MessageContext

See Also:: Constant Field Values

Constructor Detail

RPCProvider

public RPCProvider()

Method Detail

processMessage

public void processMessage(MessageContext msgContext,
                           SOAPEnvelopeAxisImpl reqEnv,
                           SOAPEnvelopeAxisImpl resEnv,
                           Object obj)
                    throws Exception

Process the current message. Result in resEnv.

Specified by:: processMessage in class JavaProvider

Parameters:: msgContext - self-explanatory; reqEnv - the request envelope; resEnv - the response envelope; obj - the service object itself
Throws:: Exception

createRPCInvocation

public RPCInvocation createRPCInvocation(MessageContext msgContext,
                                         SOAPEnvelopeAxisImpl reqEnv,
                                         SOAPEnvelopeAxisImpl resEnv,
                                         Object obj)

invokeTarget

protected Object invokeTarget(RPCInvocation invocation)
                       throws Exception

Unwraps the invocation and calls invokeMethod

Parameters:: invocation - The invocation
Returns:: Return value from invokeMethod
Throws:: Exception - Any client Exception

invokeMethod

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

This method encapsulates the method invocation.

Parameters:: msgContext - MessageContext; method - the target method.; obj - the target object; argValues - the method arguments
Throws:: Exception

checkMethodName

protected void checkMethodName(MessageContext msgContext,
                               String allowedMethods,
                               String methodName)
                        throws Exception

Throw an AxisFault if the requested method is not allowed.

Parameters:: msgContext - MessageContext; allowedMethods - list of allowed methods; methodName - name of target method
Throws:: Exception