Package org.spongepowered.api.registry

Interface DefaultedRegistryReference<T>

Type Parameters:

T - The type

All Superinterfaces:

RegistryKey<T>, RegistryReference<T>, Supplier<T>

public interface DefaultedRegistryReference<T>
extends RegistryReference<T>, Supplier<T>

A reference where the holder is given to us to search within a no-args get() method.

Purely for convenience so that most default references in the API are not always calling out to the global holder simply by using it.

Nested Class Summary

Nested classes/interfaces inherited from interface org.spongepowered.api.registry.RegistryReference

RegistryReference.Factory

Method Summary

Modifier and Type	Method	Description
Supplier<RegistryHolder>	defaultHolder()
Optional<T>	find()
T	get()	Gets the value from the default holder given when constructing this reference.

Methods inherited from interface org.spongepowered.api.registry.RegistryKey

asDefaultedReference, asReference, location, registry

Methods inherited from interface org.spongepowered.api.registry.RegistryReference

find, get

Method Details

get

T get()

Gets the value from the default holder given when constructing this reference.

Great care needs to be made in calling this method with any uncertainty as to if this reference will exist in the holder. Should this reference lack a value, a ValueNotFoundException will be thrown. Therefore, it is advised to call RegistryReference.find(RegistryHolder...) instead.

Specified by:

get in interface Supplier<T>

Returns:

The value

find

Optional<T> find()

defaultHolder

Supplier<RegistryHolder> defaultHolder()