minecraft-src/net/minecraft/core/Registry.java

package net.minecraft.core;

import com.mojang.datafixers.DataFixUtils;
import com.mojang.serialization.Codec;
import com.mojang.serialization.DataResult;
import com.mojang.serialization.DynamicOps;
import com.mojang.serialization.Keyable;
import com.mojang.serialization.Lifecycle;
import java.util.Iterator;
import java.util.List;
import java.util.Optional;
import java.util.Set;
import java.util.Map.Entry;
import java.util.stream.Stream;
import java.util.stream.StreamSupport;
import net.minecraft.core.Holder.Reference;
import net.minecraft.core.HolderLookup.RegistryLookup;
import net.minecraft.core.HolderSet.Named;
import net.minecraft.resources.ResourceKey;
import net.minecraft.resources.ResourceLocation;
import net.minecraft.tags.TagKey;
import net.minecraft.tags.TagLoader.LoadResult;
import net.minecraft.util.ExtraCodecs;
import net.minecraft.util.RandomSource;
import org.jetbrains.annotations.Nullable;

public interface Registry<T> extends Keyable, RegistryLookup<T>, IdMap<T> {
	@Override
	ResourceKey<? extends Registry<T>> key();

	default Codec<T> byNameCodec() {
		return this.referenceHolderWithLifecycle().flatComapMap(Reference::value, object -> this.safeCastToReference(this.wrapAsHolder((T)object)));
	}

	default Codec<Holder<T>> holderByNameCodec() {
		return this.referenceHolderWithLifecycle().flatComapMap(reference -> reference, this::safeCastToReference);
	}

	private Codec<Reference<T>> referenceHolderWithLifecycle() {
		Codec<Reference<T>> codec = ResourceLocation.CODEC
			.comapFlatMap(
				resourceLocation -> (DataResult)this.get(resourceLocation)
					.map(DataResult::success)
					.orElseGet(() -> DataResult.error(() -> "Unknown registry key in " + this.key() + ": " + resourceLocation)),
				reference -> reference.key().location()
			);
		return ExtraCodecs.overrideLifecycle(
			codec, reference -> (Lifecycle)this.registrationInfo(reference.key()).map(RegistrationInfo::lifecycle).orElse(Lifecycle.experimental())
		);
	}

	private DataResult<Reference<T>> safeCastToReference(Holder<T> value) {
		return value instanceof Reference<T> reference
			? DataResult.success(reference)
			: DataResult.error(() -> "Unregistered holder in " + this.key() + ": " + value);
	}

	@Override
	default <U> Stream<U> keys(DynamicOps<U> dynamicOps) {
		return this.keySet().stream().map(resourceLocation -> dynamicOps.createString(resourceLocation.toString()));
	}

	/**
	 * @return the name used to identify the given object within this registry or {@code null} if the object is not within this registry
	 */
	@Nullable
	ResourceLocation getKey(T value);

	Optional<ResourceKey<T>> getResourceKey(T value);

	@Override
	int getId(@Nullable T value);

	@Nullable
	T getValue(@Nullable ResourceKey<T> key);

	@Nullable
	T getValue(@Nullable ResourceLocation key);

	Optional<RegistrationInfo> registrationInfo(ResourceKey<T> key);

	default Optional<T> getOptional(@Nullable ResourceLocation name) {
		return Optional.ofNullable(this.getValue(name));
	}

	default Optional<T> getOptional(@Nullable ResourceKey<T> registryKey) {
		return Optional.ofNullable(this.getValue(registryKey));
	}

	Optional<Reference<T>> getAny();

	default T getValueOrThrow(ResourceKey<T> key) {
		T object = this.getValue(key);
		if (object == null) {
			throw new IllegalStateException("Missing key in " + this.key() + ": " + key);
		} else {
			return object;
		}
	}

	/**
	 * @return all keys in this registry
	 */
	Set<ResourceLocation> keySet();

	Set<Entry<ResourceKey<T>, T>> entrySet();

	Set<ResourceKey<T>> registryKeySet();

	Optional<Reference<T>> getRandom(RandomSource random);

	default Stream<T> stream() {
		return StreamSupport.stream(this.spliterator(), false);
	}

	boolean containsKey(ResourceLocation name);

	boolean containsKey(ResourceKey<T> key);

	static <T> T register(Registry<? super T> registry, String name, T value) {
		return register(registry, ResourceLocation.parse(name), value);
	}

	static <V, T extends V> T register(Registry<V> registry, ResourceLocation name, T value) {
		return register(registry, ResourceKey.create(registry.key(), name), value);
	}

	static <V, T extends V> T register(Registry<V> registry, ResourceKey<V> key, T value) {
		((WritableRegistry)registry).register(key, (V)value, RegistrationInfo.BUILT_IN);
		return value;
	}

	static <T> Reference<T> registerForHolder(Registry<T> registry, ResourceKey<T> key, T value) {
		return ((WritableRegistry)registry).register(key, value, RegistrationInfo.BUILT_IN);
	}

	static <T> Reference<T> registerForHolder(Registry<T> registry, ResourceLocation name, T value) {
		return registerForHolder(registry, ResourceKey.create(registry.key(), name), value);
	}

	Registry<T> freeze();

	Reference<T> createIntrusiveHolder(T value);

	Optional<Reference<T>> get(int index);

	Optional<Reference<T>> get(ResourceLocation key);

	Holder<T> wrapAsHolder(T value);

	default Iterable<Holder<T>> getTagOrEmpty(TagKey<T> key) {
		return DataFixUtils.orElse(this.get(key), List.of());
	}

	default Optional<Holder<T>> getRandomElementOf(TagKey<T> key, RandomSource random) {
		return this.get(key).flatMap(named -> named.getRandomElement(random));
	}

	Stream<Named<T>> getTags();

	default IdMap<Holder<T>> asHolderIdMap() {
		return new IdMap<Holder<T>>() {
			public int getId(Holder<T> holder) {
				return Registry.this.getId(holder.value());
			}

			@Nullable
			public Holder<T> byId(int i) {
				return (Holder<T>)Registry.this.get(i).orElse(null);
			}

			@Override
			public int size() {
				return Registry.this.size();
			}

			public Iterator<Holder<T>> iterator() {
				return Registry.this.listElements().map(reference -> reference).iterator();
			}
		};
	}

	Registry.PendingTags<T> prepareTagReload(LoadResult<T> loadResult);

	public interface PendingTags<T> {
		ResourceKey<? extends Registry<? extends T>> key();

		RegistryLookup<T> lookup();

		void apply();

		int size();
	}
}