net.minecraftforge.common.util

クラス LazyOptional<T>

java.lang.Object

net.minecraftforge.common.util.LazyOptional<T>

型パラメータ:

T - The type of the optional value.

@ParametersAreNonnullByDefault
 @MethodsReturnNonnullByDefault
public class LazyOptional<T>
extends java.lang.Object

This object encapsulates a lazy value, with typical transformation operations (map/ifPresent) available, much like Optional.

It also provides the ability to listen for invalidation, via #addListener(Consumer). This method is invoked when the provider of this object calls invalidate().

To create an instance of this class, use of(NonNullSupplier). Note that this accepts a NonNullSupplier, so the result of the supplier must never be null.

The empty instance can be retrieved with empty().

メソッドのサマリー

修飾子とタイプ	メソッドと説明
void	addListener(NonNullConsumer<LazyOptional<T>> listener) Register a listener that will be called when this LazyOptional becomes invalid (via invalidate()).
<X> LazyOptional<X>	cast() This method hides an unchecked cast to the inferred type.
static <T> LazyOptional<T>	empty()
LazyOptional<T>	filter(NonNullPredicate<? super T> predicate) Resolve the contained supplier if non-empty, and filter it by the given NonNullPredicate, returning empty if false.
void	ifPresent(NonNullConsumer<? super T> consumer) If non-empty, invoke the specified NonNullConsumer with the object, otherwise do nothing.
void	invalidate() Invalidate this LazyOptional, making it unavailable for further use, and notifying any listeners that this has become invalid and they should update.
boolean	isPresent() Check if this LazyOptional is non-empty.
<U> LazyOptional<U>	map(NonNullFunction<? super T,? extends U> mapper) If a this LazyOptional is non-empty, return a new LazyOptional encapsulating the mapping function.
static <T> LazyOptional<T>	of(NonNullSupplier<T> instanceSupplier) Construct a new LazyOptional that wraps the given NonNullSupplier.
T	orElse(T other) Resolve the contained supplier if non-empty and return the result, otherwise return other.
T	orElseGet(NonNullSupplier<? extends T> other) Resolve the contained supplier if non-empty and return the result, otherwise return the result of other.
<X extends java.lang.Throwable> T	orElseThrow(NonNullSupplier<? extends X> exceptionSupplier) Resolve the contained supplier if non-empty and return the result, otherwise throw the exception created by the provided NonNullSupplier.

クラスから継承されたメソッド java.lang.Object

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

メソッドの詳細

of

public static <T> LazyOptional<T> of(@Nullable
                                     NonNullSupplier<T> instanceSupplier)

Construct a new LazyOptional that wraps the given NonNullSupplier.

パラメータ:

instanceSupplier - The NonNullSupplier to wrap. Cannot return null, but can be null itself. If null, this method returns empty().

empty

public static <T> LazyOptional<T> empty()

戻り値:

The singleton empty instance

cast

public <X> LazyOptional<X> cast()

This method hides an unchecked cast to the inferred type. Only use this if you are sure the type should match. For capabilities, generally Capability.orEmpty(Capability, LazyOptional) should be used.

戻り値:

This LazyOptional, cast to the inferred generic type

isPresent

public boolean isPresent()

Check if this LazyOptional is non-empty.

戻り値:

true if this LazyOptional is non-empty, i.e. holds a non-null supplier

ifPresent

public void ifPresent(NonNullConsumer<? super T> consumer)

If non-empty, invoke the specified NonNullConsumer with the object, otherwise do nothing.

パラメータ:

The - NonNullConsumer to run if this optional is non-empty.

例外:

java.lang.NullPointerException - if consumer is null and this LazyOptional is non-empty

map

public <U> LazyOptional<U> map(NonNullFunction<? super T,? extends U> mapper)

If a this LazyOptional is non-empty, return a new LazyOptional encapsulating the mapping function. Otherwise, returns empty().

The supplier inside this object is NOT resolved.

型パラメータ:

U - The type of the result of the mapping function

パラメータ:

mapper - A mapping function to apply to the mod object, if present

戻り値:

A LazyOptional describing the result of applying a mapping function to the value of this LazyOptional, if a value is present, otherwise an empty LazyOptional

例外:

java.lang.NullPointerException - if mapper is null and this LazyOptional is non-empty

filter

public LazyOptional<T> filter(NonNullPredicate<? super T> predicate)

Resolve the contained supplier if non-empty, and filter it by the given NonNullPredicate, returning empty if false.

It is important to note that this method is not lazy, as it must resolve the value of the supplier to validate it with the predicate.

パラメータ:

predicate - A NonNullPredicate to apply to the result of the contained supplier, if non-empty

戻り値:

A LazyOptional containing the result of the contained supplier, if and only if the passed NonNullPredicate returns true, otherwise an empty LazyOptional

例外:

java.lang.NullPointerException - If predicate is null and this LazyOptional is non-empty

orElse

public T orElse(T other)

Resolve the contained supplier if non-empty and return the result, otherwise return other.

パラメータ:

other - the value to be returned if this LazyOptional is empty

戻り値:

the result of the supplier, if non-empty, otherwise other

orElseGet

public T orElseGet(NonNullSupplier<? extends T> other)

Resolve the contained supplier if non-empty and return the result, otherwise return the result of other.

パラメータ:

other - A NonNullSupplier whose result is returned if this LazyOptional is empty

戻り値:

The result of the supplier, if non-empty, otherwise the result of other.get()

例外:

java.lang.NullPointerException - If other is null and this LazyOptional is non-empty

orElseThrow

public <X extends java.lang.Throwable> T orElseThrow(NonNullSupplier<? extends X> exceptionSupplier)
                                              throws X extends java.lang.Throwable

Resolve the contained supplier if non-empty and return the result, otherwise throw the exception created by the provided NonNullSupplier.

型パラメータ:

X - Type of the exception to be thrown

パラメータ:

exceptionSupplier - The NonNullSupplier which will return the exception to be thrown

戻り値:

The result of the supplier

例外:

X - If this LazyOptional is empty

java.lang.NullPointerException - If exceptionSupplier is null and this LazyOptional is empty

X extends java.lang.Throwable

addListener

public void addListener(NonNullConsumer<LazyOptional<T>> listener)

Register a listener that will be called when this LazyOptional becomes invalid (via invalidate()).

If this LazyOptional is empty, the listener will be called immediately.

invalidate

public void invalidate()

Invalidate this LazyOptional, making it unavailable for further use, and notifying any listeners that this has become invalid and they should update.

This would typically be used with capability objects. For example, a TE would call this, if they are covered with a microblock panel, thus cutting off pipe connectivity to this side.

Also should be called for all when a TE is invalidated, or a world/chunk unloads, or a entity dies, etc... This allows modders to keep a cache of capability objects instead of re-checking them every tick.