Package de.uplanet.util

Klasse Guid

java.lang.Object
de.uplanet.util.Guid
@Scriptable public final class Guid extends Object
This class represents global universal IDs.

Instances of this class are immutable.

This class uses the SHAPRNG for secure random numbers and the SHA-1 algorithm for hashing to 20 bytes.

  • Feldübersicht

    Felder
    Modifizierer und Typ
    Feld
    Beschreibung
    static final String
    NULL
    A GUID string representation that contains only zeroes.
    static final Guid
    NULL_GUID
    The GUID that consists solely of zero bytes.
    static final String
    SHA1PRNG
    The algorithm used for generating GUIDs.
    static final int
    STRING_LENGTH
    The length of a GUID represented as a string.

  • Methodenübersicht

    Modifizierer und Typ
    Methode
    Beschreibung
    static String
    checkValid(String p_str)
    Check if the given string is not null and represents a GUID, and throw an IllegalArgumentException if this is not the case.
    static String
    checkValidOrNull(String p_str)
    Check if the given string is null or represents a GUID, and throw an IllegalArgumentException if this is not the case.
    static Guid
    createInstance()
    Creates an instance of GUID using the SHAPRNG algorithm and the current system time.
    static Guid
    createInstance(byte[]... p_randomBytes)
    Creates an instance of GUID using given random bytes.
    boolean
    equals(Object p_obj)
     
    byte[]
    getBytes()
    Get the GUIDs 20 bytes.
    int
    hashCode()
     
    static boolean
    isStringRepresentation(String p_str)
    Tests if the given string is a GUID representation.
    static void
    seed()
    Initialize the random number generator.
    String
    toString()
    Convert the GUID to a string.

    Von Klasse geerbte Methoden java.lang.Object

    getClass, notify, notifyAll, wait, wait, wait

  • Felddetails

    • NULL

      public static final String NULL
      A GUID string representation that contains only zeroes.
      Siehe auch:

    • NULL_GUID

      public static final Guid NULL_GUID
      The GUID that consists solely of zero bytes.

    • SHA1PRNG

      public static final String SHA1PRNG
      The algorithm used for generating GUIDs.
      Siehe auch:

    • STRING_LENGTH

      public static final int STRING_LENGTH
      The length of a GUID represented as a string.
      Siehe auch:

  • Methodendetails

    • seed

      public static void seed()
      Initialize the random number generator.

      This method should be called at most once per Java VM instance.

    • createInstance

      public static Guid createInstance()
      Creates an instance of GUID using the SHAPRNG algorithm and the current system time.
      Gibt zurück:
      An initialized instance of Guid.

    • createInstance

      public static Guid createInstance(byte[]... p_randomBytes)
      Creates an instance of GUID using given random bytes.
      Parameter:
      p_randomBytes - Random bytes that are used to create the GUID.
      Gibt zurück:
      An initialized instance of Guid.

    • getBytes

      public byte[] getBytes()
      Get the GUIDs 20 bytes.
      Gibt zurück:
      A copy of this GUIDs bytes.

    • isStringRepresentation

      public static boolean isStringRepresentation(String p_str)
      Tests if the given string is a GUID representation.
      Parameter:
      p_str - The string to test (may be null).
      Gibt zurück:
      true if the string represents a GUID, or false if the given value is null or does not represent a GUID.

    • checkValidOrNull

      public static String checkValidOrNull(String p_str)
      Check if the given string is null or represents a GUID, and throw an IllegalArgumentException if this is not the case.

      For security reasons possible error messages will contain at most an eight character prefix of the input string.

      Parameter:
      p_str - The string to check.
      Gibt zurück:
      The given string.
      Löst aus:
      IllegalArgumentException - If the given string is not null and does not represent a valid GUID.

    • checkValid

      public static String checkValid(String p_str)
      Check if the given string is not null and represents a GUID, and throw an IllegalArgumentException if this is not the case.

      For security reasons possible error messages will contain at most an eight character prefix of the input string.

      Parameter:
      p_str - The string to check.
      Gibt zurück:
      The given string.
      Löst aus:
      IllegalArgumentException - If the given string is null or does not represent a valid GUID.

    • equals

      public boolean equals(Object p_obj)
      Setzt außer Kraft:
      equals in Klasse Object

    • toString

      public String toString()
      Convert the GUID to a string.
      Setzt außer Kraft:
      toString in Klasse Object
      Gibt zurück:
      The string representation of the GUID.

    • hashCode

      public int hashCode()
      Setzt außer Kraft:
      hashCode in Klasse Object