Package com.exedio.cope.pattern

Class Hash

java.lang.Object

com.exedio.cope.Feature

com.exedio.cope.Pattern

com.exedio.cope.pattern.Hash

All Implemented Interfaces:

HashInterface, Settable<String>, Serializable

Direct Known Subclasses:

MD5Hash, MessageDigestHash, SHAHash

public class Hash
extends Pattern
implements HashInterface

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	Hash.Algorithm
static final class	Hash.InvalidPlainTextException	A plain text is either too short, too long or doesn't match the format requirement
static class	Hash.PlainTextValidator	Validate plain text for potential limits, to be specified in sub classes

Constructor Summary

Constructors

Constructor	Description
Hash(Hash.Algorithm algorithm)
Hash(Hash.Algorithm algorithm, String encoding)	Deprecated. Use Hash(Algorithm, Charset) instead
Hash(Hash.Algorithm algorithm, Charset charset)
Hash(HashAlgorithm algorithm)
Hash(StringField storage, Hash.Algorithm algorithm)
Hash(StringField storage, Hash.Algorithm algorithm, String encoding)	Deprecated. Use Hash(StringField, Algorithm, Charset) instead
Hash(StringField storage, Hash.Algorithm algorithm, Charset charset)
Hash(StringField storage, HashAlgorithm algorithm)

Method Summary

Modifier and Type	Method	Description
final void	blind(Class<? extends Item> parentClass, String actualPlainText)	Deprecated. Use blind(String) instead.
final void	blind(String actualPlainText)	Wastes (almost) as much cpu cycles, as a call to check(Item, String) would have needed.
final boolean	check(Item item, String actualPlainText)
final void	checkPlainText(String plainText)
final SetValue<?>[]	execute(String value, Item exceptionItem)
final Hash.Algorithm	getAlgorithm()	Deprecated. Use getAlgorithm2() instead.
final HashAlgorithm	getAlgorithm2()
final String	getAlgorithmID()
final String	getAlgorithmName()	Deprecated. Use getAlgorithmID() instead
final String	getEncoding()	Deprecated. Throws exception if not initialized via Hash.Algorithm.
final String	getHash(Item item)
final Set<Class<? extends Throwable>>	getInitialExceptions()	Returns the exceptions possibly thrown, when setting a value for this settable.
final Class<?>	getInitialType()
final int	getPlainTextLimit()
final Hash.PlainTextValidator	getPlainTextValidator()
final StringField	getStorage()
final String	hash(String plainText)
final boolean	isFinal()	Returns true, if a value for the settable can be specified on the creation of an item only, thus cannot be modified later.
final boolean	isInitial()	Returns true, if a value for the settable should be specified on the creation of an item.
final boolean	isMandatory()
final Condition	isNotNull()
final Condition	isNotNull(Join join)
final Condition	isNull()
final boolean	isNull(Item item)
final Condition	isNull(Join join)
final Hash	limit(int plainTextLimit)	Creates a new hash with a new plain text limit.
final String	newRandomPassword(SecureRandom random)
final Hash	optional()
final void	set(Item item, String plainText)
final void	setHash(Item item, String hash)
final Hash	toFinal()
final Hash	validate(Hash.PlainTextValidator validator)

Methods inherited from class com.exedio.cope.Pattern

addSource, addSource, addSource, addSource, addSourceFeature, addSourceFeature, addSourceFeature, annotationField, equals, getGeneratedTypes, getSourceFeatures, getSourceFeaturesGather, getSourceFields, getSources, getSourceTypes, getType, hashCode, initialize, newSourceType, newSourceType, newSourceType, newSourceType, newSourceType, newSourceType, newType, newType, onMount, registerSource

Methods inherited from class com.exedio.cope.Feature

afterModelCreated, getAbstractType, getAnnotation, getID, getLocalizationKeys, getName, getPattern, isAnnotationPresent, isSourceAlready, mount, readResolve, requireMounted, toString, toString, writeReplace

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.exedio.cope.Settable

map

Constructor Details

Hash

public Hash(StringField storage,
 Hash.Algorithm algorithm,
 Charset charset)

Hash

public Hash(StringField storage,
 Hash.Algorithm algorithm)

Hash

public Hash(Hash.Algorithm algorithm,
 Charset charset)

Hash

public Hash(Hash.Algorithm algorithm)

Hash

public Hash(HashAlgorithm algorithm)

Hash

public Hash(StringField storage,
 HashAlgorithm algorithm)

Hash

@Deprecated
public Hash(StringField storage,
 Hash.Algorithm algorithm,
 String encoding)

Deprecated.

Use Hash(StringField, Algorithm, Charset) instead

Hash

@Deprecated
public Hash(Hash.Algorithm algorithm,
 String encoding)

Deprecated.

Use Hash(Algorithm, Charset) instead

Method Details

getStorage

public final StringField getStorage()

getPlainTextLimit

public final int getPlainTextLimit()

See Also:

• limit(int)

getAlgorithm2

public final HashAlgorithm getAlgorithm2()

getAlgorithmID

public final String getAlgorithmID()

getEncoding

@Deprecated
public final String getEncoding()

Deprecated.

Throws exception if not initialized via Hash.Algorithm.

getPlainTextValidator

public final Hash.PlainTextValidator getPlainTextValidator()

See Also:

• validate(PlainTextValidator)

isInitial

public final boolean isInitial()

Description copied from interface: Settable

Returns true, if a value for the settable should be specified on the creation of an item.

Specified by:

isInitial in interface Settable<String>

isFinal

public final boolean isFinal()

Description copied from interface: Settable

Returns true, if a value for the settable can be specified on the creation of an item only, thus cannot be modified later.

Specified by:

isFinal in interface Settable<String>

isMandatory

public final boolean isMandatory()

Specified by:

isMandatory in interface Settable<String>

getInitialType

public final Class<?> getInitialType()

Specified by:

getInitialType in interface Settable<String>

getInitialExceptions

public final Set<Class<? extends Throwable>> getInitialExceptions()

Description copied from interface: Settable

Returns the exceptions possibly thrown, when setting a value for this settable.

Specified by:

getInitialExceptions in interface Settable<String>

toFinal

public final Hash toFinal()

optional

public final Hash optional()

limit

public final Hash limit(int plainTextLimit)

Creates a new hash with a new plain text limit. The default is 150. Setting hashes longer than the limit will cause an Hash.InvalidPlainTextException. Checking for hashes longer than the limit will silently return false. This is a precaution against DOS attacks with very long plain texts.

See Also:

• getPlainTextLimit()

validate

public final Hash validate(Hash.PlainTextValidator validator)

See Also:

• getPlainTextValidator()

set

public final void set(@Nonnull
 Item item,
 String plainText)

Specified by:

set in interface HashInterface

check

public final boolean check(@Nonnull
 Item item,
 @Nullable
 String actualPlainText)

Specified by:

check in interface HashInterface

isNull

public final boolean isNull(@Nonnull
 Item item)

Specified by:

isNull in interface HashInterface

blind

public final void blind(@Nullable
 String actualPlainText)

Wastes (almost) as much cpu cycles, as a call to check(Item, String) would have needed. Needed to prevent Timing Attacks. See https://en.wikipedia.org/wiki/Timing_attack

Specified by:

blind in interface HashInterface

execute

public final SetValue<?>[] execute(String value,
 Item exceptionItem)
                            throws Hash.InvalidPlainTextException

Specified by:

execute in interface Settable<String>

Throws:

Hash.InvalidPlainTextException

getHash

public final String getHash(@Nonnull
 Item item)

Specified by:

getHash in interface HashInterface

setHash

public final void setHash(@Nonnull
 Item item,
 String hash)

hash

public final String hash(String plainText)

checkPlainText

public final void checkPlainText(String plainText)

isNull

public final Condition isNull()

isNull

public final Condition isNull(Join join)

isNotNull

public final Condition isNotNull()

isNotNull

public final Condition isNotNull(Join join)

newRandomPassword

public final String newRandomPassword(SecureRandom random)

Specified by:

newRandomPassword in interface HashInterface

getAlgorithmName

@Deprecated
public final String getAlgorithmName()

Deprecated.

Use getAlgorithmID() instead

getAlgorithm

@Deprecated
public final Hash.Algorithm getAlgorithm()

Deprecated.

Use getAlgorithm2() instead. Throws exception if not initialized via Hash.Algorithm.

blind

@Deprecated
public final void blind(Class<? extends Item> parentClass,
 String actualPlainText)

Deprecated.

Use blind(String) instead.