Class ManagedAnnotationUsage

java.lang.Object

org.j7m.middleware.examples.annotation.ManagedAnnotationUsage

@J7mComponent
@Scope(ACTIVATION)
public final class ManagedAnnotationUsage
extends Object

Ordinary application objects consumed by the optional managed annotation processor/container. This API-only reference declares metadata; it does not implement a container, discovery or codec. A host supplies configuration and the explicitly registered optional service-binding policy.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	ManagedAnnotationUsage.Formatter	Factory product with no middleware-specific interface.
static interface	ManagedAnnotationUsage.RemoteApi	Ordinary remote business contract; no specialized binding interface is required.
static final class	ManagedAnnotationUsage.RemoteConsumer	Demonstrates explicit optional availability rather than a null injected service.

Constructor Summary

Constructors

Constructor	Description
ManagedAnnotationUsage(ManagedUsageSettings settings, ManagedAnnotationUsage.Formatter formatter, ManagedAnnotationUsage.RemoteConsumer remote)	Receives a validated configuration snapshot and an exactly qualified factory product.

Method Summary

Modifier and Type	Method	Description
int	attempts()	Returns the typed configuration value captured for this activation.
static ManagedAnnotationUsage.RemoteConsumer	consumer(org.j7m.middleware.application.api.ManagedProvider<Optional<ManagedAnnotationUsage.RemoteApi>> remote)	Produces a consumer whose provider is prepared by the host's explicit optional binding policy.
static ManagedAnnotationUsage.Formatter	formatter()	Produces a new immutable product for each prototype resolution without a factory receiver.
String	greet(String name)	Formats a greeting using injected configuration and the qualified product.
String	greetOrFallback(String name)	Uses an optional remote product without injecting null when discovery has no target.

Methods inherited from class Object

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

Constructor Details

ManagedAnnotationUsage

public ManagedAnnotationUsage(ManagedUsageSettings settings,
 ManagedAnnotationUsage.Formatter formatter,
 ManagedAnnotationUsage.RemoteConsumer remote)

Receives a validated configuration snapshot and an exactly qualified factory product.

Parameters:

settings - immutable application configuration

formatter - product selected by the formal style qualifier

remote - product backed by the host optional service policy

Throws:

NullPointerException - if a dependency is absent

Method Details

greet

public String greet(String name)

Formats a greeting using injected configuration and the qualified product.

Parameters:

name - caller-supplied display text

Returns:

greeting containing the configured region

attempts

public int attempts()

Returns the typed configuration value captured for this activation.

Returns:

configured positive attempt limit

formatter

@Produces
@Scope(PROTOTYPE)
public static ManagedAnnotationUsage.Formatter formatter()

Produces a new immutable product for each prototype resolution without a factory receiver.

Returns:

formal formatter owned by the resolving managed scope

consumer

@Produces
public static ManagedAnnotationUsage.RemoteConsumer consumer(@ServiceRef(name="//annotation/remote",contractId="examples.annotation.remote",policy="optional")
 org.j7m.middleware.application.api.ManagedProvider<Optional<ManagedAnnotationUsage.RemoteApi>> remote)

Produces a consumer whose provider is prepared by the host's explicit optional binding policy. The static factory avoids a dependency cycle through its declaring component.

Parameters:

remote - host-authorized optional service provider

Returns:

activation-owned consumer product

Throws:

NullPointerException - if the provider is absent

greetOrFallback

public String greetOrFallback(String name)

Uses an optional remote product without injecting null when discovery has no target.

Parameters:

name - display text

Returns:

remote greeting or explicit fallback