Package alexiil.mc.lib.attributes.misc

Interface Reference<T>

All Known Subinterfaces:

StackReference

All Known Implementing Classes:

CallableRef, DestroyableRef, Ref, SimulatableRef, SingleCopyingItemSlot, SingleFluidTank, SingleItemSlot, UnmodifiableRef

public interface Reference<T>

A reference to some object. The object can either be obtained from (get()), or changed with (set(Object)). Note that changing the object isn't always permitted, and so it may return false if no change happened.

Method Summary

Modifier and Type	Method	Description
default DestroyableRef<T>	asDestroyable()
static <T> CallableRef<T>	callable(java.util.function.Supplier<T> getter, java.util.function.Consumer<T> setter, java.util.function.Predicate<T> filter)
static <T> DestroyableRef<T>	destroying(Reference<T> ref)
T	get()
boolean	isValid(T value)
boolean	set(T value)
default boolean	set(T value, Simulation simulation)	Delegates to set(Object) if the simulation is Simulation.ACTION, otherwise it delegates to isValid(Object).
static <T> SimulatableRef<T>	simulating(java.util.function.Supplier<T> getter, LimitedConsumer<T> setter)
static <T> UnmodifiableRef<T>	unmodifiable(T obj)

Method Details

get

T get()

Returns:

The object referenced. Note that you should generally not modify the returned value directly - instead copy it before passing it to set(Object) or isValid(Object) to see if your modifications are permitted.

set

boolean set(T value)

Returns:

True if the new value was accepted, false otherwise.

isValid

boolean isValid(T value)

Returns:

True if set(Object) was called with the same value.

set

default boolean set(T value, Simulation simulation)

Delegates to set(Object) if the simulation is Simulation.ACTION, otherwise it delegates to isValid(Object).

asDestroyable

default DestroyableRef<T> asDestroyable()

Returns:

A DestroyableRef that can be modified until DestroyableRef.destroy() is called, after which all calls to set(Object) and isValid(Object) will return false.

unmodifiable

static <T> UnmodifiableRef<T> unmodifiable(T obj)

Returns:

A new Reference that doesn't permit modifications to the given object.

callable

static <T> CallableRef<T> callable(java.util.function.Supplier<T> getter, java.util.function.Consumer<T> setter, java.util.function.Predicate<T> filter)

Parameters:

getter - The Supplier which is used for get().

setter - The Consumer which is used for set(Object) (after the filter).

filter - The Predicate which is used to test inputs for both set(Object) and isValid(Object).

Returns:

A new CallableRef that delegates to the getter, setter, and filter for all of the functions.

simulating

static <T> SimulatableRef<T> simulating(java.util.function.Supplier<T> getter, LimitedConsumer<T> setter)

Parameters:

getter - The Supplier which is used for get()

setter - The LimitedConsumer which is used for set(Object)and isValid(Object).

Returns:

A new SimulatableRef that delegates to the getter and setter for all of it's functions.

destroying

static <T> DestroyableRef<T> destroying(Reference<T> ref)

Returns:

A new DestroyableRef that delegates to the given reference for getting, although setting only succeeds until DestroyableRef.destroy() is called.