Class OperationDescriptorCatalog

java.lang.Object

zeroecho.pki.server.schema.OperationDescriptorCatalog

public final class OperationDescriptorCatalog
extends Object

Immutable, validated authority for static operation projections. Execution authorization, resource binding and dynamic approvals remain in the gateway. Assembly costs O(N log N + F) time and O(N + F) retained space for N operations and F fields.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	OperationDescriptorCatalog.Entry	One fully validated operation projection.
static final record	OperationDescriptorCatalog.FieldSemantics	Request-affecting field refinements and optional display hints.
static final record	OperationDescriptorCatalog.Presentation	Presentation joined to a canonical operation.
static final record	OperationDescriptorCatalog.TransportSemantics	Request-envelope and field semantics.

Constructor Summary

Constructors

Constructor	Description
OperationDescriptorCatalog(List<OperationSecurityDescriptors.Descriptor> security, List<OperationParameterSchemas.Parameters> parameters, List<OperationDescriptorCatalog.Presentation> presentation)	Assembles an exact join, rejecting missing, duplicate and unknown definitions.

Method Summary

Modifier and Type	Method	Description
static OperationDescriptorCatalog	current()	Returns the lazily assembled current catalog.
List<OperationDescriptorCatalog.Entry>	entries()	Returns every operation, including unavailable identities, in lexical order.
Optional<OperationDescriptorCatalog.Entry>	find(String operationId)	Looks up a canonical identity without filling custom registries.
List<OperationParameterSchema.OperationSpec>	parameterSchemas()	Returns unchanged four-component parameter-record projections.
OperationDescriptorCatalog.Entry	require(String operationId)	Requires a known canonical identity.
List<OperationSecurityDescriptors.Descriptor>	securityDescriptors()	Returns unchanged security-record projections.

Methods inherited from class Object

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

Constructor Details

OperationDescriptorCatalog

public OperationDescriptorCatalog(List<OperationSecurityDescriptors.Descriptor> security,
 List<OperationParameterSchemas.Parameters> parameters,
 List<OperationDescriptorCatalog.Presentation> presentation)

Assembles an exact join, rejecting missing, duplicate and unknown definitions. Security definitions supply the canonical typed-operation identities.

Parameters:

security - typed identity and security definitions

parameters - parameter definitions without duplicated permissions

presentation - presentation definitions

Throws:

IllegalArgumentException - if coverage or field semantics disagree

Method Details

current

public static OperationDescriptorCatalog current()

Returns the lazily assembled current catalog.

Returns:

immutable singleton

entries

public List<OperationDescriptorCatalog.Entry> entries()

Returns every operation, including unavailable identities, in lexical order.

Returns:

immutable ordered entries

find

public Optional<OperationDescriptorCatalog.Entry> find(String operationId)

Looks up a canonical identity without filling custom registries.

Parameters:

operationId - exact identity

Returns:

matching entry, or empty

require

public OperationDescriptorCatalog.Entry require(String operationId)

Requires a known canonical identity.

Parameters:

operationId - exact identity

Returns:

immutable entry

Throws:

IllegalArgumentException - if unknown

securityDescriptors

public List<OperationSecurityDescriptors.Descriptor> securityDescriptors()

Returns unchanged security-record projections.

Returns:

immutable security list

parameterSchemas

public List<OperationParameterSchema.OperationSpec> parameterSchemas()

Returns unchanged four-component parameter-record projections.

Returns:

immutable complete schema list