Package studio.mevera.imperat.command.arguments.type.handlers

Class CollectionArgumentTypeHandler<S extends CommandSource>

java.lang.Object

studio.mevera.imperat.command.arguments.type.handlers.CollectionArgumentTypeHandler<S>

Type Parameters:

S - the source type

All Implemented Interfaces:

ArgumentTypeHandler<S>, Prioritizable

public final class CollectionArgumentTypeHandler<S extends CommandSource>
extends Object
implements ArgumentTypeHandler<S>

Handler for resolving ArgumentType instances for Collection types.

This handler supports all standard Java collection implementations and allows registration of custom collection initializers.

Constructor Summary

Constructors

Constructor	Description
CollectionArgumentTypeHandler()	Creates a new CollectionArgumentTypeHandler with default initializers.

Method Summary

Modifier and Type	Method	Description
boolean	canHandle(@NotNull Type type, @NotNull TypeWrap<?> wrap)	Determines if this handler can resolve the given type.
@NotNull Priority	getPriority()
<C extends Collection<?>> void	registerInitializer(@NotNull Class<C> type, @NotNull Supplier<C> supplier)	Registers a custom collection initializer.
<T> @Nullable ArgumentType<S,T>	resolve(@NotNull Type type, @NotNull TypeWrap<?> wrap, @NotNull ArgumentTypeLookup<S> lookup)	Resolves an ArgumentType for the given type.

Methods inherited from class java.lang.Object

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

Methods inherited from interface studio.mevera.imperat.command.arguments.type.ArgumentTypeHandler

onRegisteringResolver

Constructor Details

CollectionArgumentTypeHandler

public CollectionArgumentTypeHandler()

Creates a new CollectionArgumentTypeHandler with default initializers.

Method Details

registerInitializer

public <C extends Collection<?>> void registerInitializer(@NotNull
 @NotNull Class<C> type,
 @NotNull
 @NotNull Supplier<C> supplier)

Registers a custom collection initializer.

Type Parameters:

C - the collection type

Parameters:

type - the collection type

supplier - the supplier that creates new instances

canHandle

public boolean canHandle(@NotNull
 @NotNull Type type,
 @NotNull
 @NotNull TypeWrap<?> wrap)

Description copied from interface: ArgumentTypeHandler

Determines if this handler can resolve the given type.

Specified by:

canHandle in interface ArgumentTypeHandler<S extends CommandSource>

Parameters:

type - the raw type to check

wrap - the wrapped type for convenience, providing additional type introspection

Returns:

true if this handler can handle the type

resolve

@Nullable
public <T> @Nullable ArgumentType<S,T> resolve(@NotNull
 @NotNull Type type,
 @NotNull
 @NotNull TypeWrap<?> wrap,
 @NotNull
 @NotNull ArgumentTypeLookup<S> lookup)

Description copied from interface: ArgumentTypeHandler

Resolves an ArgumentType for the given type.

This method is called only if ArgumentTypeHandler.canHandle(Type, TypeWrap) returns true. The provided ArgumentTypeLookup can be used to recursively resolve component types for generic types (e.g., the element type of a collection).

Specified by:

resolve in interface ArgumentTypeHandler<S extends CommandSource>

Type Parameters:

T - the resolved type

Parameters:

type - the type to resolve

wrap - the wrapped type for convenience

lookup - the lookup function for resolving nested/component types

Returns:

the resolved ArgumentType, or null if resolution fails despite canHandle returning true

getPriority

@NotNull
public @NotNull Priority getPriority()

Specified by:

getPriority in interface Prioritizable