flex.messaging.util

Class UUIDUtils

java.lang.Object

flex.messaging.util.UUIDUtils

public class UUIDUtils
extends Object

Method Summary

Methods

Modifier and Type	Method and Description
static String	createUUID() Use the createUUID function when you need a unique string that you will use as a persistent identifier in a distributed environment.
static String	createUUID(boolean secure)
static String	fromByteArray(byte[] ba) Converts a 128-bit UID encoded as a byte[] to a String representation.
static boolean	isUID(String uid) A utility method to check whether a String value represents a correctly formatted UID value.
static byte[]	toByteArray(String uid) Converts a UID formatted String to a byte[].

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createUUID

public static String createUUID()

Use the createUUID function when you need a unique string that you will use as a persistent identifier in a distributed environment. To a very high degree of certainty, this function returns a unique value; no other invocation on the same or any other system should return the same value.

Returns:

a Universally Unique Identifier (UUID) Proper Format: `XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' where `X' stands for a hexadecimal digit (0-9 or A-F).

createUUID

public static String createUUID(boolean secure)
                         throws Error

Throws:

Error

fromByteArray

public static String fromByteArray(byte[] ba)

Converts a 128-bit UID encoded as a byte[] to a String representation. The format matches that generated by createUID. If a suitable byte[] is not provided, null is returned.

Parameters:

ba - byte[] 16 bytes in length representing a 128-bit UID.

Returns:

String representation of the UID, or null if an invalid byte[] is provided.

isUID

public static boolean isUID(String uid)

A utility method to check whether a String value represents a correctly formatted UID value. UID values are expected to be in the format generated by createUID(), implying that only capitalized A-F characters in addition to 0-9 digits are supported.

Parameters:

uid - The value to test whether it is formatted as a UID.

Returns:

Returns true if the value is formatted as a UID.

toByteArray

public static byte[] toByteArray(String uid)

Converts a UID formatted String to a byte[]. The UID must be in the format generated by createUID, otherwise null is returned.

Parameters:

uid - String representing a 128-bit UID.

Returns:

byte[] 16 bytes in length representing the 128-bits of the UID or null if the uid could not be converted.