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

All Superinterfaces:
Destination, SenderDestination

public interface FireAndForgetDestination
extends SenderDestination

This interface facilitates sending of messages that do not require response handling.

Since:
BlackBerry API 6.0.0

Method Summary
 int sendNoResponse()
          Send an empty message to this destination while disregarding the response.
 int sendNoResponse(Message message)
          Send a message to this destination while disregarding the response.
 
Methods inherited from interface net.rim.device.api.io.messaging.SenderDestination
cancel, cancelAllCancellable, createByteMessage, createStreamMessage
 
Methods inherited from interface net.rim.device.api.io.messaging.Destination
destroy, getUri, pause, release, resume
 



Method Detail

sendNoResponse

int sendNoResponse(Message message)
                   throws MessageFailureException
Send a message to this destination while disregarding the response. This call will block until the message has been successfully dispatched. This call is optimized for situations where you do not care about the message response but still wish to ensure the message was delivered successfully.

Parameters:
message - The message to send. If null, an empty message will be sent.
Returns:
Message ID token used to refer to message later on
Throws:
MessageFailureException - Thrown if the message is unable to be sent for some reason
Since:
BlackBerry API 6.0.0

sendNoResponse

int sendNoResponse()
                   throws MessageFailureException
Send an empty message to this destination while disregarding the response. This call will block until the message has been successfully dispatched. This call is optimized for situations where you do not care about the message response but still wish to ensure the message was delivered successfully.

Returns:
Message ID token used to refer to message later on
Throws:
MessageFailureException - Thrown if the message is unable to be sent for some reason
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.