Upstream/Minestom
1
0
Fork 0
mirror of https://github.com/Minestom/Minestom.git synced 2024-12-31 21:48:08 +01:00
Code Issues Projects Releases Wiki Activity

Improved Argument comments

Browse Source
This commit is contained in:
themode 2020-10-29 17:27:40 +01:00
parent 7352ab8cda
commit c8d1a30486
1 changed files with 18 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
src/main/java/net/minestom/server/command/builder/arguments/Argument.java
View File

@ -2,11 +2,12 @@ package net.minestom.server.command.builder.arguments;
import net.minestom.server.command.builder.ArgumentCallback; import net.minestom.server.command.builder.ArgumentCallback;
import net.minestom.server.command.builder.Command; import net.minestom.server.command.builder.Command;
import net.minestom.server.command.builder.CommandExecutor;
import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable; import org.jetbrains.annotations.Nullable;
/** /**
* An argument is meant to be parsed when added into a {@link Command} syntax. * An argument is meant to be parsed when added into a {@link Command}'s syntax with {@link Command#addSyntax(CommandExecutor, Argument[])}.
* <p> * <p>
* You can create your own with your own special conditions. * You can create your own with your own special conditions.
* <p> * <p>
@ -43,34 +44,42 @@ public abstract class Argument<T> {
} }
/** /**
* Used to provide the appropriate error concerning the received args. * First method called to check the validity of an input.
* <p>
* If {@link #allowSpace()} is enabled, the value will be incremented by the next word until it returns {@link #SUCCESS},
* meaning that you need to be sure to check the inexpensive operations first (eg the number of brackets, the first and last char, etc...).
* *
* @param value The received argument * @param value The received argument
* @return The success/error code * @return the error code or {@link #SUCCESS}
*/ */
public abstract int getCorrectionResult(@NotNull String value); public abstract int getCorrectionResult(@NotNull String value);
/** /**
* The argument syntax is correct, parsed here to the correct type. * Called after {@link #getCorrectionResult(String)} returned {@link #SUCCESS}.
* <p>
* The correction being correct means that {@code value} shouldn't be verified again, you can assume that no exception will occur
* when converting it to the correct type.
* *
* @param value The correct argument * @param value The correct argument which does not need to be verified again
* @return The parsed argument * @return The parsed argument
*/ */
@NotNull @NotNull
public abstract T parse(@NotNull String value); public abstract T parse(@NotNull String value);
/** /**
* The argument is at least partially correct (the syntax is good and the argument has been parsed) * Called after {@link #parse(String)} meaning that {@code value} should already represent a valid representation of the input.
* but some other conditions could take place (ex: min/max requirement for numbers). * <p>
* The condition result has for goal to check the optional conditions that are user configurable (eg min/max values for a number, a specific material
* for an item, etc...).
* *
* @param value The parsed argument * @param value The parsed argument
* @return The success/error code * @return the error code or {@link #SUCCESS}
*/ */
public abstract int getConditionResult(@NotNull T value); public abstract int getConditionResult(@NotNull T value);
/** /**
* Gets the ID of the argument, showed in-game above the chat bar * Gets the ID of the argument, showed in-game above the chat bar
* and used to retrieve the data when the command is parsed. * and used to retrieve the data when the command is parsed in {@link net.minestom.server.command.builder.Arguments}.
* *
* @return the argument id * @return the argument id
*/ */