Class ManagedHostedResources

java.lang.Object

org.j7m.middleware.application.components.ManagedHostedResources

public final class ManagedHostedResources
extends Object

Immutable trusted host registry for finite generated hosted features. Application descriptors cannot install factories or choose authority. Factories and their fixed worker identities are borrowed from host setup; each bound lifecycle is activation-owned. No component constructor may run until every declared feature has passed factory validation.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ManagedHostedResources.Binding	One owned backend lifecycle.
static final record	ManagedHostedResources.Bundle	Verified immutable program identity; no field is an application authorization assertion.
static final record	ManagedHostedResources.Entry	Borrowed trusted factory and immutable worker authority, never copied from application metadata.
static interface	ManagedHostedResources.Factory	Finite backend adapter installed by trusted host setup, never by an application provider.
static interface	ManagedHostedResources.Invoker	Fixed-authority invocation handle retained only by a trusted bound factory.

Constructor Summary

Constructors

Constructor	Description
ManagedHostedResources(Map<String, ManagedHostedResources.Entry> entries)	Copies a finite unambiguous host registry.

Method Summary

Modifier and Type	Method	Description
Set<Class<? extends Annotation>>	annotationTypes()	Returns the finite capabilities of explicitly installed backend factories.
boolean	backendOnly(String kind)	Tests the exact installed invocation-free capability, without a descriptor fallback.
static ManagedHostedResources	empty()	Returns an empty opt-in registry preserving ordinary managed hosting behavior.
ManagedHostedResources.Entry	require(String kind)	Selects a previously installed capability; no application fallback or discovery occurs.
List<ManagedInvocationPolicy>	requiredPolicies(String kind)	Returns immutable actual policy identities captured from trusted setup.
boolean	supports(String kind)	Returns whether a trusted capability is installed without invoking its factory.

Methods inherited from class Object

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

Constructor Details

ManagedHostedResources

public ManagedHostedResources(Map<String, ManagedHostedResources.Entry> entries)

Copies a finite unambiguous host registry.

Parameters:

entries - adapter kind to trusted factory/profile, at most64

Throws:

IllegalArgumentException - for malformed kinds or capacity

NullPointerException - for null keys or values

Method Details

require

public ManagedHostedResources.Entry require(String kind)

Selects a previously installed capability; no application fallback or discovery occurs.

Parameters:

kind - exact generated adapter kind

Returns:

borrowed trusted entry

Throws:

IllegalArgumentException - if the kind is unsupported

backendOnly

public boolean backendOnly(String kind)

Tests the exact installed invocation-free capability, without a descriptor fallback.

Parameters:

kind - selected installed kind

Returns:

whether this factory owns that backend kind

requiredPolicies

public List<ManagedInvocationPolicy> requiredPolicies(String kind)

Returns immutable actual policy identities captured from trusted setup.

Parameters:

kind - selected installed kind

Returns:

required actual guard objects

supports

public boolean supports(String kind)

Returns whether a trusted capability is installed without invoking its factory.

Parameters:

kind - exact adapter kind

Returns:

whether it has an explicitly installed factory

annotationTypes

public Set<Class<? extends Annotation>> annotationTypes()

Returns the finite capabilities of explicitly installed backend factories.

Returns:

immutable annotation capability union

Throws:

IllegalArgumentException - for excessive or duplicate capability declarations

empty

public static ManagedHostedResources empty()

Returns an empty opt-in registry preserving ordinary managed hosting behavior.

Returns:

immutable empty registry