JXTA in a Nutshell

Pipe Advertisements

A pipe advertisement describes a pipe and is used by the pipe service to create associated input and output pipe endpoints. Each pipe advertisement can include an optional symbolic name for the pipe and a pipe type to indicate the type of the pipe (point-to-point, propagate, secure, etc.). See Example 14-3.

Example 14-3. Pipe advertisement schema

<xs:element name="PipeAdvertisement" type="jxta:PipeAdvertisement"/>

<xs:complexType name="PipeAdvertisement">         
   <xs:element name="Name" type="xs:string" minOccurs="0"/>         
   <xs:element name="Id" type="JXTAID"/>         
   <xs:element name="Type" "UnicastType" | "UnicastSecureType" | 
"PropagateType"/> 
</xs:complexType>

The elements in Example 14-3 are:

Name

This is an optional name that can be associated with a pipe. The name is not required to be unique unless it is obtained from a naming service that guarantees name uniqueness.

Id

This is a required element that uniquely identifies the pipe. Each pipe has a unique ID. The pipe ID representation is given in Chapter 15.

Type

This is a required element that defines the type of pipe. The following types are defined:

UnicastType

May not arrive at the destination, may be delivered more than once to the same destination, or may arrive in a different order

UnicastSecureType

Guaranteed to arrive once and in order; it is encrypted using TLS

PropagateType

One to many UnicastType pipes