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





Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.