package carpet.script.annotation;
import java.util.HashMap;
import java.util.Map;
import java.util.Objects;
import java.util.function.Function;
import net.minecraft.core.BlockPos;
import net.minecraft.core.GlobalPos;
import net.minecraft.nbt.Tag;
import net.minecraft.network.chat.Component;
import net.minecraft.resources.ResourceLocation;
import net.minecraft.world.entity.Entity;
import net.minecraft.world.item.ItemStack;
import net.minecraft.world.phys.Vec3;
import org.apache.commons.lang3.ClassUtils;
import carpet.script.value.BooleanValue;
import carpet.script.value.EntityValue;
import carpet.script.value.FormattedTextValue;
import carpet.script.value.NBTSerializableValue;
import carpet.script.value.NumericValue;
import carpet.script.value.StringValue;
import carpet.script.value.Value;
import carpet.script.value.ValueConversions;
import javax.annotation.Nullable;
/**
*
A converter from a given {@link Object} of type T into a {@link Value}, used in order to convert the outputs of methods into usable Scarpet
* values.
*
* @see #register(Class, Function)
* @param The type to convert from into a {@link Value}
*/
public final class OutputConverter
{
private static final Map, OutputConverter>> byResult = new HashMap<>();
private static final OutputConverter VALUE = new OutputConverter<>(Function.identity());
static
{
// Primitives are handled. Things are boxed in the process anyway, therefore would recommend boxed outputs, so you can use null
register(Void.TYPE, v -> Value.NULL);
register(Boolean.class, BooleanValue::of);
register(Integer.class, NumericValue::new);
register(Double.class, NumericValue::of);
register(Float.class, NumericValue::of);
register(Long.class, NumericValue::new);
register(String.class, StringValue::new);
register(Entity.class, EntityValue::new);
register(Component.class, FormattedTextValue::new);
register(Tag.class, NBTSerializableValue::new);
register(BlockPos.class, ValueConversions::of);
register(Vec3.class, ValueConversions::of);
register(ItemStack.class, ValueConversions::of);
register(ResourceLocation.class, ValueConversions::of);
register(GlobalPos.class, ValueConversions::of);
}
private final Function converter;
private OutputConverter(Function converter)
{
this.converter = converter;
}
/**
* Returns the {@link OutputConverter} for the specified returnType.
*
* @param The type of the {@link OutputConverter} you are looking for
* @param returnType The class that the returned {@link OutputConverter} converts from
* @return The {@link OutputConverter} for the specified returnType
*/
@SuppressWarnings("unchecked") // OutputConverters are stored with their class, for sure since the map is private (&& class has same generic as
// converter)
public static OutputConverter get(Class returnType)
{
if (Value.class.isAssignableFrom(returnType))
{
return (OutputConverter) VALUE;
}
returnType = (Class) ClassUtils.primitiveToWrapper(returnType); // wrapper holds same generic as primitive: wrapped
return (OutputConverter) Objects.requireNonNull(byResult.get(returnType),
"Unregistered output type: " + returnType + ". Register in OutputConverter");
}
/**
* Converts the given input object into a {@link Value}, to be used in return values of Scarpet functions
*
* Returns {@link Value#NULL} if passed a {@code null} input
*
* @param input The value to convert
* @return The converted value
*/
public Value convert(@Nullable T input)
{
return input == null ? Value.NULL : converter.apply(input);
}
/**
* Registers a new type to be able to be used as the return value of methods, converting from inputType to a {@link Value}
* using the given function.
*
* @param The type of the input type
* @param inputType The class of T
* @param converter The function that converts the instance of T to a {@link Value}
*/
public static void register(Class inputType, Function converter)
{
OutputConverter instance = new OutputConverter<>(converter);
if (byResult.containsKey(inputType))
{
throw new IllegalArgumentException(inputType + " already has a registered OutputConverter");
}
byResult.put(inputType, instance);
}
/**
* @see #register(Class, Function)
*
* @deprecated Just use {@link #register(Class, Function)}, it now does the same as this
*/
@Deprecated
public static void registerToValue(Class inputType, Function converter)
{
register(inputType, converter);
}
}