messagelisteneradapter.java

openwave公司的用于彩信开发的MM7协议实现java原代码,决对超值.

package com.openwave.mms.mm7;

/**
 *  This is the adapter class of the {@link MessageListener} interface that 
 *  defines the methods that applications use to process requests from MMSC.
 *  This class is for use by applications that operate in receive-only or send 
 *  and receive mode. 
 *  <p> 
 *  To implement only the <code>process</code> methods that correspond to 
 *  requests that you support, extend this class instead of implementing the 
 *  <code>MessageListener</code> interface. 
 * 
 *  To use this class:
 *  <OL>
 *  <LI>  Create an object that implements this interface. 
 *  <LI>  Provide custom implementations of the methods you support. Because 
 *        objects that implement this interface are used by multiple threads, 
 *        you must synchronize reading and writing of data within this object.
 *  </OL>
 * 
 *  For information about how to use your implementation of this class in
 *  in standalone and servlet applications, see the <em>Openwave MMS Library 
 *  Developer's Guide</em>. 
 */
public class MessageListenerAdapter implements MessageListener {
    /**
     *  Instantiates a <code>MessageListenerAdapter</code> object.
     */
    public MessageListenerAdapter() {}

    /**
     *  Processes deliver requests from MMSC. When a deliver request is received
     *  from MMSC, the API automatically calls this method and passes it a 
     *  {@link DeliverRequest} object that represents the request. 
     *  <p>
     *  Use the <code>DeliverRequest</code> accessors to access the contents of 
     *  the request object. After examining the request, if you accept it,
     *  create and return a {@link DeliverResponse} object. If you do not 
     *  accept it, either:
     *  <UL><LI> Create and return a {@link FaultResponse} object that 
     *       indicates the reason you rejected the request.
     *  <LI> Throw a {@link MessageProcessingException} to have the 
     *       API automatically create a <code>FaultResponse</code> object.  
     * </UL></p>
     *
     *  @param deliverRequest The API-generated <code>DeliverRequest</code> object 
     *          that corresponds to the deliver request received from MMSC.
     *  @return <code>Null</code> object.
     *  @exception MessageProcessingException If the application cannot
     *             process the message, this exception is thrown to have the API
     *             create the <code>FaultResponse</code> object to return to MMSC.
     *
     */
    public Response processDeliverRequest( DeliverRequest deliverRequest )
                                           throws MessageProcessingException {
        return null;
    }

    /**
     *  Processes delivery report requests from MMSC. When a delivery report request
     *  is received from MMSC, the API automatically calls this method and passes it a 
     *  {@link DeliveryReport} object that represents the request. 
     *  <p>
     *  Use the <code>DeliveryReport</code> accessors to access the contents of 
     *  the request object. After examining the request, if you accept it,
     *  create and return a {@link DeliveryReportResponse} object. If you do not 
     *  accept it, either:
     *  <UL><LI> Create and return a {@link FaultResponse} object that 
     *       indicates the reason you rejected the request.
     *  <LI> Throw a {@link MessageProcessingException} to have the 
     *       API automatically create a <code>FaultResponse</code> object.  
     * </UL></p>
     *
     *  @param deliveryReport The API-generated <code>DeliveryReport</code> object 
     *          that corresponds to the delivery report request received from MMSC.
     *  @return <code>Null</code> object.
     *  @exception MessageProcessingException If the application cannot
     *             process the message, this exception is thrown to have the API
     *             create the <code>FaultResponse</code> object to return to MMSC.
     *
     */
    public Response processDeliveryReport( DeliveryReport deliveryReport )
                                           throws MessageProcessingException {
        return null;
    }

    /**
     *  Processes read-reply requests from MMSC. When a read-reply request
     *  is received from MMSC, the API automatically calls this method and  
     *  passes it a {@link ReadReply} object that represents the request. 
     *  <p>
     *  Use the <code>ReadReply</code> accessors to access the contents of 
     *  the request object. After examining the request, if you accept it,
     *  create and return a {@link ReadReplyResponse} object. If you do not 
     *  accept it, either:
     *  <UL><LI> Create and return a {@link FaultResponse} object that 
     *       indicates the reason you rejected the request.
     *  <LI> Throw a {@link MessageProcessingException} to have the 
     *       API automatically create a <code>FaultResponse</code> object.  
     * </UL></p>
     *
     *  @param readReply The API-generated <code>ReadReply</code> object 
     *          that corresponds to the read-reply request received from MMSC.
     *  @return <code>Null</code> object.
     *  @exception MessageProcessingException If the application cannot
     *             process the message, this exception is thrown to have the API
     *             create the <code>FaultResponse</code> object to return to MMSC.
     *
     */
    public Response processReadReply( ReadReply readReply )
                                      throws MessageProcessingException {
        return null;
    }
}