oracle.soap.server
Class RequestContext

java.lang.Object
  |
  +--oracle.soap.server.RequestContext

public class RequestContext
extends java.lang.Object

RequestContext defines all of the context for a SOAP request, including information that is passed to the provider and information that the provider must set before returning. Note that the provider is given the request Envelope and is therefore responsible to unmarshall the request parameters. Similarly, the provider is required to marshall the response, although the response envelope must also be set by the provider, as it may be needed by a pluggable handler.

The following information is provided by the SOAP engine to the Provider, meaning that the provider can utilize this information in Provider.invoke:

The following information must be given by the Provider to the SOAP engine:


Constructor Summary
RequestContext()
           
 
Method Summary
 java.lang.String getMethodName()
          Get the method name for this SOAP request.
 java.lang.String getRequestEncodingStyle()
          Get the encoding style that was used on the request.
 Envelope getRequestEnvelope()
          Get the envelope that represents the actual SOAP request.
 java.io.ByteArrayOutputStream getResponseBytes()
          Get the response stream for this SOAP request.
 Envelope getResponseEnvelope()
          Get the envelope that represents the SOAP response.
 SOAPMappingRegistry getResponseMap()
          Get the mapping registry that must be used to serialize the SOAP response.
 ServiceDeploymentDescriptor getServiceDeploymentDescriptor()
          Get the service deployment descriptor for the requested service.
 java.lang.String getServiceId()
          Get the service id (URI) for this SOAP request.
 UserContext getUserContext()
          Get the user context for this SOAP request.
 void setMethodName(java.lang.String methodName)
          Set the method name for this SOAP request.
 void setRequestEncodingStyle(java.lang.String requestEncodingStyle)
          Set the encoding style that was used on the request.
 void setRequestEnvelope(Envelope envelope)
          Set the envelope that represents the actual SOAP request.
 void setResponseBytes(java.io.ByteArrayOutputStream bytes)
          Set the response stream for this SOAP request.
 void setResponseEnvelope(Envelope envelope)
          Set the envelope that represents the SOAP response.
 void setResponseMap(SOAPMappingRegistry smr)
          Set the mapping registry that must be used to serialize the SOAP response envelope.
 void setServiceDeploymentDescriptor(ServiceDeploymentDescriptor serviceDeploymentDescriptor)
          Set the service deployment descriptor for the requested service.
 void setServiceId(java.lang.String serviceId)
          Set the service id (URI) for this SOAP request.
 void setUserContext(UserContext userContext)
          Set the user context for this SOAP request.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

RequestContext

public RequestContext()
Method Detail

setRequestEnvelope

public void setRequestEnvelope(Envelope envelope)
Set the envelope that represents the actual SOAP request.
Parameters:
envelope - The SOAP envelope.

getRequestEnvelope

public Envelope getRequestEnvelope()
Get the envelope that represents the actual SOAP request.
Returns:
The SOAP envelope.

setResponseEnvelope

public void setResponseEnvelope(Envelope envelope)
Set the envelope that represents the SOAP response.
Parameters:
envelope - The SOAP response envelope.

getResponseEnvelope

public Envelope getResponseEnvelope()
Get the envelope that represents the SOAP response.
Returns:
The SOAP response envelope.

setResponseMap

public void setResponseMap(SOAPMappingRegistry smr)
Set the mapping registry that must be used to serialize the SOAP response envelope.
Parameters:
smr - The mapping registry for the SOAP response envelope.

getResponseMap

public SOAPMappingRegistry getResponseMap()
Get the mapping registry that must be used to serialize the SOAP response.
Returns:
The mapping registry for the SOAP response envelope.

setResponseBytes

public void setResponseBytes(java.io.ByteArrayOutputStream bytes)
Set the response stream for this SOAP request.
Parameters:
bytes - The ByteArrayOutputStream that contains the response.

getResponseBytes

public java.io.ByteArrayOutputStream getResponseBytes()
Get the response stream for this SOAP request.
Returns:
The ByteArrayOutputStream that contains the response.

setRequestEncodingStyle

public void setRequestEncodingStyle(java.lang.String requestEncodingStyle)
Set the encoding style that was used on the request.
Parameters:
requestEncodingStyle - The request encoding style.

getRequestEncodingStyle

public java.lang.String getRequestEncodingStyle()
Get the encoding style that was used on the request.
Returns:
The request encoding style.

setServiceDeploymentDescriptor

public void setServiceDeploymentDescriptor(ServiceDeploymentDescriptor serviceDeploymentDescriptor)
Set the service deployment descriptor for the requested service.
Parameters:
serviceDeploymentDescriptor - The service deployment descriptor for this request.

getServiceDeploymentDescriptor

public ServiceDeploymentDescriptor getServiceDeploymentDescriptor()
Get the service deployment descriptor for the requested service.
Returns:
The service deployment descriptor for this request, or null if the provider is an AutonomousProvider.

setMethodName

public void setMethodName(java.lang.String methodName)
Set the method name for this SOAP request. The method name is in the envelope, but it can be "cached" here by the server as a convenience.
Parameters:
methodName - The method name that is being invoked in the service.

getMethodName

public java.lang.String getMethodName()
Get the method name for this SOAP request.
Returns:
The the method name being invoked.

setServiceId

public void setServiceId(java.lang.String serviceId)
Set the service id (URI) for this SOAP request.
Parameters:
serviceId - The URI for the service to which this request is directed.

getServiceId

public java.lang.String getServiceId()
Get the service id (URI) for this SOAP request.
Returns:
The URI for the service to which this request is directed.

setUserContext

public void setUserContext(UserContext userContext)
Set the user context for this SOAP request.
Parameters:
userContext - The user context.

getUserContext

public UserContext getUserContext()
Get the user context for this SOAP request.
Returns:
The user context.


Copyright 2001 Oracle SOAP. All Rights Reserved.