This commit is contained in:
kento2 2026-04-15 21:25:32 +02:00
parent 7bfbe48729
commit 0078822da1
18 changed files with 106 additions and 61 deletions

View file

@ -0,0 +1,19 @@
package de.kentoj.kencommandapi;
import de.kentoj.kencommandapi.api.processing.CommandContext;
import de.kentoj.kencommandapi.api.processing.ParsedArgument;
import de.kentoj.kencommandapi.impl.processing.CommandContextImpl;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
import java.util.Map;
public class BukkitCommandContext extends CommandContextImpl<CommandSender> {
BukkitCommandContext(CommandSender sender, Map<String, ParsedArgument<CommandContext<CommandSender>, ?>> parsedArguments) {
super(sender, parsedArguments);
}
public Player getPlayerSender() {
return ((Player) getSender());
}
}

View file

@ -1,8 +1,16 @@
package de.kentoj.kencommandapi; package de.kentoj.kencommandapi;
import de.kentoj.kencommandapi.api.KenCommandApi; import de.kentoj.kencommandapi.api.processing.CommandContext;
import de.kentoj.kencommandapi.api.processing.ParsedArgument;
import de.kentoj.kencommandapi.impl.AbstractKenCommandApi;
import org.bukkit.command.CommandSender;
public class BukkitKenCommandApi extends KenCommandApiImpl<> { import java.util.Map;
private final KenCommandApi<> public class BukkitKenCommandApi extends AbstractKenCommandApi<CommandSender, CommandContext<CommandSender>> {
@Override
public CommandContext<CommandSender> createContext(CommandSender sender, Map<String, ParsedArgument<CommandContext<CommandSender>, ?>> parsedArguments) {
return new BukkitCommandContext(sender, parsedArguments);
}
} }

View file

@ -1,15 +1,23 @@
package de.kentoj.kencommandapi; package de.kentoj.kencommandapi;
import de.kentoj.kencommandapi.api.KenCommandApi; import de.kentoj.kencommandapi.api.processing.CommandContext;
import de.kentoj.kencommandapi.api.processing.ParsedArgument;
import de.kentoj.kencommandapi.api.structure.argument.types.IntegerArgumentType; import de.kentoj.kencommandapi.api.structure.argument.types.IntegerArgumentType;
import de.kentoj.kencommandapi.impl.KenCommandApiImpl; import de.kentoj.kencommandapi.impl.AbstractKenCommandApi;
import de.kentoj.kencommandapi.impl.processing.CommandContextImpl;
import java.io.PrintStream; import java.io.PrintStream;
import java.util.Map;
public class Main { public class Main {
public static void main(String[] args) { public static void main(String[] args) {
KenCommandApi<PrintStream> api = new KenCommandApiImpl<>(); var api = new AbstractKenCommandApi<PrintStream, CommandContext<PrintStream>>() {
@Override
public CommandContextImpl<PrintStream> createContext(PrintStream sender, Map<String, ParsedArgument<CommandContext<PrintStream>, ?>> parsedArguments) {
return new CommandContextImpl<>(sender, parsedArguments);
}
};
var root = api.createNode("coins"); var root = api.createNode("coins");

View file

@ -1,14 +1,15 @@
package de.kentoj.kencommandapi.api; package de.kentoj.kencommandapi.api;
import de.kentoj.kencommandapi.api.processing.CommandContext;
import de.kentoj.kencommandapi.api.structure.argument.ArgumentType; import de.kentoj.kencommandapi.api.structure.argument.ArgumentType;
import de.kentoj.kencommandapi.api.structure.argument.CommandArgument; import de.kentoj.kencommandapi.api.structure.argument.CommandArgument;
import de.kentoj.kencommandapi.api.structure.node.CommandNode; import de.kentoj.kencommandapi.api.structure.node.CommandNode;
public interface KenCommandApi<T> { public interface KenCommandApi<T, S extends CommandContext<T>> {
CommandNode<T> createNode(String... name); CommandNode<S> createNode(String... name);
<V> CommandArgument<T, V> createArgument(String id, ArgumentType<V> type); <V> CommandArgument<S, V> createArgument(String id, ArgumentType<V> type);
void invoke(CommandNode<T> node, T sender, String[] args); void invoke(CommandNode<S> node, T sender, String[] args);
} }

View file

@ -8,7 +8,7 @@ public interface CommandContext<T> {
* @return Object that is parsed from the raw argument * @return Object that is parsed from the raw argument
* @throws RuntimeException if no value given and no default value supplied * @throws RuntimeException if no value given and no default value supplied
*/ */
<V> ParsedArgument<T, V> getParsedArgument(String name); <V> ParsedArgument<CommandContext<T>, V> getParsedArgument(String name);
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
default <V> V getArg(String name) { default <V> V getArg(String name) {

View file

@ -1,6 +1,6 @@
package de.kentoj.kencommandapi.api.processing; package de.kentoj.kencommandapi.api.processing;
public interface CommandExecutor<S> { public interface CommandExecutor<S extends CommandContext<?>> {
void execute(CommandContext<T> ctx); void execute(S ctx);
} }

View file

@ -2,9 +2,9 @@ package de.kentoj.kencommandapi.api.processing;
import de.kentoj.kencommandapi.api.structure.argument.CommandArgument; import de.kentoj.kencommandapi.api.structure.argument.CommandArgument;
public interface ParsedArgument<T, V> { public interface ParsedArgument<S extends CommandContext<?>, V> {
V getValue(); V getValue();
CommandArgument<T, V> getArgument(); CommandArgument<S, V> getArgument();
} }

View file

@ -1,22 +1,23 @@
package de.kentoj.kencommandapi.api.structure.argument; package de.kentoj.kencommandapi.api.structure.argument;
import de.kentoj.kencommandapi.api.processing.CommandContext;
import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable; import org.jetbrains.annotations.Nullable;
public interface CommandArgument<T, V> { public interface CommandArgument<S extends CommandContext<?>, V> {
String getId(); String getId();
ArgumentType<V> getType(); ArgumentType<V> getType();
void setDefaultValue(@Nullable T defaultValue); void setDefaultValue(@Nullable V defaultValue);
@Nullable T getDefaultValue(); @Nullable V getDefaultValue();
void setSuggestionProvider(@Nullable SuggestionProvider<T> suggestionProvider); void setSuggestionProvider(@Nullable SuggestionProvider<S> suggestionProvider);
/** /**
* @return the explicitly set SuggestionProvider or the default suggestions for the type if unset/null * @return the explicitly set SuggestionProvider or the default suggestions for the type if unset/null
*/ */
@NotNull SuggestionProvider<T> getSuggestionProvider(); @NotNull SuggestionProvider<S> getSuggestionProvider();
} }

View file

@ -4,7 +4,7 @@ import de.kentoj.kencommandapi.api.processing.CommandContext;
import java.util.Set; import java.util.Set;
public interface SuggestionProvider<T> { public interface SuggestionProvider<S extends CommandContext<?>> {
Set<String> suggest(CommandContext<T> context); Set<String> suggest(S context);
} }

View file

@ -9,12 +9,12 @@ import lombok.NoArgsConstructor;
import java.util.Set; import java.util.Set;
@NoArgsConstructor(access = AccessLevel.NONE) @NoArgsConstructor(access = AccessLevel.NONE)
public class NoSuggestionProvider implements SuggestionProvider<Object> { public class NoSuggestionProvider implements SuggestionProvider<CommandContext<Object>> {
@Getter(value = AccessLevel.PRIVATE, lazy = true) @Getter(value = AccessLevel.PRIVATE, lazy = true)
private static final SuggestionProvider<Object> instance = new NoSuggestionProvider(); private static final SuggestionProvider<?> instance = new NoSuggestionProvider();
public static SuggestionProvider<Object> create() { public static SuggestionProvider<?> create() {
return getInstance(); return getInstance();
} }

View file

@ -1,12 +1,13 @@
package de.kentoj.kencommandapi.api.structure.node; package de.kentoj.kencommandapi.api.structure.node;
import de.kentoj.kencommandapi.api.processing.CommandContext;
import de.kentoj.kencommandapi.api.structure.argument.CommandArgument; import de.kentoj.kencommandapi.api.structure.argument.CommandArgument;
import java.util.Set; import java.util.Set;
public interface ArgumentNode<T> { public interface ArgumentNode<S extends CommandContext<?>> {
<V> void addArgument(CommandArgument<T, V> argument); <V> void addArgument(CommandArgument<S, V> argument);
Set<CommandArgument<T, ?>> getArguments(); Set<CommandArgument<S, ?>> getArguments();
} }

View file

@ -1,19 +1,20 @@
package de.kentoj.kencommandapi.api.structure.node; package de.kentoj.kencommandapi.api.structure.node;
import de.kentoj.kencommandapi.api.processing.CommandContext;
import de.kentoj.kencommandapi.api.processing.CommandExecutor; import de.kentoj.kencommandapi.api.processing.CommandExecutor;
import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable; import org.jetbrains.annotations.Nullable;
/** /**
* @param <T> type of command sender * @param <S> type of command context
*/ */
public interface CommandNode<T> extends ArgumentNode<T>, LiteralNode<T> { public interface CommandNode<S extends CommandContext<?>> extends ArgumentNode<S>, LiteralNode<S> {
@NotNull String[] getNames(); @NotNull String[] getNames();
void setExecutor(@Nullable CommandExecutor<T> executor); void setExecutor(@Nullable CommandExecutor<S> executor);
@Nullable CommandExecutor<T> getExecutor(); @Nullable CommandExecutor<S> getExecutor();
void setDescription(@Nullable String description); void setDescription(@Nullable String description);

View file

@ -1,15 +1,16 @@
package de.kentoj.kencommandapi.api.structure.node; package de.kentoj.kencommandapi.api.structure.node;
import de.kentoj.kencommandapi.api.processing.CommandContext;
import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable; import org.jetbrains.annotations.Nullable;
import java.util.Set; import java.util.Set;
public interface LiteralNode<T> { public interface LiteralNode<S extends CommandContext<?>> {
void addLiteral(@NotNull CommandNode<T> commandNode); void addLiteral(@NotNull CommandNode<S> commandNode);
@Nullable CommandNode<T> getLiteral(@NotNull String name); @Nullable CommandNode<S> getLiteral(@NotNull String name);
@NotNull Set<CommandNode<T>> getLiterals(); @NotNull Set<CommandNode<S>> getLiterals();
} }

View file

@ -1,11 +1,11 @@
package de.kentoj.kencommandapi.impl; package de.kentoj.kencommandapi.impl;
import de.kentoj.kencommandapi.api.KenCommandApi; import de.kentoj.kencommandapi.api.KenCommandApi;
import de.kentoj.kencommandapi.api.processing.CommandContext;
import de.kentoj.kencommandapi.api.processing.ParsedArgument; import de.kentoj.kencommandapi.api.processing.ParsedArgument;
import de.kentoj.kencommandapi.api.structure.argument.ArgumentType; import de.kentoj.kencommandapi.api.structure.argument.ArgumentType;
import de.kentoj.kencommandapi.api.structure.argument.CommandArgument; import de.kentoj.kencommandapi.api.structure.argument.CommandArgument;
import de.kentoj.kencommandapi.api.structure.node.CommandNode; import de.kentoj.kencommandapi.api.structure.node.CommandNode;
import de.kentoj.kencommandapi.impl.processing.CommandContextImpl;
import de.kentoj.kencommandapi.impl.processing.ParsedArgumentImpl; import de.kentoj.kencommandapi.impl.processing.ParsedArgumentImpl;
import de.kentoj.kencommandapi.impl.structure.argument.CommandArgumentImpl; import de.kentoj.kencommandapi.impl.structure.argument.CommandArgumentImpl;
import de.kentoj.kencommandapi.impl.structure.node.CommandNodeImpl; import de.kentoj.kencommandapi.impl.structure.node.CommandNodeImpl;
@ -17,28 +17,30 @@ import java.util.Iterator;
import java.util.Map; import java.util.Map;
@RequiredArgsConstructor @RequiredArgsConstructor
public class KenCommandApiImpl<T> implements KenCommandApi<T> { public abstract class AbstractKenCommandApi<T, S extends CommandContext<T>> implements KenCommandApi<T, S> {
public abstract S createContext(T sender, Map<String, ParsedArgument<S, ?>> parsedArguments);
@Override @Override
public CommandNode<T> createNode(String... name) { public CommandNode<S> createNode(String... name) {
return new CommandNodeImpl<>(name); return new CommandNodeImpl<>(name);
} }
@Override @Override
public <V> CommandArgument<T, V> createArgument(String id, ArgumentType<V> type) { public <V> CommandArgument<S, V> createArgument(String id, ArgumentType<V> type) {
return new CommandArgumentImpl<>(id, type); return new CommandArgumentImpl<>(id, type);
} }
@Override @Override
public void invoke(CommandNode<T> node, T sender, String[] args) { public void invoke(CommandNode<S> node, T sender, String[] args) {
var iter = Arrays.stream(args).iterator(); var iter = Arrays.stream(args).iterator();
var executableLiteral = processLiterals(node, iter); var executableLiteral = processLiterals(node, iter);
var parsedArguments = parseArguments(executableLiteral, iter); var parsedArguments = parseArguments(executableLiteral, iter);
executableLiteral.getExecutor().execute(new CommandContextImpl<>(sender, parsedArguments)); executableLiteral.getExecutor().execute(createContext(sender, parsedArguments));
} }
private CommandNode<T> processLiterals(CommandNode<T> commandNode, Iterator<String> iter) { private CommandNode<S> processLiterals(CommandNode<S> commandNode, Iterator<String> iter) {
if (!iter.hasNext()) { if (!iter.hasNext()) {
// literals/arguments are optional if the node itself is executable // literals/arguments are optional if the node itself is executable
if (commandNode.getExecutor() == null) throw new RuntimeException("no literal given but required"); if (commandNode.getExecutor() == null) throw new RuntimeException("no literal given but required");
@ -57,11 +59,11 @@ public class KenCommandApiImpl<T> implements KenCommandApi<T> {
return processLiterals(literal, iter); return processLiterals(literal, iter);
} }
private Map<String, ParsedArgument<T, ?>> parseArguments(CommandNode<T> commandNode, Iterator<String> iter) { private Map<String, ParsedArgument<S, ?>> parseArguments(CommandNode<S> commandNode, Iterator<String> iter) {
Map<String, ParsedArgument<T, ?>> parsedArguments = new HashMap<>(); Map<String, ParsedArgument<S, ?>> parsedArguments = new HashMap<>();
for (var argument : commandNode.getArguments()) { for (var argument : commandNode.getArguments()) {
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
var arg = ((CommandArgument<T, Object>) argument); var arg = ((CommandArgument<S, Object>) argument);
if (!iter.hasNext()) { if (!iter.hasNext()) {
var defaultValue = arg.getDefaultValue(); var defaultValue = arg.getDefaultValue();

View file

@ -12,13 +12,13 @@ public class CommandContextImpl<T> implements CommandContext<T> {
@Getter @Getter
private final T sender; private final T sender;
@Getter @Getter
private final Map<String, ParsedArgument<T, ?>> parsedArguments; private final Map<String, ParsedArgument<CommandContext<T>, ?>> parsedArguments;
@Override @Override
public <V> ParsedArgument<T, V> getParsedArgument(String name) { public <V> ParsedArgument<CommandContext<T>, V> getParsedArgument(String name) {
try { try {
//noinspection unchecked //noinspection unchecked
return (ParsedArgument<T, V>) parsedArguments.get(name); return (ParsedArgument<CommandContext<T>, V>) parsedArguments.get(name);
} catch (ClassCastException e) { } catch (ClassCastException e) {
throw new RuntimeException("requested argument with wrong type", e); throw new RuntimeException("requested argument with wrong type", e);
} }

View file

@ -1,11 +1,12 @@
package de.kentoj.kencommandapi.impl.processing; package de.kentoj.kencommandapi.impl.processing;
import de.kentoj.kencommandapi.api.processing.CommandContext;
import de.kentoj.kencommandapi.api.processing.ParsedArgument; import de.kentoj.kencommandapi.api.processing.ParsedArgument;
import de.kentoj.kencommandapi.api.structure.argument.CommandArgument; import de.kentoj.kencommandapi.api.structure.argument.CommandArgument;
import lombok.Data; import lombok.Data;
@Data @Data
public class ParsedArgumentImpl<T, V> implements ParsedArgument<T, V> { public class ParsedArgumentImpl<S extends CommandContext<?>, V> implements ParsedArgument<S, V> {
final V value; final V value;
final CommandArgument<T, V> argument; final CommandArgument<S, V> argument;
} }

View file

@ -1,5 +1,6 @@
package de.kentoj.kencommandapi.impl.structure.argument; package de.kentoj.kencommandapi.impl.structure.argument;
import de.kentoj.kencommandapi.api.processing.CommandContext;
import de.kentoj.kencommandapi.api.structure.argument.ArgumentType; import de.kentoj.kencommandapi.api.structure.argument.ArgumentType;
import de.kentoj.kencommandapi.api.structure.argument.CommandArgument; import de.kentoj.kencommandapi.api.structure.argument.CommandArgument;
import de.kentoj.kencommandapi.api.structure.argument.SuggestionProvider; import de.kentoj.kencommandapi.api.structure.argument.SuggestionProvider;
@ -9,7 +10,7 @@ import lombok.Setter;
import org.jetbrains.annotations.Nullable; import org.jetbrains.annotations.Nullable;
@RequiredArgsConstructor @RequiredArgsConstructor
public class CommandArgumentImpl<T, V> implements CommandArgument<T, V> { public class CommandArgumentImpl<S extends CommandContext<?>, V> implements CommandArgument<S, V> {
@Getter @Getter
private final String id; private final String id;
@ -18,9 +19,9 @@ public class CommandArgumentImpl<T, V> implements CommandArgument<T, V> {
@Getter @Getter
@Setter @Setter
private @Nullable T defaultValue; private @Nullable V defaultValue;
@Getter @Getter
@Setter @Setter
private @Nullable SuggestionProvider<T> suggestionProvider; private @Nullable SuggestionProvider<S> suggestionProvider;
} }

View file

@ -1,5 +1,6 @@
package de.kentoj.kencommandapi.impl.structure.node; package de.kentoj.kencommandapi.impl.structure.node;
import de.kentoj.kencommandapi.api.processing.CommandContext;
import de.kentoj.kencommandapi.api.processing.CommandExecutor; import de.kentoj.kencommandapi.api.processing.CommandExecutor;
import de.kentoj.kencommandapi.api.structure.argument.CommandArgument; import de.kentoj.kencommandapi.api.structure.argument.CommandArgument;
import de.kentoj.kencommandapi.api.structure.node.CommandNode; import de.kentoj.kencommandapi.api.structure.node.CommandNode;
@ -11,7 +12,7 @@ import org.jetbrains.annotations.Nullable;
import java.util.HashSet; import java.util.HashSet;
import java.util.Set; import java.util.Set;
public class CommandNodeImpl<T> implements CommandNode<T> { public class CommandNodeImpl<S extends CommandContext<?>> implements CommandNode<S> {
@Getter @Getter
private final String[] names; private final String[] names;
@ -22,20 +23,20 @@ public class CommandNodeImpl<T> implements CommandNode<T> {
} }
@Getter @Getter
private final Set<CommandNode<T>> literals = new HashSet<>(); private final Set<CommandNode<S>> literals = new HashSet<>();
@Getter @Getter
private final Set<CommandArgument<T, ?>> arguments = new HashSet<>(); private final Set<CommandArgument<S, ?>> arguments = new HashSet<>();
@Getter @Getter
@Setter @Setter
private @Nullable CommandExecutor<T> executor; private @Nullable CommandExecutor<S> executor;
@Getter @Getter
@Setter @Setter
private String description; private String description;
@Override @Override
public void addLiteral(@NotNull CommandNode<T> commandNode) { public void addLiteral(@NotNull CommandNode<S> commandNode) {
for (String name : commandNode.getNames()) { for (String name : commandNode.getNames()) {
if (getLiteral(name) != null) throw new IllegalArgumentException("literal with same name is already added"); if (getLiteral(name) != null) throw new IllegalArgumentException("literal with same name is already added");
} }
@ -43,7 +44,7 @@ public class CommandNodeImpl<T> implements CommandNode<T> {
} }
@Override @Override
public CommandNode<T> getLiteral(@NotNull String name) { public CommandNode<S> getLiteral(@NotNull String name) {
for (var literal : literals) { for (var literal : literals) {
for (String literalName : literal.getNames()) { for (String literalName : literal.getNames()) {
if (literalName.equalsIgnoreCase(name)) return literal; if (literalName.equalsIgnoreCase(name)) return literal;
@ -53,7 +54,7 @@ public class CommandNodeImpl<T> implements CommandNode<T> {
} }
@Override @Override
public <V> void addArgument(CommandArgument<T, V> argument) { public <V> void addArgument(CommandArgument<S, V> argument) {
if (arguments.stream() if (arguments.stream()
.anyMatch(arg -> arg.getId().equals(argument.getId())) .anyMatch(arg -> arg.getId().equals(argument.getId()))
) { ) {