101 lines
3.9 KiB
Java
101 lines
3.9 KiB
Java
package carpet.script.exception;
|
|
|
|
import org.jspecify.annotations.Nullable;
|
|
import java.util.HashMap;
|
|
import java.util.Map;
|
|
|
|
/**
|
|
* This class contains default Scarpet catchable types, as well as their inheritance and
|
|
* methods to check whether filters are compatible with those.
|
|
*/
|
|
public class Throwables
|
|
{
|
|
private final String id;
|
|
private final @Nullable Throwables parent;
|
|
|
|
private static final Map<String, Throwables> byId = new HashMap<>();
|
|
|
|
public static final Throwables THROWN_EXCEPTION_TYPE = register("exception", null);
|
|
public static final Throwables VALUE_EXCEPTION = register("value_exception", THROWN_EXCEPTION_TYPE);
|
|
public static final Throwables UNKNOWN_ITEM = register("unknown_item", VALUE_EXCEPTION);
|
|
public static final Throwables UNKNOWN_BLOCK = register("unknown_block", VALUE_EXCEPTION);
|
|
public static final Throwables UNKNOWN_BIOME = register("unknown_biome", VALUE_EXCEPTION);
|
|
public static final Throwables UNKNOWN_PARTICLE = register("unknown_particle", VALUE_EXCEPTION);
|
|
public static final Throwables UNKNOWN_POI = register("unknown_poi", VALUE_EXCEPTION);
|
|
public static final Throwables UNKNOWN_DIMENSION = register("unknown_dimension", VALUE_EXCEPTION);
|
|
public static final Throwables UNKNOWN_STRUCTURE = register("unknown_structure", VALUE_EXCEPTION);
|
|
public static final Throwables UNKNOWN_CRITERION = register("unknown_criterion", VALUE_EXCEPTION);
|
|
public static final Throwables UNKNOWN_SCREEN = register("unknown_screen", VALUE_EXCEPTION);
|
|
public static final Throwables IO_EXCEPTION = register("io_exception", THROWN_EXCEPTION_TYPE);
|
|
public static final Throwables NBT_ERROR = register("nbt_error", IO_EXCEPTION);
|
|
public static final Throwables JSON_ERROR = register("json_error", IO_EXCEPTION);
|
|
public static final Throwables B64_ERROR = register("b64_error", IO_EXCEPTION);
|
|
public static final Throwables USER_DEFINED = register("user_exception", THROWN_EXCEPTION_TYPE);
|
|
|
|
/**
|
|
* Creates an exception and registers it to be used as parent for
|
|
* user defined exceptions in Scarpet's throw function.
|
|
* <p>Scarpet exceptions should have a top-level parent being {@link Throwables#THROWN_EXCEPTION_TYPE}
|
|
*
|
|
* @param id The value for the exception as a {@link String}.
|
|
* @param parent The parent of the exception being created, or <code>null</code> if top-level
|
|
* @return The created exception
|
|
*/
|
|
public static Throwables register(String id, @Nullable Throwables parent)
|
|
{
|
|
Throwables exc = new Throwables(id, parent);
|
|
byId.put(id, exc);
|
|
return exc;
|
|
}
|
|
|
|
/**
|
|
* Creates a new exception.
|
|
* <p>Not suitable for creating exceptions that can't be caught.
|
|
* Use an {@link InternalExpressionException} for that
|
|
*
|
|
* @param id The exception's value as a {@link String}
|
|
*/
|
|
public Throwables(String id, @Nullable Throwables parent)
|
|
{
|
|
this.id = id;
|
|
this.parent = parent;
|
|
}
|
|
|
|
public static Throwables getTypeForException(String type)
|
|
{
|
|
Throwables properType = byId.get(type);
|
|
if (properType == null)
|
|
{
|
|
throw new InternalExpressionException("Unknown exception type: " + type);
|
|
}
|
|
return properType;
|
|
}
|
|
|
|
/**
|
|
* Checks whether the given filter matches an instance of this exception, by checking equality
|
|
* with itself and possible parents.
|
|
*
|
|
* @param filter The type to check against
|
|
* @return Whether or not the given value matches this exception's hierarchy
|
|
*/
|
|
public boolean isRelevantFor(String filter)
|
|
{
|
|
return (id.equals(filter) || (parent != null && parent.isRelevantFor(filter)));
|
|
}
|
|
|
|
public boolean isUserException()
|
|
{
|
|
return this == USER_DEFINED || parent == USER_DEFINED;
|
|
}
|
|
|
|
/**
|
|
* Returns the throwable type
|
|
*
|
|
* @return The type of this exception
|
|
*/
|
|
public String getId()
|
|
{
|
|
return id;
|
|
}
|
|
}
|