Class AlgorithmIdentity

java.lang.Object

zeroecho.core.spec.AlgorithmIdentity

public final class AlgorithmIdentity
extends Object

Provider-independent identity of one exact cryptographic operation or key type.

An identity contains no provider, implementation class, key material, or X.509 representation. Families are namespaced so trusted installed extensions can add typed parameter models without modifying a central enum. The parameter object is responsible for family-specific validation and a deterministic canonical component.

Instances are immutable. Equality and hashing use the complete canonical semantics, including the role, family, and parameters.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	AlgorithmIdentity.DigestParameters	Digest-qualified signature parameters.
static final record	AlgorithmIdentity.Family	Stable namespaced algorithm family name.
static enum	AlgorithmIdentity.Kind	Semantic role represented by an identity.
static final record	AlgorithmIdentity.NamedParameters	Exact named parameter set, such as an elliptic-curve name.
static enum	AlgorithmIdentity.NoParameters	Parameters for an unparameterized family.
static interface	AlgorithmIdentity.Parameters	Typed, immutable family parameters.
static final record	AlgorithmIdentity.RsaPssParameters	Exact RSA-PSS parameters.

Constructor Summary

Constructors

Constructor	Description
AlgorithmIdentity(AlgorithmIdentity.Kind kind, AlgorithmIdentity.Family family, AlgorithmIdentity.Parameters parameters)	Creates one exact algorithm identity.
AlgorithmIdentity(AlgorithmIdentity.Kind kind, AlgorithmIdentity.Family family, AlgorithmIdentity.Parameters parameters, AlgorithmIdentityCodec codec)	Creates one exact algorithm identity using a trusted typed codec.

Method Summary

Modifier and Type	Method	Description
String	canonicalForm()	Returns the deterministic provider-independent representation.
boolean	equals(Object other)
AlgorithmIdentity.Family	family()	Returns the stable family.
int	hashCode()
AlgorithmIdentity.Kind	kind()	Returns the semantic identity kind.
AlgorithmIdentity.Parameters	parameters()	Returns the immutable typed parameters.
static AlgorithmIdentity	parse(String canonicalForm, Collection<AlgorithmIdentityCodec> codecs)	Parses a complete version-two canonical identity with installed codecs.
String	toString()

Methods inherited from class Object

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

Constructor Details

AlgorithmIdentity

public AlgorithmIdentity(AlgorithmIdentity.Kind kind,
 AlgorithmIdentity.Family family,
 AlgorithmIdentity.Parameters parameters)

Creates one exact algorithm identity.

Parameters:

kind - semantic role

family - stable namespaced family

parameters - validated typed parameters

Throws:

NullPointerException - if an argument is null

IllegalArgumentException - if the parameter canonical form is not deterministic syntax

AlgorithmIdentity

public AlgorithmIdentity(AlgorithmIdentity.Kind kind,
 AlgorithmIdentity.Family family,
 AlgorithmIdentity.Parameters parameters,
 AlgorithmIdentityCodec codec)

Creates one exact algorithm identity using a trusted typed codec.

Parameters:

kind - semantic role

family - stable namespaced family

parameters - validated typed parameters

codec - immutable canonical parameter codec

Method Details

kind

public AlgorithmIdentity.Kind kind()

Returns the semantic identity kind.

Returns:

identity kind

family

public AlgorithmIdentity.Family family()

Returns the stable family.

Returns:

namespaced family

parameters

public AlgorithmIdentity.Parameters parameters()

Returns the immutable typed parameters.

Returns:

family parameters

parse

public static AlgorithmIdentity parse(String canonicalForm,
 Collection<AlgorithmIdentityCodec> codecs)

Parses a complete version-two canonical identity with installed codecs.

Parameters:

canonicalForm - canonical identity

codecs - trusted installed codecs

Returns:

exact decoded identity

Throws:

IllegalArgumentException - if syntax, version, codec, or canonical round-trip validation fails

canonicalForm

public String canonicalForm()

Returns the deterministic provider-independent representation.

Returns:

complete canonical identity

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object