net.jxta.socket.package.html Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jxta-jxse Show documentation

JXTA technology is a set of open protocols that allow any connected device on the network ranging from cell phones and wireless PDAs to PCs and servers to communicate and collaborate in a P2P manner. JXTA peers create a virtual network where any peer can interact with other peers and resources directly even when some of the peers and resources are behind firewalls and NATs or are on different network transports.

The newest version!






The socket package provides interface ala {@link java.net.Socket}
over JXTA pipes. Since the PipeService provides uni-directional, and
unreliable communication channels, the JxtaSocket employs it's own
protocol over pipes to establish bi-directional connections for every
request. In addition the JxtaSocket also employs the reliability
library to ensure reliable delivery of data.  Another feature of
JxtaSockets is chunking, which relieves applications from having to
worry about mtu size, just remember to invoke flush at the end of data
transmission





JxtaSocket defines the following message elements employed during
the life cycle of a JxtaSocket :


<>
<Cred>Credentials to determine trust</Cred>

<><reqPipe>requestor's
pipe advertisement</reqPipe>

<remPipe>Remote
pipe advertisement</remPipe>

<reqPeer>Remote
peer advertisement</remPeer>

<stream>true|false
== reliable|or not</stream>

<close>close request</close>

<closeACK>ack
close request</closeACK>

<data>data</data>


The socket package also provides interface ala {@link
java.net.MulticastSocket} over propagated pipes.  Keep in mind
JxtaMulticastSocket does not provide chunking nor reliability at this
time, therefore one must consider configuration parameters such as the
multicast datagram size defined for the TCP Message Transport :


<MulticastSize>

    16384

</MulticastSize>


As well as any other mtu size imposed by the JXTA Platform, or the
operating system.


For examples on how to utilize the net.jxta.socket see the online
tutorials on JxtaSocket,
and JxtaMulticastSocket
available at http://www.jxta.org/Tutorials.html