|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Destination
Encapsulates a target for messages. The target that a destination represents can either be remote or local from
the perspective of the consumer of the Destination
object. REMOTE
destinations are
Destination
objects to which you want to send messages. Examples may include a web service, or a URI
representing a queue for another application. A LOCAL
destination is one that you want to receive messages
from. Examples of LOCAL
destinations include a Destination
associated with a push URI (e.g.
listens to pushes from an outside source), or a Reply-To queue from another application communication.
Exceptions are thrown when you try to use an unsupported operation on a destination, such as receive()
on
a REMOTE
destination, or send()
on a LOCAL
destination).
Method Summary | ||
---|---|---|
void |
destroy()
Closes the destination. |
|
URI |
getUri()
Returns the URI that this destination represents. |
|
void |
pause()
Temporarily halts delivery of messages to this destination. |
|
void |
release()
Releases a destination. |
|
void |
resume()
Resumes delivery of messages to this destination. |
Method Detail |
---|
void destroy()
Destination
. This method also destroys any persistable outbound and inbound queues. If
Destination
uses the Push API, this method will unregister associated push subscriptions.
This method should be called only during the removal of an application.
void release()
Destination
when it is used in a currently running application. This method will not suspend delivery of incoming or outgoing
messages, cancel any outgoing messages, or unregister any push subscriptions associated with the
Destination
This method should be used if an application using this Destination
is closing,
but will be used later (including Auto Start).
void pause()
MessageListener
objects will not
receive any messages until the resume()
method is called. If the Destination
is already
paused, then this operation will have no effect.
Destination.resume()
void resume()
MessageListener
. If the Destination
is not paused, then this operation has no effect.
Destination.pause()
URI getUri()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
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.