
net.jxta.impl.id.binaryID.package.html Maven / Gradle / Ivy
Show all versions of jxta-jxse Show documentation
The 'binary' format is a general purpose JXTA ID Format. It implements Peer,
group, and pipe ID types. The remaining types are supported, but not
guarenteed (CODAT not supported at all yet).
The DigestTool class is probably the main entry point for most developers.
The class creates various BinaryID types with an SHA digest hashing. The
intent is to make secure but non-random possible for ID pipes, peers,
and peer groups. When using the utility, it is recomended tha you use
a hash size apropriate to your address space.
@see net.jxta.impl.id.binaryID.DigestTool
This package supports the creation of an identifier given a binary value
that is 0 to 255 bytes long that is encoded as Base64. The value needs to
be a unique value so that it can be used for addressing peers, pipes, and
groups.
The implementation also includes the creation of a digest hash given an
arbirary length string. This allows you to encode any type of data into
a secure digest. The digest hash is recomended unless you are sure that
your binary id is truely unique. Using a digest hash is also preferrable
for situatins when you have an id that could be comprimized if known (like
a socal security number). The digest tools also have convenience methods
for mixing an id with a function name and a way to create a time
limited ID.
Note that this ID currently only allows parent peer group ID to be of
type UUID.
@author Daniel Brookshier [email protected]
@see JXTA
Protocols Specification : IDs