Class Instance<I>

java.lang.Object

org.microbean.scopelet.Instance<I>

Type Parameters:

I - the contextual instance type

All Implemented Interfaces:

AutoCloseable, Supplier<I>

public final class Instance<I>
extends Object
implements AutoCloseable, Supplier<I>

An AutoCloseable pairing of a contextual instance that can be destroyed with a Instance.Destructor that can destroy it and a Destruction view of the Creation that caused it to be created.

Author:

Laird Nelson

See Also:

• Instance.Destructor
• Destruction

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	Instance.Destructor<I>	An interface whose implementations can destroy contextual instances.

Constructor Summary

Constructors

Constructor	Description
Instance(I contextualInstance, Instance.Destructor<I> destructor, Destruction destruction)	Creates a new Instance.

Method Summary

Modifier and Type	Method	Description
final void	close()
final boolean	closed()	Returns true if and only if this Instance has been closed.
final boolean	equals(Object other)
final I	get()	Returns the contextual instance this Instance holds, which may be null.
final int	hashCode()
final String	toString()

Methods inherited from class java.lang.Object

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

Constructor Details

Instance

public Instance(I contextualInstance,
 Instance.Destructor<I> destructor,
 Destruction destruction)

Creates a new Instance.

Parameters:

contextualInstance - a contextual instance that has just been created; may be null

destructor - a Instance.Destructor capable of (eventually) destroying the supplied contextualInstance; may be null

destruction - a Destruction; may be null

Method Details

close

public final void close()

Specified by:

close in interface AutoCloseable

closed

public final boolean closed()

Returns true if and only if this Instance has been closed.

Returns:

true if and only if this Instance has been closed

equals

public final boolean equals(Object other)

Overrides:

equals in class Object

get

public final I get()

Returns the contextual instance this Instance holds, which may be null.

Specified by:

get in interface Supplier<I>

Returns:

the contextual instance this Instance holds, which may be null

hashCode

public final int hashCode()

Overrides:

hashCode in class Object

toString

public final String toString()

Overrides:

toString in class Object