All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class oracle.soap.server.RequestContext

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

public class RequestContext

extends 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:

• getEnvelope - the envelope containing the request
• getServiceDeploymentDescriptor - the service deployment descriptor for the service in which the method is being invoked
• getServiceId - the URI of the service
• getUserContext - the security context describing the user invoking the method in the service
• getMethodName - the name of the method being invoked in the service.

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

• setResponseBytes - this is the marshalled response. Given a Response, it can be created by building the response envelope and then marshalling the envelope.
• setResponseEnvelope - this is the response envelope, which is logically equivalent to the response bytes.
• getRequestEncodingStyle - the encoding style to use for the response in case of an error (if not set, defaults to Constants.NS_URI_SOAP_ENC, which is SOAP encoding). If the provider cares about this, it should set this value as soon as it can in case of an exception. The provider might use the same encoding as the request or as one of the parameters.

RequestContext()

getMethodName()

Get the method name for this SOAP request.

getRequestEncodingStyle()

Get the encoding style that was used on the request.

getRequestEnvelope()

Get the envelope that represents the actual SOAP request.

getResponseBytes()

Get the response stream for this SOAP request.

getResponseEnvelope()

Get the envelope that represents the SOAP response.

getResponseMap()

Get the mapping registry that must be used to serialize the SOAP response.

getServiceDeploymentDescriptor()

Get the service deployment descriptor for the requested service.

getServiceId()

Get the service id (URI) for this SOAP request.

getUserContext()

Get the user context for this SOAP request.

setMethodName(String)

Set the method name for this SOAP request.

setRequestEncodingStyle(String)

Set the encoding style that was used on the request.

setRequestEnvelope(Envelope)

Set the envelope that represents the actual SOAP request.

setResponseBytes(ByteArrayOutputStream)

Set the response stream for this SOAP request.

setResponseEnvelope(Envelope)

Set the envelope that represents the SOAP response.

setResponseMap(SOAPMappingRegistry)

Set the mapping registry that must be used to serialize the SOAP response envelope.

setServiceDeploymentDescriptor(ServiceDeploymentDescriptor)

Set the service deployment descriptor for the requested service.

setServiceId(String)

Set the service id (URI) for this SOAP request.

setUserContext(UserContext)

Set the user context for this SOAP request.

 public RequestContext()

 public void setRequestEnvelope(Envelope envelope)

Set the envelope that represents the actual SOAP request.

Parameters:

envelope - The SOAP envelope.

 public Envelope getRequestEnvelope()

Get the envelope that represents the actual SOAP request.

Returns:

The SOAP envelope.

 public void setResponseEnvelope(Envelope envelope)

Set the envelope that represents the SOAP response.

Parameters:

envelope - The SOAP response envelope.

 public Envelope getResponseEnvelope()

Get the envelope that represents the SOAP response.

Returns:

The SOAP response envelope.

 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.

 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.

 public void setResponseBytes(ByteArrayOutputStream bytes)

Set the response stream for this SOAP request.

Parameters:

bytes - The ByteArrayOutputStream that contains the response.

 public ByteArrayOutputStream getResponseBytes()

Get the response stream for this SOAP request.

Returns:

The ByteArrayOutputStream that contains the response.

 public void setRequestEncodingStyle(String requestEncodingStyle)

Set the encoding style that was used on the request.

Parameters:

requestEncodingStyle - The request encoding style.

 public String getRequestEncodingStyle()

Get the encoding style that was used on the request.

Returns:

The request encoding style.

 public void setServiceDeploymentDescriptor(ServiceDeploymentDescriptor serviceDeploymentDescriptor)

Set the service deployment descriptor for the requested service.

Parameters:

serviceDeploymentDescriptor - The service deployment descriptor for this request.

 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.

 public void setMethodName(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.

 public String getMethodName()

Get the method name for this SOAP request.

Returns:

The the method name being invoked.

 public void setServiceId(String serviceId)

Set the service id (URI) for this SOAP request.

Parameters:

serviceId - The URI for the service to which this request is directed.

 public String getServiceId()

Get the service id (URI) for this SOAP request.

Returns:

The URI for the service to which this request is directed.

 public void setUserContext(UserContext userContext)

Set the user context for this SOAP request.

Parameters:

userContext - The user context.

 public UserContext getUserContext()

Get the user context for this SOAP request.

Returns:

The user context.

All Packages  Class Hierarchy  This Package  Previous  Next  Index