com.ibm.soa.parlayx21.multimedia_messaging
Interface MessageNotification

All Superinterfaces:
java.rmi.Remote
All Known Subinterfaces:
MessageNotification_RI
All Known Implementing Classes:
MessageNotificationBindingStub, MessageNotificationProxy

public interface MessageNotification
extends java.rmi.Remote

The message notification interface delivers the notification.

MessageNotification is the application side notification interface to which notifications about multimedia messages are delivered.


Method Summary
 void notifyMessageDeliveryReceipt(java.lang.String correlator, DeliveryInformation deliveryStatus)
          The notifyMessageDeliveryReceipt method must be implemented by a Web Service at the application side if it requires notification of message delivery receipt.
 void notifyMessageReception(java.lang.String correlator, MessageReference message)
          The notification to the application will occur only if the multimedia message fulfils the criteria specified when starting the multimedia message notification.
 

Method Detail

notifyMessageReception

void notifyMessageReception(java.lang.String correlator,
                            MessageReference message)
                            throws java.rmi.RemoteException

The notification to the application will occur only if the multimedia message fulfils the criteria specified when starting the multimedia message notification.

Referenced faults

None.

Parameters:
correlator - xsd:string

Correlator provided in request to set up this notification.

message - MessageReference

This parameter contains all the information associated with the received message.

Throws:
java.rmi.RemoteException

notifyMessageDeliveryReceipt

void notifyMessageDeliveryReceipt(java.lang.String correlator,
                                  DeliveryInformation deliveryStatus)
                                  throws java.rmi.RemoteException
The notifyMessageDeliveryReceipt method must be implemented by a Web Service at the application side if it requires notification of message delivery receipt. It will be invoked by the Parlay X 2 server to notify the application when a message sent by an application has been delivered to the terminal of the recipient or if delivery is impossible. The notification will occur if and only if the status of the sent message is DeliveredToTerminal or DeliveryImpossible and the application has specified interest in notification when sending a message by specifying the optional receiptRequest part. The correlator returned corresponds to the identifier specified by the application in the receiptRequest part of the original sendMessage request

When a message is sent to multiple addresses, the server will send a notification for each terminal as and when a message is delivered to the terminal.

The following three different message delivery status will be returned in the notifyMessageDeliveryReceiptRequest message:
  * DeliveryImpossible: unsuccessful delivery; the message could not be delivered before it expired.
  * DeliveredToTerminal: when the message has been successfully delivered to the terminal.
  * DeliveredNotificationNotSupported: if notification is supported by the network but it does not support delivery receipt for one or more addresses specified in the sendMessageRequest message. The service will send this status for those addresses.

Referenced faults

None.

Parameters:
correlator - xsd:string The identifier defining the original ‘Send’ Request. This correlator was provided by the application in the sendMessageRequest message
deliveryStatus - DeliveryInformation

It lists the variations on the delivery status of the message to a terminal. Possible values are:
  * DeliveryImpossible
  * DeliveredToTerminal
  * DeliveryNotificationNotSupported

Throws:
java.rmi.RemoteException


Copyright © 2003 IBM Corp. All Rights Reserved.