Package com.ultikits.ultitools.abstracts.command.parser

Class TypeParserRegistry

java.lang.Object

com.ultikits.ultitools.abstracts.command.parser.TypeParserRegistry

public final class TypeParserRegistry
extends Object

Registry for type parsers. Supports custom parser registration and provides built-in parsers. Thread-safe singleton implementation.

Built-in coverage: String (highest priority), the primitive wrapper types and their primitive/array forms (Boolean, Integer, Double, Float, Long, Short, Byte), the core Bukkit types Player, OfflinePlayer, Material, UUID, and the extended Bukkit types World, Location, GameMode, Enchantment. Register additional types with register(TypeParser).

Since:

6.2.0

Version:

2.0.0

Author:

wisdomme

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	TypeParserRegistry.SimpleTypeParser<T>	Simple implementation of TypeParser using a parsing function.

Field Summary

Fields

Modifier and Type	Field	Description
private static TypeParserRegistry	instance
private static final Object	LOCK
private final List<TypeParser<?>>	orderedParsers
private final Map<Class<?>,TypeParser<?>>	parsers

Constructor Summary

Constructors

Modifier	Constructor	Description
private	TypeParserRegistry()

Method Summary

Modifier and Type	Method	Description
List<TypeParser<?>>	getAllParsers()	Gets all registered parsers.
static TypeParserRegistry	getInstance()	Gets the singleton instance of the registry.
<T> TypeParser<T>	getParser(Class<T> type)	Gets a parser for the specified type.
boolean	hasParser(Class<?> type)	Checks if a parser is registered for the specified type.
<T> T	parse(String value, Class<T> type)	Parses a value to the specified type.
<T> T[]	parseArray(String[] values, Class<T> type)	Parses values to an array of the specified type.
<T> void	register(TypeParser<T> parser)	Registers a type parser.
private void	registerBuiltInParsers()	Registers all built-in parsers.
<T> void	unregister(TypeParser<T> parser)	Unregisters a type parser.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

instance

private static volatile TypeParserRegistry instance

LOCK

private static final Object LOCK

parsers

private final Map<Class<?>,TypeParser<?>> parsers

orderedParsers

private final List<TypeParser<?>> orderedParsers

Constructor Details

TypeParserRegistry

private TypeParserRegistry()

Method Details

getInstance

public static TypeParserRegistry getInstance()

Gets the singleton instance of the registry.

Returns:

the registry instance

register

public <T> void register(TypeParser<T> parser)

Registers a type parser.

Type Parameters:

T - the type the parser handles

Parameters:

parser - the parser to register

unregister

public <T> void unregister(TypeParser<T> parser)

Unregisters a type parser.

Type Parameters:

T - the type the parser handles

Parameters:

parser - the parser to unregister

getParser

@Nullable
public <T> TypeParser<T> getParser(Class<T> type)

Gets a parser for the specified type.

Type Parameters:

T - the type

Parameters:

type - the type to get a parser for

Returns:

the parser, or null if none found

parse

public <T> T parse(String value,
 Class<T> type)
            throws TypeParseException

Parses a value to the specified type.

Type Parameters:

T - the type

Parameters:

value - the string value to parse

type - the target type

Returns:

the parsed value

Throws:

TypeParseException - if no parser found or parsing fails

parseArray

public <T> T[] parseArray(String[] values,
 Class<T> type)
                   throws TypeParseException

Parses values to an array of the specified type.

Type Parameters:

T - the type

Parameters:

values - the string values to parse

type - the target component type

Returns:

the parsed array

Throws:

TypeParseException - if no parser found or parsing fails

hasParser

public boolean hasParser(Class<?> type)

Checks if a parser is registered for the specified type.

Parameters:

type - the type to check

Returns:

true if a parser is registered

getAllParsers

public List<TypeParser<?>> getAllParsers()

Gets all registered parsers.

Returns:

unmodifiable list of parsers

registerBuiltInParsers

private void registerBuiltInParsers()

Registers all built-in parsers.