Module dev.orne.beans

Package dev.orne.beans

Class AbstractComposedIdentity

java.lang.Object

dev.orne.beans.AbstractIdentity

dev.orne.beans.AbstractComposedIdentity

All Implemented Interfaces:

Identity, Serializable

@API(status=MAINTAINED,
     since="0.5")
public abstract class AbstractComposedIdentity
extends AbstractIdentity

Abstract implementation for Identity for identities composed of a multiple inner values.

Since:

0.5

Version:

1.0, 2023-05

Author:

(w) Iker Hernaez

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DEFAULT_NULL_PLACEHOLDER	The default placeholder for null identity token parts.
static final String	DEFAULT_SEPARATOR	Default identity token body parts separator.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractComposedIdentity()	Creates a new instance.

Method Summary

Modifier and Type	Method	Description
static String[]	extractRequiredTokenBodyParts(String prefix, String token, int expectedParts)	Extracts the body parts of a token generated by AbstractComposedIdentity.
static String[]	extractRequiredTokenBodyParts(String prefix, String token, String separator, int expectedParts)	Extracts the body parts of a token generated by AbstractComposedIdentity.
static String[]	extractRequiredTokenBodyParts(String prefix, String token, String separator, String placeholder, int expectedParts)	Extracts the body parts of a token generated by AbstractComposedIdentity.
static String[]	extractTokenBodyParts(String prefix, String token)	Extracts the String value of a token generated by StringIdentity.
static String[]	extractTokenBodyParts(String prefix, String token, String separator)	Extracts the String value of a token generated by StringIdentity.
static String[]	extractTokenBodyParts(String prefix, String token, String separator, String placeholder)	Extracts the String value of a token generated by StringIdentity.
protected @Nullable String	getIdentityTokenBody()	Returns the identity token body composed from the values of this identity.
protected abstract String[]	getIdentityTokenBodyParts()	Returns the identity token body composed from the values of this identity.
protected String	getIdentityTokenBodyPartsNullPlaceholder()	Return the placeholder for null identity token parts.
protected String	getIdentityTokenBodyPartsSeparator()	Return the identity token body parts separator.

Methods inherited from class dev.orne.beans.AbstractIdentity

equals, getIdentityToken, getIdentityTokenPrefix, hashCode, parseIdentityTokenBody, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface dev.orne.beans.Identity

resolve

Field Details

DEFAULT_SEPARATOR

public static final String DEFAULT_SEPARATOR

Default identity token body parts separator.

See Also:

• Constant Field Values

DEFAULT_NULL_PLACEHOLDER

public static final String DEFAULT_NULL_PLACEHOLDER

The default placeholder for null identity token parts.

See Also:

• Constant Field Values

Constructor Details

AbstractComposedIdentity

protected AbstractComposedIdentity()

Creates a new instance.

Method Details

getIdentityTokenBody

protected @Nullable String getIdentityTokenBody()

Returns the identity token body composed from the values of this identity. Equal instances must return equal identity token body.

Specified by:

getIdentityTokenBody in class AbstractIdentity

Returns:

The identity token body for this instance

getIdentityTokenBodyParts

protected abstract String[] getIdentityTokenBodyParts()

Returns the identity token body composed from the values of this identity. Equal instances must return equal identity token body.

Returns:

The identity token body for this instance

getIdentityTokenBodyPartsSeparator

protected String getIdentityTokenBodyPartsSeparator()

Return the identity token body parts separator. Must return same value for instances of the same class.

Returns:

The identity token body parts separator.

getIdentityTokenBodyPartsNullPlaceholder

protected String getIdentityTokenBodyPartsNullPlaceholder()

Return the placeholder for null identity token parts. Must return same value for instances of the same class.

Returns:

The placeholder for null identity token parts.

extractTokenBodyParts

public static String[] extractTokenBodyParts(String prefix,
 String token)

Extracts the String value of a token generated by StringIdentity.

Parameters:

prefix - The expected identity token prefix.

token - The identity token.

Returns:

The extracted identity token body parts.

Throws:

NullPointerException - If any argument is null

UnrecognizedIdentityTokenException - If the identity token is not a valid simple identity token or if it doesn't start with the expected prefix.

See Also:

• extractTokenBodyParts(String, String, String, String)

extractTokenBodyParts

public static String[] extractTokenBodyParts(String prefix,
 String token,
 String separator)

Extracts the String value of a token generated by StringIdentity.

Parameters:

prefix - The expected identity token prefix.

token - The identity token.

separator - The identity token body parts separator.

Returns:

The extracted identity token body parts.

Throws:

NullPointerException - If any argument is null

UnrecognizedIdentityTokenException - If the identity token is not a valid simple identity token or if it doesn't start with the expected prefix.

See Also:

• extractTokenBodyParts(String, String, String, String)

extractTokenBodyParts

public static String[] extractTokenBodyParts(String prefix,
 String token,
 String separator,
 String placeholder)

Extracts the String value of a token generated by StringIdentity.

Parameters:

prefix - The expected identity token prefix.

token - The identity token.

separator - The identity token body parts separator.

placeholder - The null identity token body part placeholder.

Returns:

The extracted identity token body parts.

Throws:

NullPointerException - If any argument is null

UnrecognizedIdentityTokenException - If the identity token is not a valid simple identity token or if it doesn't start with the expected prefix.

extractRequiredTokenBodyParts

public static String[] extractRequiredTokenBodyParts(String prefix,
 String token,
 int expectedParts)

Extracts the body parts of a token generated by AbstractComposedIdentity.

If the resulting value is null or the body parts count is not the expected one an exception is thrown.

Parameters:

prefix - The expected identity token prefix.

token - The identity token.

expectedParts - The expected identity token body parts count.

Returns:

The extracted identity token body parts.

Throws:

NullPointerException - If any argument is null

UnrecognizedIdentityTokenException - If the identity token is not a valid identity token, if it doesn't start with the expected prefix, if the extracted body is null or the extracted body parts count does not match the expected parts count.

See Also:

• extractTokenBodyParts(String, String)

extractRequiredTokenBodyParts

public static String[] extractRequiredTokenBodyParts(String prefix,
 String token,
 String separator,
 int expectedParts)

Extracts the body parts of a token generated by AbstractComposedIdentity.

If the resulting value is null or the body parts count is not the expected one an exception is thrown.

Parameters:

prefix - The expected identity token prefix.

token - The identity token.

separator - The identity token body parts separator.

expectedParts - The expected identity token body parts count.

Returns:

The extracted identity token body parts.

Throws:

NullPointerException - If any argument is null

UnrecognizedIdentityTokenException - If the identity token is not a valid identity token, if it doesn't start with the expected prefix, if the extracted body is null or the extracted body parts count does not match the expected parts count.

See Also:

• extractTokenBodyParts(String, String, String)

extractRequiredTokenBodyParts

public static String[] extractRequiredTokenBodyParts(String prefix,
 String token,
 String separator,
 String placeholder,
 int expectedParts)

Extracts the body parts of a token generated by AbstractComposedIdentity.

If the resulting value is null or the body parts count is not the expected one an exception is thrown.

Parameters:

prefix - The expected identity token prefix.

token - The identity token.

separator - The identity token body parts separator.

placeholder - The null identity token body part placeholder.

expectedParts - The expected identity token body parts count.

Returns:

The extracted identity token body parts.

Throws:

NullPointerException - If any argument is null

UnrecognizedIdentityTokenException - If the identity token is not a valid identity token, if it doesn't start with the expected prefix, if the extracted body is null or the extracted body parts count does not match the expected parts count.

See Also:

• extractTokenBodyParts(String, String, String)