org.mgif.connectivity.async
Interface ServiceIndicationMessage

All Superinterfaces:
Attributes, Datagram, Message

public interface ServiceIndicationMessage
extends Message

An interface representing a service indication message.

The Service Indication (SI) message sends notifications to wap terminals in an asynchronous manner. These notifications may, for example, be about new email, changes in stock price, news headlines, advertising, or reminders of various types.

In its most basic form, a Service Indication (SI) contains a short message and a URI indicating a service. When the client device receives the SI, the user is given the choice either to start the service indicated by the URI immediately or postpone the SI for later handling. If the user postpones the SI, the client device stores it and the user is given the opportunity to act upon it later.

See Also:
MGIF

Method Summary
 ServiceIndicationAction getAction()
          Returns the type of action this SI enables.
 java.lang.String getHref()
          Returns the URI used to access the indicated service.
 java.lang.String getMessage()
          Returns the alert text displayed on the client device.
 void setAction(ServiceIndicationAction action)
          Sets the the type of action this SI enables.
 void setHref(java.lang.String href)
          Sets the the URI used to access the indicated service.
 void setMessage(java.lang.String message)
          Sets the alert text displayed on the client device.
 
Methods inherited from interface org.mgif.connectivity.async.Message
getDeliveryNotification, getExpiration, getMessageId, getTimestamp, numberOfSegments, send, setDeliveryNotification, setExpiration
 
Methods inherited from interface org.mgif.connectivity.transfer.Datagram
getLocale, getLocales, getProtocol, getScheme, getTerminalId
 
Methods inherited from interface org.mgif.connectivity.transfer.Attributes
getAttribute, getAttributeNames, getAttributes, isAttribute, removeAttribute, setAttribute
 

Method Detail

getAction

public ServiceIndicationAction getAction()
Returns the type of action this SI enables. See ServiceIndicationAction for more information.
Returns:
the ServiceIndicationAction indicating the action type

getHref

public java.lang.String getHref()
Returns the URI used to access the indicated service. A null value indicates that the SI is a simple notification for display on the client device.
Returns:
the String specifying the service URI or null

getMessage

public java.lang.String getMessage()
Returns the alert text displayed on the client device.
Returns:
the String specifying the alert text

setAction

public void setAction(ServiceIndicationAction action)
Sets the the type of action this SI enables. See ServiceIndicationAction for more information.
Parameters:
action - the ServiceIndicationAction indicating the action type

setHref

public void setHref(java.lang.String href)
Sets the the URI used to access the indicated service. A null value indicates that the SI is a simple notification for display on the client device.
Parameters:
href - String specifying the service URI, or null

setMessage

public void setMessage(java.lang.String message)
Sets the alert text displayed on the client device.
Parameters:
message - the String specifying the alert text


Copyright © 2002 Mobile Games Interoperability Forum. All rights reserved.
This source code is protected by the legal notice posted at http://www.mgif.org/docs/notice.html