Module com.aoapps.security

Package com.aoapps.security

Class Identifier

java.lang.Object

com.aoapps.security.Identifier

All Implemented Interfaces:

Serializable, Comparable<Identifier>

public final class Identifier
extends Object
implements Serializable, Comparable<Identifier>

A 128-bit random identifier internally stored as two long values.

Author:

AO Industries, Inc.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
Identifier()	Creates a new, random Identifier using a default SecureRandom instance, which is not a strong instance to avoid blocking.
Identifier(long hi, long lo)
Identifier(String encoded)
Identifier(SecureRandom secureRandom)	Creates a new, random Identifier using the provided SecureRandom source.
Identifier(Random random)	Deprecated. Please use SecureRandom.

Method Summary

Modifier and Type	Method	Description
int	compareTo(Identifier other)	Unsigned ordering.
boolean	equals(Identifier other)	Performs comparisons in length-constant time.
boolean	equals(Object obj)
long	getHi()
long	getLo()
int	hashCode()
static void	main(String[] args)
char[]	toCharArray()	The external representation is a string of characters encoded in base #BASE, with the first #NUM_CHARACTERS characters for "hi" and the last #NUM_CHARACTERS characters for "lo".
String	toString()	The external representation is a string of characters encoded in base #BASE, with the first #NUM_CHARACTERS characters for "hi" and the last #NUM_CHARACTERS characters for "lo".
static Identifier	valueOf(String encoded)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

Identifier

public Identifier()

Creates a new, random Identifier using a default SecureRandom instance, which is not a strong instance to avoid blocking.

Identifier

@Deprecated(forRemoval=false)
public Identifier(Random random)

Deprecated.

Please use SecureRandom. This method will stay, but will remain deprecated since it should only be used after careful consideration.

Creates a new, random Identifier using the provided Random source.

Identifier

public Identifier(SecureRandom secureRandom)

Creates a new, random Identifier using the provided SecureRandom source.

Identifier

public Identifier(long hi,
 long lo)

Identifier

public Identifier(String encoded)
           throws IllegalArgumentException

Throws:

IllegalArgumentException

See Also:

• toString()

Method Details

valueOf

public static Identifier valueOf(String encoded)
                          throws IllegalArgumentException

Throws:

IllegalArgumentException

See Also:

• toString()

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

equals

public boolean equals(Identifier other)

Performs comparisons in length-constant time. https://crackstation.net/hashing-security.htm

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toCharArray

public char[] toCharArray()

The external representation is a string of characters encoded in base #BASE, with the first #NUM_CHARACTERS characters for "hi" and the last #NUM_CHARACTERS characters for "lo".

toString

public String toString()

The external representation is a string of characters encoded in base #BASE, with the first #NUM_CHARACTERS characters for "hi" and the last #NUM_CHARACTERS characters for "lo".

Overrides:

toString in class Object

compareTo

public int compareTo(Identifier other)

Unsigned ordering.

Specified by:

compareTo in interface Comparable<Identifier>

getHi

public long getHi()

getLo

public long getLo()

main

public static void main(String[] args)