/* * Copyright (c) 2019-2022 GeyserMC. http://geysermc.org * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. * * @author GeyserMC * @link https://github.com/GeyserMC/Geyser */ package org.geysermc.geyser.registry; import org.geysermc.geyser.registry.loader.RegistryLoader; import javax.annotation.Nullable; import java.util.function.Supplier; /** * An array registry that stores mappings as an array defined by {@link M}. * The M represents the value that is to be stored as part of this array. * * @param the mapping type */ public class ArrayRegistry extends Registry { /** * Creates a new array registry of this class with the given input and * {@link RegistryLoader}. The input specified is what the registry * loader needs to take in. * * @param input the input * @param registryLoader the registry loader */ protected ArrayRegistry(I input, RegistryLoader registryLoader) { super(input, registryLoader); } /** * Returns the value registered by the given index. * * @param index the index * @return the value registered by the given index. */ @Nullable public M get(int index) { if (index >= this.mappings.length) { return null; } return this.mappings[index]; } /** * Returns the value registered by the given index or the default value * specified if null. * * @param index the index * @param defaultValue the default value * @return the value registered by the given key or the default value * specified if null. */ public M getOrDefault(int index, M defaultValue) { M value = this.get(index); if (value == null) { return defaultValue; } return value; } /** * Registers a new value into this registry with the given index. * * @param index the index * @param value the value * @return a new value into this registry with the given index. */ public M register(int index, M value) { return this.mappings[index] = value; } /** * Creates a new array registry with the given {@link RegistryLoader} supplier. The * input type is not specified here, meaning the loader return type is either * predefined, or the registry is populated at a later point. * * @param registryLoader the registry loader supplier * @param the input type * @param the returned mappings type * @return a new registry with the given RegistryLoader supplier */ public static ArrayRegistry create(Supplier> registryLoader) { return new ArrayRegistry<>(null, registryLoader.get()); } /** * Creates a new array registry with the given {@link RegistryLoader} supplier * and input. * * @param input the input * @param registryLoader the registry loader supplier * @param the input type * @param the returned mappings type * @return a new registry with the given RegistryLoader supplier */ public static ArrayRegistry create(I input, Supplier> registryLoader) { return new ArrayRegistry<>(input, registryLoader.get()); } /** * Creates a new array registry with the given {@link RegistryLoader}. The * input type is not specified here, meaning the loader return type is either * predefined, or the registry is populated at a later point. * * @param registryLoader the registry loader * @param the input type * @param the returned mappings type * @return a new registry with the given RegistryLoader supplier */ public static ArrayRegistry create(RegistryLoader registryLoader) { return new ArrayRegistry<>(null, registryLoader); } /** * Creates a new array registry with the given {@link RegistryLoader} and input. * * @param input the input * @param registryLoader the registry loader * @param the input type * @param the returned mappings type * @return a new registry with the given RegistryLoader supplier */ public static ArrayRegistry create(I input, RegistryLoader registryLoader) { return new ArrayRegistry<>(input, registryLoader); } }