Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

org.apache.axis
Class MessageContext  view MessageContext download MessageContext.java

java.lang.Object
  extended byorg.apache.axis.MessageContext
All Implemented Interfaces:
javax.xml.rpc.handler.MessageContext, javax.xml.rpc.handler.soap.SOAPMessageContext

public class MessageContext
extends java.lang.Object
implements javax.xml.rpc.handler.soap.SOAPMessageContext

A MessageContext is the Axis implementation of the javax SOAPMessageContext class, and is core to message processing in handlers and other parts of the system. This class also contains constants for accessing some well-known properties. Using a hierarchical namespace is strongly suggested in order to lower the chance for conflicts. (These constants should be viewed as an explicit list of well known and widely used context keys, there's nothing wrong with directly using the key strings. This is the reason for the hierarchical constant namespace. Actually I think we might just list the keys in the docs and provide no such constants since they create yet another namespace, but we'd have no compile-time checks then. Whaddya think? - todo by Jacek)


Field Summary
static java.lang.String ACCEPTMISSINGPARAMS
          A boolean param, to control whether we accept missing parameters as nulls or refuse to acknowledge them.
static java.lang.String ATTACHMENTS_DIR
          The directory where in coming attachments are created.
static java.lang.String AUTHUSER
          Place to store an AuthenticatedUser.
private  AxisEngine axisEngine
          The AxisEngine which this context is involved with.
private  org.apache.axis.utils.LockableHashtable bag
          Storage for an arbitrary bag of properties associated with this MessageContext.
static java.lang.String CALL
          If on the client - this is the Call object.
private  java.lang.ClassLoader classLoader
          The default ClassLoader that this service should use.
private  org.apache.axis.description.OperationDesc currentOperation
          Our current operation.
private  java.lang.String encodingStyle
           
static java.lang.String ENGINE_HANDLER
          Contains an instance of Handler, which is the ServiceContext and the entrypoint of this service.
private  boolean havePassedPivot
          Are we doing request stuff, or response stuff? True if processing response (I think).
private  boolean highFidelity
          An indication of whether we require "high fidelity" recording of deserialized messages for this interaction.
static java.lang.String HTTP_TRANSPORT_VERSION
          The value of the property is used by service WSDL generation (aka ?WSDL).
static java.lang.String IS_MSG
          Are we doing Msg vs RPC? - For Java Binding.
protected static org.apache.commons.logging.Log log
          The Log used for logging all messages.
private  boolean maintainSession
          Should we track session state, or not? default is not.
private  org.apache.axis.encoding.TypeMappingRegistry mappingRegistry
          Mappings of QNames to serializers/deserializers (and therfore to Java types).
private  java.lang.String password
           
static java.lang.String QUIT_REQUESTED
          Has a quit been requested? Hackish...
private  Message requestMessage
          The request message.
private  Message responseMessage
          The response message.
private  java.lang.String[] roles
          SOAP Actor roles.
private  org.apache.axis.schema.SchemaVersion schemaVersion
          Schema version information - defaults to 2001.
static java.lang.String SECURITY_PROVIDER
          The security provider.
private  org.apache.axis.handlers.soap.SOAPService serviceHandler
          ServiceHandler is the handler that is the "service".
private  org.apache.axis.session.Session session
          A Session associated with this request.
private  java.lang.String SOAPActionURI
           
private  org.apache.axis.soap.SOAPConstants soapConstants
          Our SOAP namespaces and such.
protected static java.lang.String systemTempDir
          Temporary directory to store attachments.
private  java.lang.String targetService
          That unique key/name that the next router/dispatch handler should use to determine what to do next.
private  int timeout
          Maximum amount of time to wait on a request, in milliseconds.
static java.lang.String TRANS_URL
          This String is the URL that the message came to.
private  java.lang.String transportName
          The name of the Transport which this message was received on (or is headed to, for the client).
private  java.lang.String username
           
private  boolean useSOAPAction
           
static java.lang.String WSDLGEN_INTFNAMESPACE
          The value of the property is used by service WSDL generation (aka ?WSDL) For the service's interface namespace if not set TRANS_URL property is used.
static java.lang.String WSDLGEN_SERV_LOC_URL
          The value of the property is used by service WSDL generation (aka ?WSDL).
 
Constructor Summary
MessageContext(AxisEngine engine)
          Create a message context.
 
Method Summary
 boolean containsProperty(java.lang.String name)
          Returns true if the MessageContext contains a property with the specified name.
 void dispose()
          if a message (or subclass) has any disposal needs, this method is where it goes.
protected  void finalize()
          during finalization, the dispose() method is called.
 java.util.Iterator getAllPropertyNames()
          Returns an Iterator view of the names of the properties in this MessageContext and any parents of the LockableHashtable
 AxisEngine getAxisEngine()
          Get the axis engine.
 java.lang.ClassLoader getClassLoader()
          Get the classloader, implicitly binding to the thread context classloader if an override has not been supplied.
static MessageContext getCurrentContext()
          Get the active message context.
 Message getCurrentMessage()
          Return the current (i.e.
 java.lang.String getEncodingStyle()
          Returns the encoding style as a URI that should be used for the SOAP message.
 boolean getMaintainSession()
          Discover if we are maintaining session state.
 javax.xml.soap.SOAPMessage getMessage()
          Gets the SOAPMessage from this message context.
 org.apache.axis.description.OperationDesc getOperation()
          The current operation.
 org.apache.axis.description.OperationDesc getOperationByQName(javax.xml.namespace.QName qname)
          get the first possible operation that could match a body containing an element of the given QName.
 org.apache.axis.constants.Style getOperationStyle()
          Get the operation style.
 org.apache.axis.constants.Use getOperationUse()
          Get the operation use.
 java.lang.String getPassword()
          Get the password.
 boolean getPastPivot()
          Determine when we've passed the pivot.
 org.apache.axis.description.OperationDesc[] getPossibleOperationsByQName(javax.xml.namespace.QName qname)
          Returns a list of operation descriptors that could may possibly match a body containing an element of the given QName.
 java.lang.Object getProperty(java.lang.String name)
          Returns the value associated with the named property - or null if not defined/set.
 java.util.Iterator getPropertyNames()
          Returns an Iterator view of the names of the properties in this MessageContext.
 Message getRequestMessage()
          Get the request message.
 Message getResponseMessage()
          Get the response message.
 java.lang.String[] getRoles()
          Gets the SOAP actor roles associated with an execution of the HandlerChain and its contained Handler instances.
 org.apache.axis.schema.SchemaVersion getSchemaVersion()
          Get the XML schema version information.
 org.apache.axis.handlers.soap.SOAPService getService()
          Get the SOAPService used to handle services in this context.
 org.apache.axis.session.Session getSession()
          Get the current session.
 java.lang.String getSOAPActionURI()
          Get the soapAction URI.
 org.apache.axis.soap.SOAPConstants getSOAPConstants()
          Get the SOAPConstants used by this message context.
 java.lang.String getStrProp(java.lang.String propName)
          Get a String property by name.
 java.lang.String getTargetService()
          Get the name of the targed service for this message.
 int getTimeout()
          Get timeout from our MessageContext.
 java.lang.String getTransportName()
          The name of the transport for this context.
 org.apache.axis.encoding.TypeMapping getTypeMapping()
          Return the type mapping currently in scope for our encoding style.
 org.apache.axis.encoding.TypeMappingRegistry getTypeMappingRegistry()
          Get the currently in-scope type mapping registry.
 java.lang.String getUsername()
          Get the user name.
 boolean isClient()
          Let us know whether this is the client or the server.
 boolean isEncoded()
          Indicates if the opration is encoded.
 boolean isHighFidelity()
          Read the high fidelity property.
 boolean isPropertyTrue(java.lang.String propName)
          Tests to see if the named property is set in the 'bag', returning false if it is not present at all.
 boolean isPropertyTrue(java.lang.String propName, boolean defaultVal)
          Test if a property is set to something we consider to be true in the 'bag'.
 void removeProperty(java.lang.String propName)
           
 void reset()
          Return this context to a clean state.
 void setClassLoader(java.lang.ClassLoader cl)
          Set a new classloader.
 void setCurrentMessage(Message curMsg)
          Set the current message.
 void setEncodingStyle(java.lang.String namespaceURI)
          Sets the encoding style to the URI passed in.
 void setHighFidelity(boolean highFidelity)
          Set the high fidelity propert.
 void setMaintainSession(boolean yesno)
          Set whether we are maintaining session state.
 void setMessage(javax.xml.soap.SOAPMessage message)
          Sets the SOAPMessage for this message context.
 void setOperation(org.apache.axis.description.OperationDesc operation)
          Set the current operation.
 void setPassword(java.lang.String password)
          Set the password.
 void setPastPivot(boolean pastPivot)
          Indicate when we've passed the pivot.
 void setProperty(java.lang.String name, java.lang.Object value)
          Allows you to set a named property to the passed in value.
 void setPropertyParent(java.util.Hashtable parent)
          Set the Hashtable that contains the default values for our properties.
 void setRequestMessage(Message reqMsg)
          Set the request message, and make sure that message is associated with this MessageContext.
 void setResponseMessage(Message respMsg)
          Set the response message, and make sure that message is associated with this MessageContext.
 void setRoles(java.lang.String[] roles)
          Set the SOAP actor roles associated with an executioni of CodeHandlerChain and its contained Handler instances.
 void setSchemaVersion(org.apache.axis.schema.SchemaVersion schemaVersion)
          Set the XML schema version this message context will use.
 void setService(org.apache.axis.handlers.soap.SOAPService sh)
          Set the SOAPService used to handle services in this context.
 void setSession(org.apache.axis.session.Session session)
          Set the current session.
 void setSOAPActionURI(java.lang.String SOAPActionURI)
          Set the soapAction URI.
 void setSOAPConstants(org.apache.axis.soap.SOAPConstants soapConstants)
          Set the SOAPConstants used by this message context.
 void setTargetService(java.lang.String tServ)
          Set the target service for this message.
 void setTimeout(int value)
          Set timeout in our MessageContext.
 void setTransportName(java.lang.String transportName)
          Set the transport name for this context.
 void setTypeMappingRegistry(org.apache.axis.encoding.TypeMappingRegistry reg)
          Replace the engine's type mapping registry with a local one.
 void setUsername(java.lang.String username)
          Set the username.
 void setUseSOAPAction(boolean useSOAPAction)
          Enable or dissable the use of soap action information.
 boolean useSOAPAction()
          Indicates wether the soap action URI is being used or not.
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

log

protected static org.apache.commons.logging.Log log
The Log used for logging all messages.


requestMessage

private Message requestMessage
The request message. If we're on the client, this is the outgoing message heading to the server. If we're on the server, this is the incoming message we've received from the client.


responseMessage

private Message responseMessage
The response message. If we're on the server, this is the outgoing message heading back to the client. If we're on the client, this is the incoming message we've received from the server.


targetService

private java.lang.String targetService
That unique key/name that the next router/dispatch handler should use to determine what to do next.


transportName

private java.lang.String transportName
The name of the Transport which this message was received on (or is headed to, for the client).


classLoader

private java.lang.ClassLoader classLoader
The default ClassLoader that this service should use.


axisEngine

private AxisEngine axisEngine
The AxisEngine which this context is involved with.


session

private org.apache.axis.session.Session session
A Session associated with this request.


maintainSession

private boolean maintainSession
Should we track session state, or not? default is not. Could potentially refactor this so that maintainSession iff session != null...


havePassedPivot

private boolean havePassedPivot
Are we doing request stuff, or response stuff? True if processing response (I think).


timeout

private int timeout
Maximum amount of time to wait on a request, in milliseconds.


highFidelity

private boolean highFidelity
An indication of whether we require "high fidelity" recording of deserialized messages for this interaction. Defaults to true for now, and can be set to false, usually at service-dispatch time.


bag

private org.apache.axis.utils.LockableHashtable bag
Storage for an arbitrary bag of properties associated with this MessageContext.


username

private java.lang.String username

password

private java.lang.String password

encodingStyle

private java.lang.String encodingStyle

useSOAPAction

private boolean useSOAPAction

SOAPActionURI

private java.lang.String SOAPActionURI

roles

private java.lang.String[] roles
SOAP Actor roles.


soapConstants

private org.apache.axis.soap.SOAPConstants soapConstants
Our SOAP namespaces and such.


schemaVersion

private org.apache.axis.schema.SchemaVersion schemaVersion
Schema version information - defaults to 2001.


currentOperation

private org.apache.axis.description.OperationDesc currentOperation
Our current operation.


systemTempDir

protected static java.lang.String systemTempDir
Temporary directory to store attachments.


mappingRegistry

private org.apache.axis.encoding.TypeMappingRegistry mappingRegistry
Mappings of QNames to serializers/deserializers (and therfore to Java types).


serviceHandler

private org.apache.axis.handlers.soap.SOAPService serviceHandler
ServiceHandler is the handler that is the "service". This handler can (and probably will actually be a chain that contains the service specific request/response/pivot point handlers


ENGINE_HANDLER

public static final java.lang.String ENGINE_HANDLER
Contains an instance of Handler, which is the ServiceContext and the entrypoint of this service. (if it has been so configured - will our deployment tool do this by default? - todo by Jacek)

See Also:
Constant Field Values

TRANS_URL

public static final java.lang.String TRANS_URL
This String is the URL that the message came to.

See Also:
Constant Field Values

QUIT_REQUESTED

public static final java.lang.String QUIT_REQUESTED
Has a quit been requested? Hackish... but useful... -- RobJ

See Also:
Constant Field Values

AUTHUSER

public static final java.lang.String AUTHUSER
Place to store an AuthenticatedUser.

See Also:
Constant Field Values

CALL

public static final java.lang.String CALL
If on the client - this is the Call object.

See Also:
Constant Field Values

IS_MSG

public static final java.lang.String IS_MSG
Are we doing Msg vs RPC? - For Java Binding.

See Also:
Constant Field Values

ATTACHMENTS_DIR

public static final java.lang.String ATTACHMENTS_DIR
The directory where in coming attachments are created.

See Also:
Constant Field Values

ACCEPTMISSINGPARAMS

public static final java.lang.String ACCEPTMISSINGPARAMS
A boolean param, to control whether we accept missing parameters as nulls or refuse to acknowledge them.

See Also:
Constant Field Values

WSDLGEN_INTFNAMESPACE

public static final java.lang.String WSDLGEN_INTFNAMESPACE
The value of the property is used by service WSDL generation (aka ?WSDL) For the service's interface namespace if not set TRANS_URL property is used.

See Also:
Constant Field Values

WSDLGEN_SERV_LOC_URL

public static final java.lang.String WSDLGEN_SERV_LOC_URL
The value of the property is used by service WSDL generation (aka ?WSDL). For the service's location if not set TRANS_URL property is used. (helps provide support through proxies.

See Also:
Constant Field Values

HTTP_TRANSPORT_VERSION

public static final java.lang.String HTTP_TRANSPORT_VERSION
The value of the property is used by service WSDL generation (aka ?WSDL). Set this property to request a certain level of HTTP. The values MUST use org.apache.axis.transport.http.HTTPConstants.HEADER_PROTOCOL_10 for HTTP 1.0 The values MUST use org.apache.axis.transport.http.HTTPConstants.HEADER_PROTOCOL_11 for HTTP 1.1

See Also:
Constant Field Values

SECURITY_PROVIDER

public static final java.lang.String SECURITY_PROVIDER
The security provider.

See Also:
Constant Field Values
Constructor Detail

MessageContext

public MessageContext(AxisEngine engine)
Create a message context.

Method Detail

getOperation

public org.apache.axis.description.OperationDesc getOperation()
The current operation.


setOperation

public void setOperation(org.apache.axis.description.OperationDesc operation)
Set the current operation.


getPossibleOperationsByQName

public org.apache.axis.description.OperationDesc[] getPossibleOperationsByQName(javax.xml.namespace.QName qname)
                                                                         throws AxisFault
Returns a list of operation descriptors that could may possibly match a body containing an element of the given QName. For non-DOCUMENT, the list of operation descriptors that match the name is returned. For DOCUMENT, all the operations that have qname as a parameter are returned


getOperationByQName

public org.apache.axis.description.OperationDesc getOperationByQName(javax.xml.namespace.QName qname)
                                                              throws AxisFault
get the first possible operation that could match a body containing an element of the given QName. Sets the currentOperation field in the process; if that field is already set then its value is returned instead


getCurrentContext

public static MessageContext getCurrentContext()
Get the active message context.


finalize

protected void finalize()
during finalization, the dispose() method is called.


setTypeMappingRegistry

public void setTypeMappingRegistry(org.apache.axis.encoding.TypeMappingRegistry reg)
Replace the engine's type mapping registry with a local one. This will have no effect on any type mappings obtained before this call.


getTypeMappingRegistry

public org.apache.axis.encoding.TypeMappingRegistry getTypeMappingRegistry()
Get the currently in-scope type mapping registry. By default, will return a reference to the AxisEngine's TMR until someone sets our local one (usually as a result of setting the serviceHandler).


getTypeMapping

public org.apache.axis.encoding.TypeMapping getTypeMapping()
Return the type mapping currently in scope for our encoding style.


getTransportName

public java.lang.String getTransportName()
The name of the transport for this context.


setTransportName

public void setTransportName(java.lang.String transportName)
Set the transport name for this context.


getSOAPConstants

public org.apache.axis.soap.SOAPConstants getSOAPConstants()
Get the SOAPConstants used by this message context.


setSOAPConstants

public void setSOAPConstants(org.apache.axis.soap.SOAPConstants soapConstants)
Set the SOAPConstants used by this message context. This may also affect the encoding style.


getSchemaVersion

public org.apache.axis.schema.SchemaVersion getSchemaVersion()
Get the XML schema version information.


setSchemaVersion

public void setSchemaVersion(org.apache.axis.schema.SchemaVersion schemaVersion)
Set the XML schema version this message context will use.


getSession

public org.apache.axis.session.Session getSession()
Get the current session.


setSession

public void setSession(org.apache.axis.session.Session session)
Set the current session.


isEncoded

public boolean isEncoded()
Indicates if the opration is encoded.


setMaintainSession

public void setMaintainSession(boolean yesno)
Set whether we are maintaining session state.


getMaintainSession

public boolean getMaintainSession()
Discover if we are maintaining session state.


getRequestMessage

public Message getRequestMessage()
Get the request message.


setRequestMessage

public void setRequestMessage(Message reqMsg)
Set the request message, and make sure that message is associated with this MessageContext.


getResponseMessage

public Message getResponseMessage()
Get the response message.


setResponseMessage

public void setResponseMessage(Message respMsg)
Set the response message, and make sure that message is associated with this MessageContext.


getCurrentMessage

public Message getCurrentMessage()
Return the current (i.e. request before the pivot, response after) message.


getMessage

public javax.xml.soap.SOAPMessage getMessage()
Gets the SOAPMessage from this message context.

Specified by:
getMessage in interface javax.xml.rpc.handler.soap.SOAPMessageContext

setCurrentMessage

public void setCurrentMessage(Message curMsg)
Set the current message. This will set the request before the pivot, and the response afterwards, as guaged by the passedPivod property.


setMessage

public void setMessage(javax.xml.soap.SOAPMessage message)
Sets the SOAPMessage for this message context. This is equivalent to casting message to Message and then passing it on to setCurrentMessage().

Specified by:
setMessage in interface javax.xml.rpc.handler.soap.SOAPMessageContext

getPastPivot

public boolean getPastPivot()
Determine when we've passed the pivot.


setPastPivot

public void setPastPivot(boolean pastPivot)
Indicate when we've passed the pivot.


setTimeout

public void setTimeout(int value)
Set timeout in our MessageContext.


getTimeout

public int getTimeout()
Get timeout from our MessageContext.


getClassLoader

public java.lang.ClassLoader getClassLoader()
Get the classloader, implicitly binding to the thread context classloader if an override has not been supplied.


setClassLoader

public void setClassLoader(java.lang.ClassLoader cl)
Set a new classloader. Setting to null will result in getClassLoader() binding back to the thread context class loader.


getTargetService

public java.lang.String getTargetService()
Get the name of the targed service for this message.


getAxisEngine

public AxisEngine getAxisEngine()
Get the axis engine. This will be null if the message was created outside an engine


setTargetService

public void setTargetService(java.lang.String tServ)
                      throws AxisFault
Set the target service for this message.

This looks up the named service in the registry, and has the side effect of setting our TypeMappingRegistry to the service's.


getService

public org.apache.axis.handlers.soap.SOAPService getService()
Get the SOAPService used to handle services in this context.


setService

public void setService(org.apache.axis.handlers.soap.SOAPService sh)
                throws AxisFault
Set the SOAPService used to handle services in this context. This method configures a wide range of MessageContext properties to suit the handler.


isClient

public boolean isClient()
Let us know whether this is the client or the server.


getStrProp

public java.lang.String getStrProp(java.lang.String propName)
Get a String property by name.


isPropertyTrue

public boolean isPropertyTrue(java.lang.String propName)
Tests to see if the named property is set in the 'bag', returning false if it is not present at all. This is equivalent to isPropertyTrue(propName, false).


isPropertyTrue

public boolean isPropertyTrue(java.lang.String propName,
                              boolean defaultVal)
Test if a property is set to something we consider to be true in the 'bag'.
  • If not there then defaultVal is returned.
  • If there, then...
    • if its a Boolean, we'll return booleanValue()
    • if its an Integer, we'll return false if its 0 else true
    • if its a String we'll return false if its "false"" or "0" else true
    • All other types return true


setProperty

public void setProperty(java.lang.String name,
                        java.lang.Object value)
Allows you to set a named property to the passed in value. There are a few known properties (like username, password, etc) that are variables in Call. The rest of the properties are stored in a Hashtable. These common properties should be accessed via the accessors for speed/type safety, but they may still be obtained via this method. It's up to one of the Handlers (or the Axis engine itself) to go looking for one of them.

Specified by:
setProperty in interface javax.xml.rpc.handler.MessageContext

containsProperty

public boolean containsProperty(java.lang.String name)
Returns true if the MessageContext contains a property with the specified name.

Specified by:
containsProperty in interface javax.xml.rpc.handler.MessageContext

getPropertyNames

public java.util.Iterator getPropertyNames()
Returns an Iterator view of the names of the properties in this MessageContext.

Specified by:
getPropertyNames in interface javax.xml.rpc.handler.MessageContext

getAllPropertyNames

public java.util.Iterator getAllPropertyNames()
Returns an Iterator view of the names of the properties in this MessageContext and any parents of the LockableHashtable


getProperty

public java.lang.Object getProperty(java.lang.String name)
Returns the value associated with the named property - or null if not defined/set.

Specified by:
getProperty in interface javax.xml.rpc.handler.MessageContext

setPropertyParent

public void setPropertyParent(java.util.Hashtable parent)
Set the Hashtable that contains the default values for our properties.


setUsername

public void setUsername(java.lang.String username)
Set the username.


getUsername

public java.lang.String getUsername()
Get the user name.


setPassword

public void setPassword(java.lang.String password)
Set the password.


getPassword

public java.lang.String getPassword()
Get the password.


getOperationStyle

public org.apache.axis.constants.Style getOperationStyle()
Get the operation style. This is either the style of the current operation or if that is not set, the style of the service handler, or if that is not set, Style.RPC.


getOperationUse

public org.apache.axis.constants.Use getOperationUse()
Get the operation use.


setUseSOAPAction

public void setUseSOAPAction(boolean useSOAPAction)
Enable or dissable the use of soap action information. When enabled, the message context will attempt to use the soap action URI information during binding of soap messages to service methods. When dissabled, it will make no such attempt.


useSOAPAction

public boolean useSOAPAction()
Indicates wether the soap action URI is being used or not.


setSOAPActionURI

public void setSOAPActionURI(java.lang.String SOAPActionURI)
                      throws java.lang.IllegalArgumentException
Set the soapAction URI.


getSOAPActionURI

public java.lang.String getSOAPActionURI()
Get the soapAction URI.


setEncodingStyle

public void setEncodingStyle(java.lang.String namespaceURI)
Sets the encoding style to the URI passed in.


getEncodingStyle

public java.lang.String getEncodingStyle()
Returns the encoding style as a URI that should be used for the SOAP message.


removeProperty

public void removeProperty(java.lang.String propName)
Specified by:
removeProperty in interface javax.xml.rpc.handler.MessageContext

reset

public void reset()
Return this context to a clean state.


isHighFidelity

public boolean isHighFidelity()
Read the high fidelity property.

Some behavior may be apropreate for high fidelity contexts that is not relevant for low fidelity ones or vica-versa.


setHighFidelity

public void setHighFidelity(boolean highFidelity)
Set the high fidelity propert.

Users of the context may be changing what they do based upon this flag.


getRoles

public java.lang.String[] getRoles()
Gets the SOAP actor roles associated with an execution of the HandlerChain and its contained Handler instances.

Not (yet) implemented method in the SOAPMessageContext interface.

Note: SOAP actor roles apply to the SOAP node and are managed using HandlerChain.setRoles() and HandlerChain.getRoles(). Handler instances in the HandlerChain use this information about the SOAP actor roles to process the SOAP header blocks. Note that the SOAP actor roles are invariant during the processing of SOAP message through the HandlerChain.

Specified by:
getRoles in interface javax.xml.rpc.handler.soap.SOAPMessageContext

setRoles

public void setRoles(java.lang.String[] roles)
Set the SOAP actor roles associated with an executioni of CodeHandlerChain and its contained Handler instances.


dispose

public void dispose()
if a message (or subclass) has any disposal needs, this method is where it goes. Subclasses *must* call super.dispose(), and be prepared to be called from the finalizer as well as earlier