Beispiel #1
0
 /**
  * Attempt to convert the specified string to the appropriate ObjectID instance.
  *
  * @param value the stringified id with the protocol and ObjectID.DELIMITER already removed, and
  *     which is never null or zero length
  * @return the ObjectID instance for the stringified ID if this factory is able to parse the
  *     string, or null if the factory is unaware of the specified format.
  */
 public static ObjectID stringToObject(String value) throws InvalidIDException {
   try {
     return new UUID(java.util.UUID.fromString(value));
   } catch (IllegalArgumentException e) {
     throw new InvalidIDException(
         CoreModelerPlugin.Util.getString(
             "UUID.InvalidFormatForProtocol", value, PROTOCOL)); // $NON-NLS-1$
   }
 }
Beispiel #2
0
/**
 * This class represents a universally unique identifier, consisting of two long integral values.
 *
 * <p>This identifier is supposed to be unique both spatially and temporally. It is based on version
 * 4 IETF variant random UUIDs.
 *
 * @since 8.0
 */
public class UUID implements ObjectID, Serializable {

  private static final String NOT_UUID_MESSAGE =
      CoreModelerPlugin.Util.getString("UUID.ID_must_be_of_type_UUID_1"); // $NON-NLS-1$
  private static final String UNPARSABLE_MESSAGE =
      CoreModelerPlugin.Util.getString("UUID.ID_must_be_of_type_UUID_to_parse_2"); // $NON-NLS-1$
  /** The variants allowed by the UUID specification. */
  class Variant {
    public static final int NSC_COMPATIBLE = 0;
    public static final int STANDARD = 2;
    public static final int MICROSOFT = 6;
    public static final int RESERVED_FUTURE = 7;
  }

  class Version {
    public static final int TIME_BASED = 1;
    public static final int DCE_RESERVED = 2;
    public static final int NAME_BASED = 3;
    public static final int PSEUDO_RANDOM = 4;
  }

  public static final String PROTOCOL = "mmuuid"; // $NON-NLS-1$
  public static final String PROTOCOL_UCASE = PROTOCOL.toUpperCase();
  private static final int ID_STRING_LEN = 36;
  public static final int FQ_LENGTH = PROTOCOL.length() + 1 + ID_STRING_LEN;

  private final java.util.UUID uuid;
  private String cachedExportableFormUuidString;

  /**
   * Construct an instance of this class from two long integral values. Both values must be
   * non-negative.
   *
   * @throws IllegalArgumentException if either value is negative
   */
  public UUID(long mostSig, long leastSig) {
    this.uuid = new java.util.UUID(mostSig, leastSig);
  }

  public UUID(java.util.UUID uuid) {
    this.uuid = uuid;
  }

  /**
   * Return the first part of the UUID as a long.
   *
   * @return first part of the UUID as a long
   */
  public static long getPart1(ObjectID id) {
    CoreArgCheck.isInstanceOf(UUID.class, id, UNPARSABLE_MESSAGE);

    UUID uuid = (UUID) id;
    return uuid.uuid.getMostSignificantBits();
  }

  /**
   * Return the first part of the UUID as a long.
   *
   * @return first part of the UUID as a long
   */
  public static long getPart2(ObjectID id) {
    CoreArgCheck.isInstanceOf(UUID.class, id, UNPARSABLE_MESSAGE);

    UUID uuid = (UUID) id;
    return uuid.uuid.getLeastSignificantBits();
  }

  public static int getVariant(ObjectID id) {
    CoreArgCheck.isInstanceOf(UUID.class, id, NOT_UUID_MESSAGE);

    UUID uuid = (UUID) id;
    return uuid.uuid.variant();
  }

  public static int getVersion(ObjectID id) {
    CoreArgCheck.isInstanceOf(UUID.class, id, NOT_UUID_MESSAGE);

    UUID uuid = (UUID) id;
    return uuid.uuid.version();
  }

  /**
   * Return the name of the protocol that this factory uses.
   *
   * @return the protocol name
   */
  @Override
  public String getProtocol() {
    return PROTOCOL;
  }

  /**
   * Returns the hashcode for this instance. All of the bits in each 32-bit part of the longs are
   * exclusively 'or'd together to yield the hashcode.
   */
  @Override
  public int hashCode() {
    return uuid.hashCode();
  }

  /**
   * Returns true if the specified object is semantically equal to this instance. Note: this method
   * is consistent with <code>compareTo()
   * </code>.
   *
   * <p>UUID instances are equal if they represent the same 128-bit value.
   *
   * @param obj the object that this instance is to be compared to.
   * @return whether the object is equal to this object.
   */
  @Override
  public boolean equals(Object obj) {
    // Check if instances are identical ...
    if (this == obj) {
      return true;
    }

    // Check if object can be compared to this one
    // (this includes checking for null ) ...
    if (obj instanceof UUID) {
      UUID that = (UUID) obj;
      return this.uuid.equals(that.uuid);
    }

    // Otherwise not comparable ...
    return false;
  }

  /**
   * Compares this object to another. If the specified object is not an instance of the LongID
   * class, then this method throws a ClassCastException (as instances are comparable only to
   * instances of the same class).
   *
   * <p>Note: this method <i>is</i> consistent with <code>equals()</code>, meaning that <code>
   * (compare(x, y)==0) == (x.equals(y))</code>.
   *
   * @param obj the object that this instance is to be compared to; may not be null.
   * @return a negative integer, zero, or a positive integer as this object is less than, equal to,
   *     or greater than the specified object, respectively.
   * @throws ClassCastException if the specified object's type prevents it from being compared to
   *     this instance.
   */
  @Override
  public int compareTo(Object obj) {
    UUID that = (UUID) obj; // May throw ClassCastException
    return this.uuid.compareTo(that.uuid);
  }

  /**
   * Returns a string representing the current state of the object.
   *
   * @return the string representation of this instance.
   */
  @Override
  public String toString() {
    return toString(ObjectID.DELIMITER);
  }

  /** @see org.teiid.core.designer.id.ObjectID#toString(char) */
  @Override
  public String toString(char delim) {
    return new StringBuffer(43)
        .append(PROTOCOL)
        .append(delim)
        .append(this.exportableForm())
        .toString();
  }

  /**
   * Returns a 36-character string of six fields separated by hyphens, with each field represented
   * in lowercase hexadecimal with the same number of digits as in the field. The order of fields
   * is: time_low, time_mid, version and time_hi treated as a single field, variant and clock_seq
   * treated as a single field, and node.
   *
   * @return A string of the form 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx', where all the characters
   *     are lowercase hexadecimal digits
   */
  public String exportableForm() {
    if (this.cachedExportableFormUuidString == null) {
      this.cachedExportableFormUuidString = this.uuid.toString();
    }
    return this.cachedExportableFormUuidString;
  }

  /**
   * Attempt to convert the specified string to the appropriate ObjectID instance.
   *
   * @param value the stringified id with the protocol and ObjectID.DELIMITER already removed, and
   *     which is never null or zero length
   * @return the ObjectID instance for the stringified ID if this factory is able to parse the
   *     string, or null if the factory is unaware of the specified format.
   */
  public static ObjectID stringToObject(String value) throws InvalidIDException {
    try {
      return new UUID(java.util.UUID.fromString(value));
    } catch (IllegalArgumentException e) {
      throw new InvalidIDException(
          CoreModelerPlugin.Util.getString(
              "UUID.InvalidFormatForProtocol", value, PROTOCOL)); // $NON-NLS-1$
    }
  }
}