Apache CXF API

org.apache.cxf.message
Interface Message

All Superinterfaces:
Map<String,Object>, StringMap
All Known Implementing Classes:
AbstractWrappedMessage, CorbaMessage, MessageImpl, SoapMessage, XMLMessage, XMLMessage

public interface Message
extends StringMap

The base interface for all all message implementations. All message objects passed to interceptors use this interface.


Nested Class Summary
 
Nested classes/interfaces inherited from interface java.util.Map
Map.Entry<K,V>
 
Field Summary
static String ACCEPT_CONTENT_TYPE
           
static String ASYNC_POST_RESPONSE_DISPATCH
          Boolean property specifying if the server should send the response asynchronously.
static String ATTACHMENTS
           
static String BASE_PATH
           
static String CONNECTION_TIMEOUT
           
static String CONTENT_TYPE
           
static String DECOUPLED_CHANNEL_MESSAGE
          Boolean property specifying if this message arrived via a decoupled endpoint.
static String EMPTY_PARTIAL_RESPONSE_MESSAGE
           
static String ENCODING
           
static String ENDPOINT_ADDRESS
           
static String EXCEPTION_CAUSE_SUFFIX
          A very unique delimiter used for exception with FAULT_STACKTRACE_ENABLED enable, which is easy for client to differentiate the cause and stacktrace when unmarsall a fault message
static String EXCEPTION_MESSAGE_CAUSE_ENABLED
          Boolean property specifying if the name of the exception that caused the Java stack trace is returned.
static String FAULT_IN_INTERCEPTORS
           
static String FAULT_OUT_INTERCEPTORS
           
static String FAULT_STACKTRACE_ENABLED
          Boolean property specifying if the Java stack trace is returned as a SOAP fault message.
static String FIXED_PARAMETER_ORDER
           
static String HTTP_REQUEST_METHOD
           
static String IN_INTERCEPTORS
          Some properties to allow adding interceptors to the chain on a per-request basis.
static String INBOUND_MESSAGE
          Boolean property specifying if the message is inbound.
static String INTERCEPTOR_PROVIDERS
          As above, but Collection
static String INVOCATION_CONTEXT
          A Map keyed by a string that stores optional context information associated with the invocation that spawned the message.
static String MAINTAIN_SESSION
           
static String MIME_HEADERS
          A Map containing the MIME headers for a SOAP message.
static String MTOM_ENABLED
          Boolean property specifying in the runtime is configured to process MTOM attachments.
static String MTOM_THRESHOLD
           
static String ONE_WAY_REQUEST
           
static String OUT_INTERCEPTORS
           
static String PARTIAL_RESPONSE_MESSAGE
           
static String PATH_INFO
           
static String PROCESS_ONEWAY_RESPONSE
          Boolean property specifying if oneWay response must be processed.
static String PROPOGATE_EXCEPTION
           
static String PROTOCOL_HEADERS
           
static String QUERY_STRING
           
static String RECEIVE_TIMEOUT
           
static String REQUEST_URI
           
static String REQUEST_URL
           
static String REQUESTOR_ROLE
          Boolean property specifying if the message is a request message.
static String RESPONSE_CODE
           
static String REST_MESSAGE
           
static String ROBUST_ONEWAY
           
static String SCHEMA_VALIDATION_ENABLED
           
static String SERVICE_OBJECT
          Current Service Object
static String THREAD_CONTEXT_SWITCHED
          Boolean property specifying if the thread which runs a request is different to the thread which created this Message.
static String TRANSPORT
           
static String WSDL_DESCRIPTION
           
static String WSDL_INTERFACE
           
static String WSDL_OPERATION
           
static String WSDL_PORT
           
static String WSDL_SERVICE
           
 
Method Summary
 Collection<Attachment> getAttachments()
          Retrieve any binary attachments associated with the message.
<T> T
getContent(Class<T> format)
          Retrieve the encapsulated content as a particular type.
 Set<Class<?>> getContentFormats()
           
 Object getContextualProperty(String key)
          Queries the Message object's metadata for a specific property.
 Set<String> getContextualPropertyKeys()
           
 Destination getDestination()
           
 Exchange getExchange()
           
 String getId()
           
 InterceptorChain getInterceptorChain()
          Returns a live copy of the messages interceptor chain.
<T> void
removeContent(Class<T> format)
          Removes a content from a message.
 void resetContextCache()
           
 void setAttachments(Collection<Attachment> attachments)
           
<T> void
setContent(Class<T> format, Object content)
          Provide the encapsulated content as a particular type (a result type if message is outbound, a source type if message is inbound)
 void setContextualProperty(String key, Object v)
           
 void setExchange(Exchange exchange)
           
 void setId(String id)
           
 void setInterceptorChain(InterceptorChain chain)
           
 
Methods inherited from interface org.apache.cxf.message.StringMap
get, put
 
Methods inherited from interface java.util.Map
clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, values
 

Field Detail

TRANSPORT

static final String TRANSPORT
See Also:
Constant Field Values

REST_MESSAGE

static final String REST_MESSAGE
See Also:
Constant Field Values

REQUESTOR_ROLE

static final String REQUESTOR_ROLE
Boolean property specifying if the message is a request message.

See Also:
Constant Field Values

INBOUND_MESSAGE

static final String INBOUND_MESSAGE
Boolean property specifying if the message is inbound.

See Also:
Constant Field Values

INVOCATION_CONTEXT

static final String INVOCATION_CONTEXT
A Map keyed by a string that stores optional context information associated with the invocation that spawned the message.

See Also:
Constant Field Values

SERVICE_OBJECT

static final String SERVICE_OBJECT
Current Service Object

See Also:
Constant Field Values

MIME_HEADERS

static final String MIME_HEADERS
A Map containing the MIME headers for a SOAP message.

See Also:
Constant Field Values

ASYNC_POST_RESPONSE_DISPATCH

static final String ASYNC_POST_RESPONSE_DISPATCH
Boolean property specifying if the server should send the response asynchronously.

See Also:
Constant Field Values

DECOUPLED_CHANNEL_MESSAGE

static final String DECOUPLED_CHANNEL_MESSAGE
Boolean property specifying if this message arrived via a decoupled endpoint.

See Also:
Constant Field Values

PARTIAL_RESPONSE_MESSAGE

static final String PARTIAL_RESPONSE_MESSAGE
See Also:
Constant Field Values

EMPTY_PARTIAL_RESPONSE_MESSAGE

static final String EMPTY_PARTIAL_RESPONSE_MESSAGE
See Also:
Constant Field Values

ONE_WAY_REQUEST

static final String ONE_WAY_REQUEST
See Also:
Constant Field Values

PROCESS_ONEWAY_RESPONSE

static final String PROCESS_ONEWAY_RESPONSE
Boolean property specifying if oneWay response must be processed.

See Also:
Constant Field Values

THREAD_CONTEXT_SWITCHED

static final String THREAD_CONTEXT_SWITCHED
Boolean property specifying if the thread which runs a request is different to the thread which created this Message.

See Also:
Constant Field Values

ROBUST_ONEWAY

static final String ROBUST_ONEWAY
See Also:
Constant Field Values

HTTP_REQUEST_METHOD

static final String HTTP_REQUEST_METHOD
See Also:
Constant Field Values

REQUEST_URI

static final String REQUEST_URI
See Also:
Constant Field Values

REQUEST_URL

static final String REQUEST_URL
See Also:
Constant Field Values

PROTOCOL_HEADERS

static final String PROTOCOL_HEADERS

RESPONSE_CODE

static final String RESPONSE_CODE

ENDPOINT_ADDRESS

static final String ENDPOINT_ADDRESS

PATH_INFO

static final String PATH_INFO

QUERY_STRING

static final String QUERY_STRING

PROPOGATE_EXCEPTION

static final String PROPOGATE_EXCEPTION

MTOM_ENABLED

static final String MTOM_ENABLED
Boolean property specifying in the runtime is configured to process MTOM attachments.

See Also:
Constant Field Values

MTOM_THRESHOLD

static final String MTOM_THRESHOLD
See Also:
Constant Field Values

SCHEMA_VALIDATION_ENABLED

static final String SCHEMA_VALIDATION_ENABLED
See Also:
Constant Field Values

FAULT_STACKTRACE_ENABLED

static final String FAULT_STACKTRACE_ENABLED
Boolean property specifying if the Java stack trace is returned as a SOAP fault message.

See Also:
Constant Field Values

EXCEPTION_MESSAGE_CAUSE_ENABLED

static final String EXCEPTION_MESSAGE_CAUSE_ENABLED
Boolean property specifying if the name of the exception that caused the Java stack trace is returned.

See Also:
Constant Field Values

EXCEPTION_CAUSE_SUFFIX

static final String EXCEPTION_CAUSE_SUFFIX
A very unique delimiter used for exception with FAULT_STACKTRACE_ENABLED enable, which is easy for client to differentiate the cause and stacktrace when unmarsall a fault message

See Also:
Constant Field Values

CONTENT_TYPE

static final String CONTENT_TYPE
See Also:
Constant Field Values

ACCEPT_CONTENT_TYPE

static final String ACCEPT_CONTENT_TYPE
See Also:
Constant Field Values

BASE_PATH

static final String BASE_PATH

ENCODING

static final String ENCODING

FIXED_PARAMETER_ORDER

static final String FIXED_PARAMETER_ORDER

MAINTAIN_SESSION

static final String MAINTAIN_SESSION

ATTACHMENTS

static final String ATTACHMENTS

WSDL_DESCRIPTION

static final String WSDL_DESCRIPTION
See Also:
Constant Field Values

WSDL_SERVICE

static final String WSDL_SERVICE
See Also:
Constant Field Values

WSDL_PORT

static final String WSDL_PORT
See Also:
Constant Field Values

WSDL_INTERFACE

static final String WSDL_INTERFACE
See Also:
Constant Field Values

WSDL_OPERATION

static final String WSDL_OPERATION
See Also:
Constant Field Values

IN_INTERCEPTORS

static final String IN_INTERCEPTORS
Some properties to allow adding interceptors to the chain on a per-request basis. All are a Collection These are NOT contextual properties (ie: not searched outside the message). They must exist on the message itself at time of Chain creation


OUT_INTERCEPTORS

static final String OUT_INTERCEPTORS

FAULT_IN_INTERCEPTORS

static final String FAULT_IN_INTERCEPTORS

FAULT_OUT_INTERCEPTORS

static final String FAULT_OUT_INTERCEPTORS

INTERCEPTOR_PROVIDERS

static final String INTERCEPTOR_PROVIDERS
As above, but Collection


CONNECTION_TIMEOUT

static final String CONNECTION_TIMEOUT
See Also:
Constant Field Values

RECEIVE_TIMEOUT

static final String RECEIVE_TIMEOUT
See Also:
Constant Field Values
Method Detail

getId

String getId()

setId

void setId(String id)

getInterceptorChain

InterceptorChain getInterceptorChain()
Returns a live copy of the messages interceptor chain. This is useful when an interceptor wants to modify the interceptor chain on the fly.

Returns:
the interceptor chain used to process the message

setInterceptorChain

void setInterceptorChain(InterceptorChain chain)

getDestination

Destination getDestination()
Returns:
the associated Destination if message is inbound, null otherwise

getExchange

Exchange getExchange()

setExchange

void setExchange(Exchange exchange)

getAttachments

Collection<Attachment> getAttachments()
Retrieve any binary attachments associated with the message.

Returns:
a collection containing the attachments

setAttachments

void setAttachments(Collection<Attachment> attachments)

getContent

<T> T getContent(Class<T> format)
Retrieve the encapsulated content as a particular type. The content is available as a result type if the message is outbound. The content is available as a source type if message is inbound. If the content is not available as the specified type null is returned.

Parameters:
format - the expected content format
Returns:
the encapsulated content

setContent

<T> void setContent(Class<T> format,
                    Object content)
Provide the encapsulated content as a particular type (a result type if message is outbound, a source type if message is inbound)

Parameters:
format - the provided content format
content - the content to be encapsulated

getContentFormats

Set<Class<?>> getContentFormats()
Returns:
the set of currently encapsulated content formats

removeContent

<T> void removeContent(Class<T> format)
Removes a content from a message. If some contents are completely consumed, removing them is a good idea

Parameters:
format - the format to remove

getContextualProperty

Object getContextualProperty(String key)
Queries the Message object's metadata for a specific property.

Parameters:
key - the Message interface's property strings that correlates to the desired property
Returns:
the property's value

resetContextCache

void resetContextCache()

setContextualProperty

void setContextualProperty(String key,
                           Object v)

getContextualPropertyKeys

Set<String> getContextualPropertyKeys()
Returns:
set of defined contextual property keys

Apache CXF API

Apache CXF