Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle Service Bus
11g Release 1 (11.1.1.5.0)

E15033-03


com.bea.wli.sb.transports
Interface InboundTransportMessageContext

All Superinterfaces:
TransportMessageContext
All Known Subinterfaces:
InboundTransportMessageContextExtension
All Known Implementing Classes:
CoLocatedMessageContext

public interface InboundTransportMessageContext
extends TransportMessageContext

Inbound Transport Message Context implements the message context abstraction for incoming messages


Method Summary
 void close(TransportOptions options)
          Commits the contents of this context and clean up any resources used by this context.
 ResponseMetaData createResponseMetaData()
          Creates a new (empty) response meta data POJO
 ResponseMetaData createResponseMetaData(org.apache.xmlbeans.XmlObject rmdXML)
          Creates a new response meta data POJO
 TransportEndPoint getEndPoint()
           
 RequestMetaData getRequestMetaData()
           
 Source getRequestPayload()
           
 void setResponseMetaData(ResponseMetaData rmd)
          Deprecated. see InboundTransportMessageContextExtension.setReplySender(TransportReplySender)
 void setResponsePayload(Source src)
          Deprecated. see InboundTransportMessageContextExtension.setReplySender(TransportReplySender)

 

Methods inherited from interface com.bea.wli.sb.transports.TransportMessageContext
getMessageId, getURI

 

Method Detail

getEndPoint

TransportEndPoint getEndPoint()
                              throws TransportException
Returns:
the service endpoint object which has received this incoming message
Throws:
TransportException

getRequestMetaData

RequestMetaData getRequestMetaData()
                                   throws TransportException
Returns:
the meta-data for the request part of the message, e.g. headers, etc. Returns null if there is no request meta-data
Throws:
TransportException

getRequestPayload

Source getRequestPayload()
                         throws TransportException
Returns:
returns a source (e.g. input stream or a DOM object) for reading data in the body of the request of an inbound message or null if there is no body of the request. Note that the entire body of the payload is retrieved.
Throws:
TransportException

createResponseMetaData

ResponseMetaData createResponseMetaData()
                                        throws TransportException
Creates a new (empty) response meta data POJO
Returns:
empty (new) meta-data for the response part of the message, e.g. headers, etc. Used for initializing the inbound response
Throws:
TransportException

createResponseMetaData

ResponseMetaData createResponseMetaData(org.apache.xmlbeans.XmlObject rmdXML)
                                        throws TransportException
Creates a new response meta data POJO
Parameters:
rmdXML - transport provider-specific XML Bean that represents the provider-specific meta data
Returns:
meta-data for the response part of the message, e.g. headers, etc initialized according to XML bean. Used for initializing the inbound response
Throws:
TransportException

setResponseMetaData

void setResponseMetaData(ResponseMetaData rmd)
                         throws TransportException
Deprecated. see InboundTransportMessageContextExtension.setReplySender(TransportReplySender)
Sets the meta-data for the response part of the message, e.g. headers, etc.
Parameters:
rmd - Transport Provider-specific POJO that represents response meta data
Throws:
TransportException

setResponsePayload

void setResponsePayload(Source src)
                        throws TransportException
Deprecated. see InboundTransportMessageContextExtension.setReplySender(TransportReplySender)
Sets the response payload into the message context Important note: the transport provider is free to access the response payload source from the moment this method call is made up all the way until close(TransportOptions) is called. Any access of response payload source after close() has been called can lead to unpredictable results and is generally unsafe.
Parameters:
src - source containing the response payload
Throws:
TransportException

close

void close(TransportOptions options)
Commits the contents of this context and clean up any resources used by this context. Note: Transport provider should NOT access response payload source after this method call has been made.
Parameters:
options - specifies additional run-time parameters with respect to processing of inbound response. E.g. it can signal the mode of a given message: one-way versus request/response

Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle Service Bus
11g Release 1 (11.1.1.5.0)

E15033-03


Copyright © 2008, 2011, Oracle. All rights reserved.