net.rim.device.api.io.messaging
Interface MessageProcessor

All Known Subinterfaces:

ChainableMessageProcessor

All Known Implementing Classes:

MessageProcessorChain, GUNZIPMessageProcessor, JSONHashtableMessageProcessor, JSONMessageProcessor, RSSMessageProcessor, SOAPMessageProcessor, DOMMessageProcessor, XMLHashtableMessageProcessor

public interface MessageProcessor

Defines an interface that allows processing, parsing, filtering and other forms of manipulation of incoming Message data. Some examples of MessageProcessor implementations include XML parsing, JSON parsing, application level compression/decompression, application level encryption/decryption, logging, and so on.

A MessageProcessor may be invoked in two ways: processing mode or chaining mode. In processing mode, the MessageProcessor is expected to fully process the message. In chaining mode, the MessageProcessor is expected to wrap the body of the message with a stream wrapper that will process on demand. When multiple processors are used together, chaining mode is used to minimize the amount of buffering/copying in between processors.

Since:

BlackBerry API 6.0.0

Method Summary
void	process(Message message) Processes the message and returns the results.

Method Detail

process

void process(Message message)
             throws MessageProcessorException

Processes the message and returns the results.

Parameters:

message - The message to be processed.

Throws:

MessageProcessorException

Since:

BlackBerry API 6.0.0