sjero.net Git - linphone/blob - p2pproxy/dependencies-src/jxse-src-2.5/impl/src/net/jxta/impl/id/binaryID/package.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2
   3 <HTML>
   4 <HEAD>
   5 </HEAD>
   6 <BODY>
   7 The 'binary' format is a general purpose JXTA ID Format. It implements Peer,
   8 group, and pipe ID types. The remaining types are supported, but not
   9 guarenteed (CODAT not supported at all yet).<p>
  10
  11     The DigestTool class is probably the main entry point for most developers.
  12     The class creates various BinaryID types with an SHA digest hashing. The
  13     intent is to make secure but non-random possible for ID pipes, peers,
  14     and peer groups. When using the utility, it is recomended tha you use
  15     a hash size apropriate to your address space.
  16
  17     @see net.jxta.impl.id.binaryID.DigestTool
  18
  19     This package supports the creation of an identifier given a binary value
  20     that is 0 to 255 bytes long that is encoded as Base64. The value needs to
  21     be a unique value so that it can be used for addressing peers, pipes, and
  22     groups.
  23
  24 <p>
  25
  26     The implementation also includes the creation of a digest hash given an
  27     arbirary length string. This allows you to encode any type of data into
  28     a secure digest. The digest hash is recomended unless you are sure that
  29     your binary id is truely unique. Using a digest hash is also preferrable
  30     for situatins when you have an id that could be comprimized if known (like
  31     a socal security number). The digest tools also have convenience methods
  32     for mixing an id with a function name and a way to create a time
  33     limited ID.
  34
  35 <p>
  36
  37     Note that this ID currently only allows parent peer group ID to be of
  38     type UUID.
  39
  40 <p>
  41
  42     @author Daniel Brookshier <a HREF="mailto:turbogeek@cluck.com">turbogeek@cluck.com</a>
  43
  44
  45     @see <a href="https://jxta-spec.dev.java.net/nonav/JXTAProtocols.html#refimpls-ids-jiuft" target="_blank">JXTA
  46     Protocols Specification : IDs</a>
  47
  48 </BODY>
  49 </HTML>