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