JXTA in a Nutshell

Name

Package net.jxta.rendezvous

Synopsis

The classes in this package are used with the core JXTA rendezvous service. The rendezvous service propagates messages between JXTA peergroups and is used primarily to bridge requests between JXTA peers on networks with no common protocol. For example, a JXTA peer on a network behind a firewall cannot send IP messages through the firewall. It can, however, send an HTTP message to a known rendezvous peer, which can then forward the message to its final destination. This allows peers behind firewalls to discover and contact peers outside of their firewall. This is a specific example of the general propagating service provided by the rendezvous service.

The rendezvous service has two callback mechanisms. Rendezvous listeners may be registered with the rendezvous service; they are notified whenever a peer connects to or disconnects from the rendezvous service. Any number of objects may be registered as a listener. In addition, one object may be registered as a rendezvous monitor. The monitor is also notified when peers connect to or disconnect from the service, but the monitor is responsible for acting on those messages (e.g., publishing the connecting peer’s advertisement).

The rendezvous service is provided by one or more members of a peergroup. Any peer can elect to provide the rendezvous service. In the Java bindings, this election is usually made via the configurator tool, and the core JXTA classes handle all interaction with ...