Class LifecyclePolicy

java.lang.Object

com.soklet.LifecyclePolicy

@ThreadSafe
public final class LifecyclePolicy
extends Object

Immutable startup and shutdown deadline policy shared by every configured lifecycle component.

Every timeout accepts Duration.ZERO as an immediate deadline, not an unlimited wait or a disabled phase. Zero leaves no waiting allowance for startup, startup cancelation, graceful drain or forced termination proof. Use positive budgets for normal operation; shutdown completion depends on physical termination evidence, not merely requesting interruption.

Each timeout and the sum of startup cancelation, graceful shutdown, and forced shutdown timeouts must fit in signed 64-bit nanoseconds. These three phases share one shutdown-intent origin; startup has its own independent budget. The combined bound keeps monotonic deadline comparisons valid even when the clock wraps.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	LifecyclePolicy.Builder	Mutable builder for an immutable LifecyclePolicy.

Method Summary

Modifier and Type	Method	Description
static @NonNull LifecyclePolicy.Builder	builder()
static @NonNull LifecyclePolicy	defaultInstance()
boolean	equals(@Nullable Object other)
@NonNull Duration	getForcedShutdownTimeout()
@NonNull Duration	getGracefulShutdownTimeout()
@NonNull Duration	getStartupCancelationTimeout()
@NonNull Duration	getStartupTimeout()
int	hashCode()

Methods inherited from class Object

getClass, notify, notifyAll, toString, wait, wait, wait

Method Details

defaultInstance

public static @NonNull LifecyclePolicy defaultInstance()

Returns:

the shared default lifecycle policy

builder

public static @NonNull LifecyclePolicy.Builder builder()

Returns:

a mutable builder initialized with the default policy

getStartupTimeout

public @NonNull Duration getStartupTimeout()

Returns:

startup timeout

getStartupCancelationTimeout

public @NonNull Duration getStartupCancelationTimeout()

Returns:

budget for canceling an in-flight startup call

getGracefulShutdownTimeout

public @NonNull Duration getGracefulShutdownTimeout()

Returns:

graceful shutdown timeout

getForcedShutdownTimeout

public @NonNull Duration getForcedShutdownTimeout()

Returns:

forced shutdown timeout

equals

public boolean equals(@Nullable Object other)

Overrides:

equals in class Object

Returns:

whether this policy is structurally equal to the other policy

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Returns:

structural lifecycle-policy hash code