org.eclipse.hyades.automation.core.utils
Class Guid

java.lang.Object
  org.eclipse.hyades.automation.core.utils.Guid

public final class Guid
extends java.lang.Object

Abstract from IETF Specification:

This specification defines the format of UUIDs (Universally Unique IDentifier), also known as GUIDs (Globally Unique IDentifier). A UUID is 128 bits long, and if generated according to the one of the mechanisms in this document, is either guaranteed to be different from all other UUIDs/GUIDs generated until 3400 A.D. or extremely likely to be different (depending on the mechanism chosen). UUIDs were originally used in the Network Computing System (NCS) [1] and later in the Open Software Foundation's (OSF) Distributed Computing Environment [2].

References:

• Lisa Zahn, et. al., Network Computing Architecture, Prentice Hall, Englewood Cliffs, NJ, 1990
• DCE: Remote Procedure Call, Open Group CAE Specification C309 ISBN 1-85912-041-5 28cm. 674p. pbk. 1,655g. 8/94
• R. Rivest, RFC 1321, "The MD5 Message-Digest Algorithm", 04/16/1992.
• NIST FIPS PUB 180-1, "Secure Hash Standard," National Institute of Standards and Technology, U.S. Department of Commerce, DRAFT, May 31, 1994.

This specification is derived from the latter specification with the kind permission of the OSF.

Copyright (c) 1990- 1993, 1996 Open Software Foundation, Inc.
Copyright (c) 1989 by Hewlett-Packard Company, Palo Alto, Ca. & Digital Equipment Corporation, Maynard, Mass.
Copyright (c) 1998 Microsoft.

To anyone who acknowledges that this file is provided "AS IS" without any express or implied warranty: permission to use, copy, modify, and distribute this file for any purpose is hereby granted without fee, provided that the above copyright notices and this notice appears in all source code copies, and that none of the names of Open Software Foundation, Inc., Hewlett-Packard Company, or Digital Equipment Corporation be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. Neither Open Software Foundation, Inc., Hewlett-Packard Company, Microsoft, nor Digital Equipment Corporation makes any representations about the suitability of this software for any purpose.

Constructor Summary

Guid()
Creates a variant #1 style identifier and return the instance.

Method Summary

java.lang.String

toString() Returns the hexidecimal string representation of the Guid.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Guid

public Guid()

Creates a variant #1 style identifier and return the instance. The system executing this factory should have access to a LAN Adapter card for its IEEE 802 address.

The lowest addressed octet contains the global/local bit and the unicast/multicast bit, and is the first octet of the address transmitted on an 802.3 LAN.

The adjusted time stamp is split into three fields, and the clockSeq is split into two fields.

    |<------------------------- 32 bits -------------------------->|
   
    +--------------------------------------------------------------+
    |                     low 32 bits of time                      |  0-3  .time_low
    +-------------------------------+-------------------------------
    |     mid 16 bits of time       |  4-5               .time_mid
    +-------+-----------------------+
    | vers. |   hi 12 bits of time  |  6-7               .time_hi_and_version
    +-------+-------+---------------+
    |Res|  clkSeqHi |  8                                 .clock_seq_hi_and_reserved
    +---------------+
    |   clkSeqLow   |  9                                 .clock_seq_low
    +---------------+----------...-----+
    |            node ID               |  8-16           .node
    +--------------------------...-----+
 

Method Detail

toString

public java.lang.String toString()

Returns the hexidecimal string representation of the Guid.

The toString method will take the binary data in each of the internal components of the Guid, covert each byte to its hexidecimal character equivalent, and return the string.

Each internal component representation, however, is separated by a hyphen character, so the total string length is 36 bytes (16 bytes at 2 hexidecimal characters per byte plus four hyphens). Here is an example:

          012345678901234567890123456789012345
   
          6ba7b814-9dad-11d1-80b4-00c04fd430c8
 

This is the preferred format for visual display, which can include use in

• trace records and diagnostic tools,
• inclusion in print or standard output,
• storage in configuration files and definitions,
• user interface displays (not generally recommended).

Overrides:

toString in class java.lang.Object

Returns:

the hexidecimal string array, which is 36 bytes long.

See Also:

#toByteArray