org.apache.gobblin.util.guid

Class Guid

java.lang.Object

org.apache.gobblin.util.guid.Guid

public class Guid
extends Object

Class wrapping a byte array representing a guid. A Guid is intended to uniquely identify objects in a replicable way.

Field Summary

Fields

Modifier and Type	Field and Description
static int	GUID_LENGTH

Constructor Summary

Constructors

Constructor and Description
Guid(byte[] bytes) Creates a Guid by computing the sha of the input bytes.

Method Summary

Modifier and Type	Method and Description
Guid	append(byte[]... byteArrays) Creates a new Guid which is a unique, replicable representation of the pair (this, byteArrays).
Guid	append(Guid... guids) Creates a new Guid which is a unique, replicable representation of the pair (this, guids).
Guid	append(HasGuid... objs) Creates a new Guid which is a unique, replicable representation of the pair (this, objs).
static Guid	combine(Guid... guids) Combine multiple Guids into a single Guid.
static Guid	deserialize(String str) Reverse of toString().
static Guid	fromByteArrays(byte[]... byteArrays) Generate a Guid for an array of byte arrays.
static Guid	fromHasGuid(HasGuid... objs) Generate a Guid for an array of HasGuid.
static Guid	fromStrings(String... strings) Generate a Guid for an array of Strings.
String	toString() Serializes the guid into a hex string.

Methods inherited from class java.lang.Object

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

Field Detail

GUID_LENGTH

public static final int GUID_LENGTH

See Also:

Constant Field Values

Constructor Detail

Guid

public Guid(byte[] bytes)

Creates a Guid by computing the sha of the input bytes.

Method Detail

fromHasGuid

public static Guid fromHasGuid(HasGuid... objs)
                        throws IOException

Generate a Guid for an array of HasGuid.

Parameters:

objs - array of HasGuid.

Returns:

a single Guid for the array.

Throws:

IOException

fromStrings

public static Guid fromStrings(String... strings)
                        throws IOException

Generate a Guid for an array of Strings.

Parameters:

strings - array of Strings.

Returns:

a single Guid for the array.

Throws:

IOException

fromByteArrays

public static Guid fromByteArrays(byte[]... byteArrays)
                           throws IOException

Generate a Guid for an array of byte arrays.

Parameters:

byteArrays - array of byte arrays.

Returns:

a single Guid for the array.

Throws:

IOException

deserialize

public static Guid deserialize(String str)
                        throws IOException

Reverse of toString(). Deserializes a Guid from a previously serialized one.

Parameters:

str - Serialized Guid.

Returns:

deserialized Guid.

Throws:

IOException

combine

public static Guid combine(Guid... guids)
                    throws IOException

Combine multiple Guids into a single Guid.

Throws:

IOException

append

public Guid append(byte[]... byteArrays)
            throws IOException

Creates a new Guid which is a unique, replicable representation of the pair (this, byteArrays).

Parameters:

byteArrays - an array of byte arrays.

Returns:

a new Guid.

Throws:

IOException

append

public Guid append(Guid... guids)
            throws IOException

Creates a new Guid which is a unique, replicable representation of the pair (this, guids). Equivalent to combine(this, guid1, guid2, ...)

Parameters:

guids - an array of Guid.

Returns:

a new Guid.

Throws:

IOException

append

public Guid append(HasGuid... objs)
            throws IOException

Creates a new Guid which is a unique, replicable representation of the pair (this, objs).

Parameters:

objs - an array of HasGuid.

Returns:

a new Guid.

Throws:

IOException

toString

public String toString()

Serializes the guid into a hex string. The original Guid can be recovered using deserialize(java.lang.String).

Overrides:

toString in class Object