Finish up the pagination of the help system

This commit is contained in:
Aikar
2017-10-28 13:36:39 -04:00
parent fd314b0f7c
commit 72e052d953
31 changed files with 1040 additions and 736 deletions
@@ -487,131 +487,141 @@
<span class="sourceLineNo">479</span> .collect(Collectors.toList());<a name="line.479"></a>
<span class="sourceLineNo">480</span> }<a name="line.480"></a>
<span class="sourceLineNo">481</span><a name="line.481"></a>
<span class="sourceLineNo">482</span><a name="line.482"></a>
<span class="sourceLineNo">483</span> private boolean executeSubcommand(CommandOperationContext commandContext, String subcommand, CommandIssuer issuer, String... args) {<a name="line.483"></a>
<span class="sourceLineNo">484</span> final Set&lt;RegisteredCommand&gt; defs = subCommands.get(subcommand);<a name="line.484"></a>
<span class="sourceLineNo">485</span> RegisteredCommand def = null;<a name="line.485"></a>
<span class="sourceLineNo">486</span> if (!defs.isEmpty()) {<a name="line.486"></a>
<span class="sourceLineNo">487</span> if (defs.size() == 1) {<a name="line.487"></a>
<span class="sourceLineNo">488</span> def = defs.iterator().next();<a name="line.488"></a>
<span class="sourceLineNo">489</span> }<a name="line.489"></a>
<span class="sourceLineNo">490</span> if (def != null) {<a name="line.490"></a>
<span class="sourceLineNo">491</span> executeCommand(commandContext, issuer, args, def);<a name="line.491"></a>
<span class="sourceLineNo">492</span> return true;<a name="line.492"></a>
<span class="sourceLineNo">493</span> }<a name="line.493"></a>
<span class="sourceLineNo">494</span> }<a name="line.494"></a>
<span class="sourceLineNo">495</span> return false;<a name="line.495"></a>
<span class="sourceLineNo">496</span> }<a name="line.496"></a>
<span class="sourceLineNo">497</span><a name="line.497"></a>
<span class="sourceLineNo">498</span> private boolean checkPrecommand(CommandOperationContext commandOperationContext, RegisteredCommand cmd, CommandIssuer issuer, String[] args) {<a name="line.498"></a>
<span class="sourceLineNo">499</span> Method pre = this.preCommandHandler;<a name="line.499"></a>
<span class="sourceLineNo">500</span> if (pre != null) {<a name="line.500"></a>
<span class="sourceLineNo">501</span> try {<a name="line.501"></a>
<span class="sourceLineNo">502</span> Class&lt;?&gt;[] types = pre.getParameterTypes();<a name="line.502"></a>
<span class="sourceLineNo">503</span> Object[] parameters = new Object[pre.getParameterCount()];<a name="line.503"></a>
<span class="sourceLineNo">504</span> for (int i = 0; i &lt; parameters.length; i++) {<a name="line.504"></a>
<span class="sourceLineNo">505</span> Class&lt;?&gt; type = types[i];<a name="line.505"></a>
<span class="sourceLineNo">506</span> Object issuerObject = issuer.getIssuer();<a name="line.506"></a>
<span class="sourceLineNo">507</span> if (manager.isCommandIssuer(type) &amp;&amp; type.isAssignableFrom(issuerObject.getClass())) {<a name="line.507"></a>
<span class="sourceLineNo">508</span> parameters[i] = issuerObject;<a name="line.508"></a>
<span class="sourceLineNo">509</span> } else if (CommandIssuer.class.isAssignableFrom(type)) {<a name="line.509"></a>
<span class="sourceLineNo">510</span> parameters[i] = issuer;<a name="line.510"></a>
<span class="sourceLineNo">511</span> } else if (RegisteredCommand.class.isAssignableFrom(type)) {<a name="line.511"></a>
<span class="sourceLineNo">512</span> parameters[i] = cmd;<a name="line.512"></a>
<span class="sourceLineNo">513</span> } else if (String[].class.isAssignableFrom((type))) {<a name="line.513"></a>
<span class="sourceLineNo">514</span> parameters[i] = args;<a name="line.514"></a>
<span class="sourceLineNo">515</span> } else {<a name="line.515"></a>
<span class="sourceLineNo">516</span> parameters[i] = null;<a name="line.516"></a>
<span class="sourceLineNo">517</span> }<a name="line.517"></a>
<span class="sourceLineNo">518</span> }<a name="line.518"></a>
<span class="sourceLineNo">519</span><a name="line.519"></a>
<span class="sourceLineNo">520</span> return (boolean) pre.invoke(this, parameters);<a name="line.520"></a>
<span class="sourceLineNo">521</span> } catch (IllegalAccessException | InvocationTargetException e) {<a name="line.521"></a>
<span class="sourceLineNo">522</span> this.manager.log(LogLevel.ERROR, "Exception encountered while command pre-processing", e);<a name="line.522"></a>
<span class="sourceLineNo">523</span> }<a name="line.523"></a>
<span class="sourceLineNo">524</span> }<a name="line.524"></a>
<span class="sourceLineNo">525</span> return false;<a name="line.525"></a>
<span class="sourceLineNo">526</span> }<a name="line.526"></a>
<span class="sourceLineNo">527</span><a name="line.527"></a>
<span class="sourceLineNo">528</span> /** @deprecated Unstable API */ @Deprecated @UnstableAPI<a name="line.528"></a>
<span class="sourceLineNo">529</span> public CommandHelp getCommandHelp() {<a name="line.529"></a>
<span class="sourceLineNo">530</span> return manager.generateCommandHelp();<a name="line.530"></a>
<span class="sourceLineNo">531</span> }<a name="line.531"></a>
<span class="sourceLineNo">532</span><a name="line.532"></a>
<span class="sourceLineNo">533</span> /** @deprecated Unstable API */ @Deprecated @UnstableAPI<a name="line.533"></a>
<span class="sourceLineNo">534</span> public void showCommandHelp() {<a name="line.534"></a>
<span class="sourceLineNo">535</span> getCommandHelp().showHelp();<a name="line.535"></a>
<span class="sourceLineNo">536</span> }<a name="line.536"></a>
<span class="sourceLineNo">537</span><a name="line.537"></a>
<span class="sourceLineNo">538</span> public void help(Object issuer, String[] args) {<a name="line.538"></a>
<span class="sourceLineNo">539</span> help(manager.getCommandIssuer(issuer), args);<a name="line.539"></a>
<span class="sourceLineNo">540</span> }<a name="line.540"></a>
<span class="sourceLineNo">541</span> public void help(CommandIssuer issuer, String[] args) {<a name="line.541"></a>
<span class="sourceLineNo">542</span> issuer.sendMessage(MessageType.ERROR, MessageKeys.UNKNOWN_COMMAND);<a name="line.542"></a>
<span class="sourceLineNo">543</span> }<a name="line.543"></a>
<span class="sourceLineNo">544</span> public void doHelp(Object issuer, String... args) {<a name="line.544"></a>
<span class="sourceLineNo">545</span> doHelp(manager.getCommandIssuer(issuer), args);<a name="line.545"></a>
<span class="sourceLineNo">482</span> RegisteredCommand getSubcommand(String subcommand) {<a name="line.482"></a>
<span class="sourceLineNo">483</span> return getSubcommand(subcommand, false);<a name="line.483"></a>
<span class="sourceLineNo">484</span> }<a name="line.484"></a>
<span class="sourceLineNo">485</span><a name="line.485"></a>
<span class="sourceLineNo">486</span> RegisteredCommand getSubcommand(String subcommand, boolean requireOne) {<a name="line.486"></a>
<span class="sourceLineNo">487</span> final Set&lt;RegisteredCommand&gt; commands = subCommands.get(subcommand);<a name="line.487"></a>
<span class="sourceLineNo">488</span> if (!commands.isEmpty() &amp;&amp; (!requireOne || commands.size() == 1)) {<a name="line.488"></a>
<span class="sourceLineNo">489</span> return commands.iterator().next();<a name="line.489"></a>
<span class="sourceLineNo">490</span> }<a name="line.490"></a>
<span class="sourceLineNo">491</span> return null;<a name="line.491"></a>
<span class="sourceLineNo">492</span> }<a name="line.492"></a>
<span class="sourceLineNo">493</span><a name="line.493"></a>
<span class="sourceLineNo">494</span> private boolean executeSubcommand(CommandOperationContext commandContext, String subcommand, CommandIssuer issuer, String... args) {<a name="line.494"></a>
<span class="sourceLineNo">495</span> final RegisteredCommand cmd = this.getSubcommand(subcommand);<a name="line.495"></a>
<span class="sourceLineNo">496</span> if (cmd != null) {<a name="line.496"></a>
<span class="sourceLineNo">497</span> executeCommand(commandContext, issuer, args, cmd);<a name="line.497"></a>
<span class="sourceLineNo">498</span> return true;<a name="line.498"></a>
<span class="sourceLineNo">499</span> }<a name="line.499"></a>
<span class="sourceLineNo">500</span><a name="line.500"></a>
<span class="sourceLineNo">501</span> return false;<a name="line.501"></a>
<span class="sourceLineNo">502</span> }<a name="line.502"></a>
<span class="sourceLineNo">503</span><a name="line.503"></a>
<span class="sourceLineNo">504</span> private boolean checkPrecommand(CommandOperationContext commandOperationContext, RegisteredCommand cmd, CommandIssuer issuer, String[] args) {<a name="line.504"></a>
<span class="sourceLineNo">505</span> Method pre = this.preCommandHandler;<a name="line.505"></a>
<span class="sourceLineNo">506</span> if (pre != null) {<a name="line.506"></a>
<span class="sourceLineNo">507</span> try {<a name="line.507"></a>
<span class="sourceLineNo">508</span> Class&lt;?&gt;[] types = pre.getParameterTypes();<a name="line.508"></a>
<span class="sourceLineNo">509</span> Object[] parameters = new Object[pre.getParameterCount()];<a name="line.509"></a>
<span class="sourceLineNo">510</span> for (int i = 0; i &lt; parameters.length; i++) {<a name="line.510"></a>
<span class="sourceLineNo">511</span> Class&lt;?&gt; type = types[i];<a name="line.511"></a>
<span class="sourceLineNo">512</span> Object issuerObject = issuer.getIssuer();<a name="line.512"></a>
<span class="sourceLineNo">513</span> if (manager.isCommandIssuer(type) &amp;&amp; type.isAssignableFrom(issuerObject.getClass())) {<a name="line.513"></a>
<span class="sourceLineNo">514</span> parameters[i] = issuerObject;<a name="line.514"></a>
<span class="sourceLineNo">515</span> } else if (CommandIssuer.class.isAssignableFrom(type)) {<a name="line.515"></a>
<span class="sourceLineNo">516</span> parameters[i] = issuer;<a name="line.516"></a>
<span class="sourceLineNo">517</span> } else if (RegisteredCommand.class.isAssignableFrom(type)) {<a name="line.517"></a>
<span class="sourceLineNo">518</span> parameters[i] = cmd;<a name="line.518"></a>
<span class="sourceLineNo">519</span> } else if (String[].class.isAssignableFrom((type))) {<a name="line.519"></a>
<span class="sourceLineNo">520</span> parameters[i] = args;<a name="line.520"></a>
<span class="sourceLineNo">521</span> } else {<a name="line.521"></a>
<span class="sourceLineNo">522</span> parameters[i] = null;<a name="line.522"></a>
<span class="sourceLineNo">523</span> }<a name="line.523"></a>
<span class="sourceLineNo">524</span> }<a name="line.524"></a>
<span class="sourceLineNo">525</span><a name="line.525"></a>
<span class="sourceLineNo">526</span> return (boolean) pre.invoke(this, parameters);<a name="line.526"></a>
<span class="sourceLineNo">527</span> } catch (IllegalAccessException | InvocationTargetException e) {<a name="line.527"></a>
<span class="sourceLineNo">528</span> this.manager.log(LogLevel.ERROR, "Exception encountered while command pre-processing", e);<a name="line.528"></a>
<span class="sourceLineNo">529</span> }<a name="line.529"></a>
<span class="sourceLineNo">530</span> }<a name="line.530"></a>
<span class="sourceLineNo">531</span> return false;<a name="line.531"></a>
<span class="sourceLineNo">532</span> }<a name="line.532"></a>
<span class="sourceLineNo">533</span><a name="line.533"></a>
<span class="sourceLineNo">534</span> /** @deprecated Unstable API */ @Deprecated @UnstableAPI<a name="line.534"></a>
<span class="sourceLineNo">535</span> public CommandHelp getCommandHelp() {<a name="line.535"></a>
<span class="sourceLineNo">536</span> return manager.generateCommandHelp();<a name="line.536"></a>
<span class="sourceLineNo">537</span> }<a name="line.537"></a>
<span class="sourceLineNo">538</span><a name="line.538"></a>
<span class="sourceLineNo">539</span> /** @deprecated Unstable API */ @Deprecated @UnstableAPI<a name="line.539"></a>
<span class="sourceLineNo">540</span> public void showCommandHelp() {<a name="line.540"></a>
<span class="sourceLineNo">541</span> getCommandHelp().showHelp();<a name="line.541"></a>
<span class="sourceLineNo">542</span> }<a name="line.542"></a>
<span class="sourceLineNo">543</span><a name="line.543"></a>
<span class="sourceLineNo">544</span> public void help(Object issuer, String[] args) {<a name="line.544"></a>
<span class="sourceLineNo">545</span> help(manager.getCommandIssuer(issuer), args);<a name="line.545"></a>
<span class="sourceLineNo">546</span> }<a name="line.546"></a>
<span class="sourceLineNo">547</span> public void doHelp(CommandIssuer issuer, String... args) {<a name="line.547"></a>
<span class="sourceLineNo">548</span> help(issuer, args);<a name="line.548"></a>
<span class="sourceLineNo">547</span> public void help(CommandIssuer issuer, String[] args) {<a name="line.547"></a>
<span class="sourceLineNo">548</span> issuer.sendMessage(MessageType.ERROR, MessageKeys.UNKNOWN_COMMAND);<a name="line.548"></a>
<span class="sourceLineNo">549</span> }<a name="line.549"></a>
<span class="sourceLineNo">550</span><a name="line.550"></a>
<span class="sourceLineNo">551</span> public void showSyntax(CommandIssuer issuer, RegisteredCommand&lt;?&gt; cmd) {<a name="line.551"></a>
<span class="sourceLineNo">552</span> issuer.sendMessage(MessageType.SYNTAX, MessageKeys.INVALID_SYNTAX,<a name="line.552"></a>
<span class="sourceLineNo">553</span> "{command}", "/" + cmd.command,<a name="line.553"></a>
<span class="sourceLineNo">554</span> "{syntax}", cmd.syntaxText<a name="line.554"></a>
<span class="sourceLineNo">555</span> );<a name="line.555"></a>
<span class="sourceLineNo">556</span> }<a name="line.556"></a>
<span class="sourceLineNo">557</span><a name="line.557"></a>
<span class="sourceLineNo">558</span> public boolean hasPermission(Object issuer) {<a name="line.558"></a>
<span class="sourceLineNo">559</span> return hasPermission(manager.getCommandIssuer(issuer));<a name="line.559"></a>
<span class="sourceLineNo">560</span> }<a name="line.560"></a>
<span class="sourceLineNo">561</span><a name="line.561"></a>
<span class="sourceLineNo">562</span> public boolean hasPermission(CommandIssuer issuer) {<a name="line.562"></a>
<span class="sourceLineNo">563</span> return permission == null || permission.isEmpty() || (manager.hasPermission(issuer, permission) &amp;&amp; (parentCommand == null || parentCommand.hasPermission(issuer)));<a name="line.563"></a>
<span class="sourceLineNo">564</span> }<a name="line.564"></a>
<span class="sourceLineNo">565</span><a name="line.565"></a>
<span class="sourceLineNo">566</span> public String getName() {<a name="line.566"></a>
<span class="sourceLineNo">567</span> return commandName;<a name="line.567"></a>
<span class="sourceLineNo">568</span> }<a name="line.568"></a>
<span class="sourceLineNo">569</span><a name="line.569"></a>
<span class="sourceLineNo">570</span> public ExceptionHandler getExceptionHandler() {<a name="line.570"></a>
<span class="sourceLineNo">571</span> return exceptionHandler;<a name="line.571"></a>
<span class="sourceLineNo">572</span> }<a name="line.572"></a>
<span class="sourceLineNo">573</span><a name="line.573"></a>
<span class="sourceLineNo">574</span> public BaseCommand setExceptionHandler(ExceptionHandler exceptionHandler) {<a name="line.574"></a>
<span class="sourceLineNo">575</span> this.exceptionHandler = exceptionHandler;<a name="line.575"></a>
<span class="sourceLineNo">576</span> return this;<a name="line.576"></a>
<span class="sourceLineNo">577</span> }<a name="line.577"></a>
<span class="sourceLineNo">578</span><a name="line.578"></a>
<span class="sourceLineNo">579</span> private static class CommandSearch { RegisteredCommand cmd; int argIndex; String checkSub;<a name="line.579"></a>
<span class="sourceLineNo">580</span><a name="line.580"></a>
<span class="sourceLineNo">581</span> CommandSearch(RegisteredCommand cmd, int argIndex, String checkSub) {<a name="line.581"></a>
<span class="sourceLineNo">582</span> this.cmd = cmd;<a name="line.582"></a>
<span class="sourceLineNo">583</span> this.argIndex = argIndex;<a name="line.583"></a>
<span class="sourceLineNo">584</span> this.checkSub = checkSub;<a name="line.584"></a>
<span class="sourceLineNo">585</span> }<a name="line.585"></a>
<span class="sourceLineNo">586</span><a name="line.586"></a>
<span class="sourceLineNo">587</span> String getCheckSub() {<a name="line.587"></a>
<span class="sourceLineNo">588</span> return this.checkSub;<a name="line.588"></a>
<span class="sourceLineNo">589</span> }<a name="line.589"></a>
<span class="sourceLineNo">550</span> public void doHelp(Object issuer, String... args) {<a name="line.550"></a>
<span class="sourceLineNo">551</span> doHelp(manager.getCommandIssuer(issuer), args);<a name="line.551"></a>
<span class="sourceLineNo">552</span> }<a name="line.552"></a>
<span class="sourceLineNo">553</span> public void doHelp(CommandIssuer issuer, String... args) {<a name="line.553"></a>
<span class="sourceLineNo">554</span> help(issuer, args);<a name="line.554"></a>
<span class="sourceLineNo">555</span> }<a name="line.555"></a>
<span class="sourceLineNo">556</span><a name="line.556"></a>
<span class="sourceLineNo">557</span> public void showSyntax(CommandIssuer issuer, RegisteredCommand&lt;?&gt; cmd) {<a name="line.557"></a>
<span class="sourceLineNo">558</span> issuer.sendMessage(MessageType.SYNTAX, MessageKeys.INVALID_SYNTAX,<a name="line.558"></a>
<span class="sourceLineNo">559</span> "{command}", "/" + cmd.command,<a name="line.559"></a>
<span class="sourceLineNo">560</span> "{syntax}", cmd.syntaxText<a name="line.560"></a>
<span class="sourceLineNo">561</span> );<a name="line.561"></a>
<span class="sourceLineNo">562</span> }<a name="line.562"></a>
<span class="sourceLineNo">563</span><a name="line.563"></a>
<span class="sourceLineNo">564</span> public boolean hasPermission(Object issuer) {<a name="line.564"></a>
<span class="sourceLineNo">565</span> return hasPermission(manager.getCommandIssuer(issuer));<a name="line.565"></a>
<span class="sourceLineNo">566</span> }<a name="line.566"></a>
<span class="sourceLineNo">567</span><a name="line.567"></a>
<span class="sourceLineNo">568</span> public boolean hasPermission(CommandIssuer issuer) {<a name="line.568"></a>
<span class="sourceLineNo">569</span> return permission == null || permission.isEmpty() || (manager.hasPermission(issuer, permission) &amp;&amp; (parentCommand == null || parentCommand.hasPermission(issuer)));<a name="line.569"></a>
<span class="sourceLineNo">570</span> }<a name="line.570"></a>
<span class="sourceLineNo">571</span><a name="line.571"></a>
<span class="sourceLineNo">572</span> public String getName() {<a name="line.572"></a>
<span class="sourceLineNo">573</span> return commandName;<a name="line.573"></a>
<span class="sourceLineNo">574</span> }<a name="line.574"></a>
<span class="sourceLineNo">575</span><a name="line.575"></a>
<span class="sourceLineNo">576</span> public ExceptionHandler getExceptionHandler() {<a name="line.576"></a>
<span class="sourceLineNo">577</span> return exceptionHandler;<a name="line.577"></a>
<span class="sourceLineNo">578</span> }<a name="line.578"></a>
<span class="sourceLineNo">579</span><a name="line.579"></a>
<span class="sourceLineNo">580</span> public BaseCommand setExceptionHandler(ExceptionHandler exceptionHandler) {<a name="line.580"></a>
<span class="sourceLineNo">581</span> this.exceptionHandler = exceptionHandler;<a name="line.581"></a>
<span class="sourceLineNo">582</span> return this;<a name="line.582"></a>
<span class="sourceLineNo">583</span> }<a name="line.583"></a>
<span class="sourceLineNo">584</span><a name="line.584"></a>
<span class="sourceLineNo">585</span> public RegisteredCommand getDefaultRegisteredCommand() {<a name="line.585"></a>
<span class="sourceLineNo">586</span> return this.getSubcommand(DEFAULT);<a name="line.586"></a>
<span class="sourceLineNo">587</span> }<a name="line.587"></a>
<span class="sourceLineNo">588</span><a name="line.588"></a>
<span class="sourceLineNo">589</span> private static class CommandSearch { RegisteredCommand cmd; int argIndex; String checkSub;<a name="line.589"></a>
<span class="sourceLineNo">590</span><a name="line.590"></a>
<span class="sourceLineNo">591</span> @Override<a name="line.591"></a>
<span class="sourceLineNo">592</span> public boolean equals(Object o) {<a name="line.592"></a>
<span class="sourceLineNo">593</span> if (this == o) return true;<a name="line.593"></a>
<span class="sourceLineNo">594</span> if (o == null || getClass() != o.getClass()) return false;<a name="line.594"></a>
<span class="sourceLineNo">595</span> CommandSearch that = (CommandSearch) o;<a name="line.595"></a>
<span class="sourceLineNo">596</span> return argIndex == that.argIndex &amp;&amp;<a name="line.596"></a>
<span class="sourceLineNo">597</span> Objects.equals(cmd, that.cmd) &amp;&amp;<a name="line.597"></a>
<span class="sourceLineNo">598</span> Objects.equals(checkSub, that.checkSub);<a name="line.598"></a>
<span class="sourceLineNo">591</span> CommandSearch(RegisteredCommand cmd, int argIndex, String checkSub) {<a name="line.591"></a>
<span class="sourceLineNo">592</span> this.cmd = cmd;<a name="line.592"></a>
<span class="sourceLineNo">593</span> this.argIndex = argIndex;<a name="line.593"></a>
<span class="sourceLineNo">594</span> this.checkSub = checkSub;<a name="line.594"></a>
<span class="sourceLineNo">595</span> }<a name="line.595"></a>
<span class="sourceLineNo">596</span><a name="line.596"></a>
<span class="sourceLineNo">597</span> String getCheckSub() {<a name="line.597"></a>
<span class="sourceLineNo">598</span> return this.checkSub;<a name="line.598"></a>
<span class="sourceLineNo">599</span> }<a name="line.599"></a>
<span class="sourceLineNo">600</span><a name="line.600"></a>
<span class="sourceLineNo">601</span> @Override<a name="line.601"></a>
<span class="sourceLineNo">602</span> public int hashCode() {<a name="line.602"></a>
<span class="sourceLineNo">603</span> return Objects.hash(cmd, argIndex, checkSub);<a name="line.603"></a>
<span class="sourceLineNo">604</span> }<a name="line.604"></a>
<span class="sourceLineNo">605</span> }<a name="line.605"></a>
<span class="sourceLineNo">606</span>}<a name="line.606"></a>
<span class="sourceLineNo">602</span> public boolean equals(Object o) {<a name="line.602"></a>
<span class="sourceLineNo">603</span> if (this == o) return true;<a name="line.603"></a>
<span class="sourceLineNo">604</span> if (o == null || getClass() != o.getClass()) return false;<a name="line.604"></a>
<span class="sourceLineNo">605</span> CommandSearch that = (CommandSearch) o;<a name="line.605"></a>
<span class="sourceLineNo">606</span> return argIndex == that.argIndex &amp;&amp;<a name="line.606"></a>
<span class="sourceLineNo">607</span> Objects.equals(cmd, that.cmd) &amp;&amp;<a name="line.607"></a>
<span class="sourceLineNo">608</span> Objects.equals(checkSub, that.checkSub);<a name="line.608"></a>
<span class="sourceLineNo">609</span> }<a name="line.609"></a>
<span class="sourceLineNo">610</span><a name="line.610"></a>
<span class="sourceLineNo">611</span> @Override<a name="line.611"></a>
<span class="sourceLineNo">612</span> public int hashCode() {<a name="line.612"></a>
<span class="sourceLineNo">613</span> return Objects.hash(cmd, argIndex, checkSub);<a name="line.613"></a>
<span class="sourceLineNo">614</span> }<a name="line.614"></a>
<span class="sourceLineNo">615</span> }<a name="line.615"></a>
<span class="sourceLineNo">616</span>}<a name="line.616"></a>
@@ -176,72 +176,76 @@
<span class="sourceLineNo">168</span> }<a name="line.168"></a>
<span class="sourceLineNo">169</span> CommandHelp commandHelp = manager.generateCommandHelp();<a name="line.169"></a>
<span class="sourceLineNo">170</span> commandHelp.setPage(page);<a name="line.170"></a>
<span class="sourceLineNo">171</span> commandHelp.setSearch(search);<a name="line.171"></a>
<span class="sourceLineNo">172</span> return commandHelp;<a name="line.172"></a>
<span class="sourceLineNo">173</span> });<a name="line.173"></a>
<span class="sourceLineNo">174</span> }<a name="line.174"></a>
<span class="sourceLineNo">175</span><a name="line.175"></a>
<span class="sourceLineNo">176</span> /**<a name="line.176"></a>
<span class="sourceLineNo">177</span> * @deprecated Please switch to {@link #registerIssuerAwareContext(Class, IssuerAwareContextResolver)}<a name="line.177"></a>
<span class="sourceLineNo">178</span> * as the core wants to use the platform agnostic term of "Issuer" instead of Sender<a name="line.178"></a>
<span class="sourceLineNo">179</span> * @see #registerIssuerAwareContext(Class, IssuerAwareContextResolver)<a name="line.179"></a>
<span class="sourceLineNo">180</span> */<a name="line.180"></a>
<span class="sourceLineNo">181</span> @Deprecated<a name="line.181"></a>
<span class="sourceLineNo">182</span> public &lt;T&gt; void registerSenderAwareContext(Class&lt;T&gt; context, IssuerAwareContextResolver&lt;T, R&gt; supplier) {<a name="line.182"></a>
<span class="sourceLineNo">183</span> contextMap.put(context, supplier);<a name="line.183"></a>
<span class="sourceLineNo">184</span> }<a name="line.184"></a>
<span class="sourceLineNo">185</span><a name="line.185"></a>
<span class="sourceLineNo">186</span> /**<a name="line.186"></a>
<span class="sourceLineNo">187</span> * Registers a context resolver that may conditionally consume input, falling back to using the context of the<a name="line.187"></a>
<span class="sourceLineNo">188</span> * issuer to potentially fulfill this context.<a name="line.188"></a>
<span class="sourceLineNo">189</span> * You may call {@link CommandExecutionContext#getFirstArg()} and then conditionally call {@link CommandExecutionContext#popFirstArg()}<a name="line.189"></a>
<span class="sourceLineNo">190</span> * if you want to consume that input.<a name="line.190"></a>
<span class="sourceLineNo">191</span> */<a name="line.191"></a>
<span class="sourceLineNo">192</span> public &lt;T&gt; void registerIssuerAwareContext(Class&lt;T&gt; context, IssuerAwareContextResolver&lt;T, R&gt; supplier) {<a name="line.192"></a>
<span class="sourceLineNo">193</span> contextMap.put(context, supplier);<a name="line.193"></a>
<span class="sourceLineNo">194</span> }<a name="line.194"></a>
<span class="sourceLineNo">195</span><a name="line.195"></a>
<span class="sourceLineNo">196</span> /**<a name="line.196"></a>
<span class="sourceLineNo">197</span> * Registers a context resolver that will never consume input. It will always satisfy its context based on the<a name="line.197"></a>
<span class="sourceLineNo">198</span> * issuer of the command, so it will not appear in syntax strings.<a name="line.198"></a>
<span class="sourceLineNo">199</span> */<a name="line.199"></a>
<span class="sourceLineNo">200</span> public &lt;T&gt; void registerIssuerOnlyContext(Class&lt;T&gt; context, IssuerOnlyContextResolver&lt;T, R&gt; supplier) {<a name="line.200"></a>
<span class="sourceLineNo">201</span> contextMap.put(context, supplier);<a name="line.201"></a>
<span class="sourceLineNo">202</span> }<a name="line.202"></a>
<span class="sourceLineNo">203</span><a name="line.203"></a>
<span class="sourceLineNo">204</span> /**<a name="line.204"></a>
<span class="sourceLineNo">205</span> * Registers a context that can safely accept a null input from the command issuer to resolve. This resolver should always<a name="line.205"></a>
<span class="sourceLineNo">206</span> * call {@link CommandExecutionContext#popFirstArg()}<a name="line.206"></a>
<span class="sourceLineNo">207</span> */<a name="line.207"></a>
<span class="sourceLineNo">208</span> public &lt;T&gt; void registerOptionalContext(Class&lt;T&gt; context, OptionalContextResolver&lt;T, R&gt; supplier) {<a name="line.208"></a>
<span class="sourceLineNo">209</span> contextMap.put(context, supplier);<a name="line.209"></a>
<span class="sourceLineNo">210</span> }<a name="line.210"></a>
<span class="sourceLineNo">211</span><a name="line.211"></a>
<span class="sourceLineNo">212</span> /**<a name="line.212"></a>
<span class="sourceLineNo">213</span> * Registers a context that requires input from the command issuer to resolve. This resolver should always<a name="line.213"></a>
<span class="sourceLineNo">214</span> * call {@link CommandExecutionContext#popFirstArg()}<a name="line.214"></a>
<span class="sourceLineNo">215</span> */<a name="line.215"></a>
<span class="sourceLineNo">216</span> public &lt;T&gt; void registerContext(Class&lt;T&gt; context, ContextResolver&lt;T, R&gt; supplier) {<a name="line.216"></a>
<span class="sourceLineNo">217</span> contextMap.put(context, supplier);<a name="line.217"></a>
<span class="sourceLineNo">218</span> }<a name="line.218"></a>
<span class="sourceLineNo">219</span><a name="line.219"></a>
<span class="sourceLineNo">220</span> public ContextResolver&lt;?, R&gt; getResolver(Class&lt;?&gt; type) {<a name="line.220"></a>
<span class="sourceLineNo">221</span> Class&lt;?&gt; rootType = type;<a name="line.221"></a>
<span class="sourceLineNo">222</span> do {<a name="line.222"></a>
<span class="sourceLineNo">223</span> if (type == Object.class) {<a name="line.223"></a>
<span class="sourceLineNo">224</span> break;<a name="line.224"></a>
<span class="sourceLineNo">225</span> }<a name="line.225"></a>
<span class="sourceLineNo">226</span><a name="line.226"></a>
<span class="sourceLineNo">227</span> final ContextResolver&lt;?, R&gt; resolver = contextMap.get(type);<a name="line.227"></a>
<span class="sourceLineNo">228</span> if (resolver != null) {<a name="line.228"></a>
<span class="sourceLineNo">229</span> return resolver;<a name="line.229"></a>
<span class="sourceLineNo">230</span> }<a name="line.230"></a>
<span class="sourceLineNo">231</span> } while ((type = type.getSuperclass()) != null);<a name="line.231"></a>
<span class="sourceLineNo">232</span><a name="line.232"></a>
<span class="sourceLineNo">233</span> this.manager.log(LogLevel.ERROR, "Could not find context resolver", new IllegalStateException("No context resolver defined for " + rootType.getName()));<a name="line.233"></a>
<span class="sourceLineNo">234</span> return null;<a name="line.234"></a>
<span class="sourceLineNo">235</span> }<a name="line.235"></a>
<span class="sourceLineNo">236</span>}<a name="line.236"></a>
<span class="sourceLineNo">171</span> Integer perPage = c.getFlagValue("perpage", (Integer) null);<a name="line.171"></a>
<span class="sourceLineNo">172</span> if (perPage != null) {<a name="line.172"></a>
<span class="sourceLineNo">173</span> commandHelp.setPerPage(perPage);<a name="line.173"></a>
<span class="sourceLineNo">174</span> }<a name="line.174"></a>
<span class="sourceLineNo">175</span> commandHelp.setSearch(search);<a name="line.175"></a>
<span class="sourceLineNo">176</span> return commandHelp;<a name="line.176"></a>
<span class="sourceLineNo">177</span> });<a name="line.177"></a>
<span class="sourceLineNo">178</span> }<a name="line.178"></a>
<span class="sourceLineNo">179</span><a name="line.179"></a>
<span class="sourceLineNo">180</span> /**<a name="line.180"></a>
<span class="sourceLineNo">181</span> * @deprecated Please switch to {@link #registerIssuerAwareContext(Class, IssuerAwareContextResolver)}<a name="line.181"></a>
<span class="sourceLineNo">182</span> * as the core wants to use the platform agnostic term of "Issuer" instead of Sender<a name="line.182"></a>
<span class="sourceLineNo">183</span> * @see #registerIssuerAwareContext(Class, IssuerAwareContextResolver)<a name="line.183"></a>
<span class="sourceLineNo">184</span> */<a name="line.184"></a>
<span class="sourceLineNo">185</span> @Deprecated<a name="line.185"></a>
<span class="sourceLineNo">186</span> public &lt;T&gt; void registerSenderAwareContext(Class&lt;T&gt; context, IssuerAwareContextResolver&lt;T, R&gt; supplier) {<a name="line.186"></a>
<span class="sourceLineNo">187</span> contextMap.put(context, supplier);<a name="line.187"></a>
<span class="sourceLineNo">188</span> }<a name="line.188"></a>
<span class="sourceLineNo">189</span><a name="line.189"></a>
<span class="sourceLineNo">190</span> /**<a name="line.190"></a>
<span class="sourceLineNo">191</span> * Registers a context resolver that may conditionally consume input, falling back to using the context of the<a name="line.191"></a>
<span class="sourceLineNo">192</span> * issuer to potentially fulfill this context.<a name="line.192"></a>
<span class="sourceLineNo">193</span> * You may call {@link CommandExecutionContext#getFirstArg()} and then conditionally call {@link CommandExecutionContext#popFirstArg()}<a name="line.193"></a>
<span class="sourceLineNo">194</span> * if you want to consume that input.<a name="line.194"></a>
<span class="sourceLineNo">195</span> */<a name="line.195"></a>
<span class="sourceLineNo">196</span> public &lt;T&gt; void registerIssuerAwareContext(Class&lt;T&gt; context, IssuerAwareContextResolver&lt;T, R&gt; supplier) {<a name="line.196"></a>
<span class="sourceLineNo">197</span> contextMap.put(context, supplier);<a name="line.197"></a>
<span class="sourceLineNo">198</span> }<a name="line.198"></a>
<span class="sourceLineNo">199</span><a name="line.199"></a>
<span class="sourceLineNo">200</span> /**<a name="line.200"></a>
<span class="sourceLineNo">201</span> * Registers a context resolver that will never consume input. It will always satisfy its context based on the<a name="line.201"></a>
<span class="sourceLineNo">202</span> * issuer of the command, so it will not appear in syntax strings.<a name="line.202"></a>
<span class="sourceLineNo">203</span> */<a name="line.203"></a>
<span class="sourceLineNo">204</span> public &lt;T&gt; void registerIssuerOnlyContext(Class&lt;T&gt; context, IssuerOnlyContextResolver&lt;T, R&gt; supplier) {<a name="line.204"></a>
<span class="sourceLineNo">205</span> contextMap.put(context, supplier);<a name="line.205"></a>
<span class="sourceLineNo">206</span> }<a name="line.206"></a>
<span class="sourceLineNo">207</span><a name="line.207"></a>
<span class="sourceLineNo">208</span> /**<a name="line.208"></a>
<span class="sourceLineNo">209</span> * Registers a context that can safely accept a null input from the command issuer to resolve. This resolver should always<a name="line.209"></a>
<span class="sourceLineNo">210</span> * call {@link CommandExecutionContext#popFirstArg()}<a name="line.210"></a>
<span class="sourceLineNo">211</span> */<a name="line.211"></a>
<span class="sourceLineNo">212</span> public &lt;T&gt; void registerOptionalContext(Class&lt;T&gt; context, OptionalContextResolver&lt;T, R&gt; supplier) {<a name="line.212"></a>
<span class="sourceLineNo">213</span> contextMap.put(context, supplier);<a name="line.213"></a>
<span class="sourceLineNo">214</span> }<a name="line.214"></a>
<span class="sourceLineNo">215</span><a name="line.215"></a>
<span class="sourceLineNo">216</span> /**<a name="line.216"></a>
<span class="sourceLineNo">217</span> * Registers a context that requires input from the command issuer to resolve. This resolver should always<a name="line.217"></a>
<span class="sourceLineNo">218</span> * call {@link CommandExecutionContext#popFirstArg()}<a name="line.218"></a>
<span class="sourceLineNo">219</span> */<a name="line.219"></a>
<span class="sourceLineNo">220</span> public &lt;T&gt; void registerContext(Class&lt;T&gt; context, ContextResolver&lt;T, R&gt; supplier) {<a name="line.220"></a>
<span class="sourceLineNo">221</span> contextMap.put(context, supplier);<a name="line.221"></a>
<span class="sourceLineNo">222</span> }<a name="line.222"></a>
<span class="sourceLineNo">223</span><a name="line.223"></a>
<span class="sourceLineNo">224</span> public ContextResolver&lt;?, R&gt; getResolver(Class&lt;?&gt; type) {<a name="line.224"></a>
<span class="sourceLineNo">225</span> Class&lt;?&gt; rootType = type;<a name="line.225"></a>
<span class="sourceLineNo">226</span> do {<a name="line.226"></a>
<span class="sourceLineNo">227</span> if (type == Object.class) {<a name="line.227"></a>
<span class="sourceLineNo">228</span> break;<a name="line.228"></a>
<span class="sourceLineNo">229</span> }<a name="line.229"></a>
<span class="sourceLineNo">230</span><a name="line.230"></a>
<span class="sourceLineNo">231</span> final ContextResolver&lt;?, R&gt; resolver = contextMap.get(type);<a name="line.231"></a>
<span class="sourceLineNo">232</span> if (resolver != null) {<a name="line.232"></a>
<span class="sourceLineNo">233</span> return resolver;<a name="line.233"></a>
<span class="sourceLineNo">234</span> }<a name="line.234"></a>
<span class="sourceLineNo">235</span> } while ((type = type.getSuperclass()) != null);<a name="line.235"></a>
<span class="sourceLineNo">236</span><a name="line.236"></a>
<span class="sourceLineNo">237</span> this.manager.log(LogLevel.ERROR, "Could not find context resolver", new IllegalStateException("No context resolver defined for " + rootType.getName()));<a name="line.237"></a>
<span class="sourceLineNo">238</span> return null;<a name="line.238"></a>
<span class="sourceLineNo">239</span> }<a name="line.239"></a>
<span class="sourceLineNo">240</span>}<a name="line.240"></a>
@@ -37,129 +37,163 @@
<span class="sourceLineNo">029</span><a name="line.29"></a>
<span class="sourceLineNo">030</span>import java.util.*;<a name="line.30"></a>
<span class="sourceLineNo">031</span>import java.util.regex.Pattern;<a name="line.31"></a>
<span class="sourceLineNo">032</span>import java.util.stream.Stream;<a name="line.32"></a>
<span class="sourceLineNo">033</span><a name="line.33"></a>
<span class="sourceLineNo">034</span>@SuppressWarnings("WeakerAccess")<a name="line.34"></a>
<span class="sourceLineNo">035</span>public class CommandHelp {<a name="line.35"></a>
<span class="sourceLineNo">036</span> private final CommandManager manager;<a name="line.36"></a>
<span class="sourceLineNo">037</span> private final CommandIssuer issuer;<a name="line.37"></a>
<span class="sourceLineNo">038</span> private final List&lt;HelpEntry&gt; helpEntries = new ArrayList&lt;&gt;();<a name="line.38"></a>
<span class="sourceLineNo">039</span> private int page;<a name="line.39"></a>
<span class="sourceLineNo">032</span><a name="line.32"></a>
<span class="sourceLineNo">033</span>@SuppressWarnings("WeakerAccess")<a name="line.33"></a>
<span class="sourceLineNo">034</span>public class CommandHelp {<a name="line.34"></a>
<span class="sourceLineNo">035</span> private final CommandManager manager;<a name="line.35"></a>
<span class="sourceLineNo">036</span> private final CommandIssuer issuer;<a name="line.36"></a>
<span class="sourceLineNo">037</span> private final List&lt;HelpEntry&gt; helpEntries = new ArrayList&lt;&gt;();<a name="line.37"></a>
<span class="sourceLineNo">038</span> private int page;<a name="line.38"></a>
<span class="sourceLineNo">039</span> private int perPage;<a name="line.39"></a>
<span class="sourceLineNo">040</span> private List&lt;String&gt; search;<a name="line.40"></a>
<span class="sourceLineNo">041</span><a name="line.41"></a>
<span class="sourceLineNo">042</span> public CommandHelp(CommandManager manager, RootCommand rootCommand, CommandIssuer issuer) {<a name="line.42"></a>
<span class="sourceLineNo">043</span> this.manager = manager;<a name="line.43"></a>
<span class="sourceLineNo">044</span> this.issuer = issuer;<a name="line.44"></a>
<span class="sourceLineNo">045</span><a name="line.45"></a>
<span class="sourceLineNo">046</span> SetMultimap&lt;String, RegisteredCommand&gt; subCommands = rootCommand.getSubCommands();<a name="line.46"></a>
<span class="sourceLineNo">047</span> Set&lt;RegisteredCommand&gt; seen = new HashSet&lt;&gt;();<a name="line.47"></a>
<span class="sourceLineNo">048</span> subCommands.entries().forEach(e -&gt; {<a name="line.48"></a>
<span class="sourceLineNo">049</span> String key = e.getKey();<a name="line.49"></a>
<span class="sourceLineNo">050</span> if (key.equals("__default") || key.equals("__unknown")){<a name="line.50"></a>
<span class="sourceLineNo">051</span> return;<a name="line.51"></a>
<span class="sourceLineNo">052</span> }<a name="line.52"></a>
<span class="sourceLineNo">053</span><a name="line.53"></a>
<span class="sourceLineNo">054</span> RegisteredCommand regCommand = e.getValue();<a name="line.54"></a>
<span class="sourceLineNo">055</span> if (regCommand.hasPermission(issuer) &amp;&amp; !seen.contains(regCommand)) {<a name="line.55"></a>
<span class="sourceLineNo">056</span> this.helpEntries.add(new HelpEntry(regCommand));<a name="line.56"></a>
<span class="sourceLineNo">057</span> seen.add(regCommand);<a name="line.57"></a>
<span class="sourceLineNo">058</span> }<a name="line.58"></a>
<span class="sourceLineNo">059</span> });<a name="line.59"></a>
<span class="sourceLineNo">060</span> }<a name="line.60"></a>
<span class="sourceLineNo">061</span><a name="line.61"></a>
<span class="sourceLineNo">062</span> @UnstableAPI // Not sure on this one yet even when API becomes unstable<a name="line.62"></a>
<span class="sourceLineNo">063</span> protected void updateSearchScore(HelpEntry help) {<a name="line.63"></a>
<span class="sourceLineNo">064</span> if (this.search == null || this.search.isEmpty()) {<a name="line.64"></a>
<span class="sourceLineNo">065</span> help.setSearchScore(1);<a name="line.65"></a>
<span class="sourceLineNo">066</span> return;<a name="line.66"></a>
<span class="sourceLineNo">067</span> }<a name="line.67"></a>
<span class="sourceLineNo">068</span> final RegisteredCommand&lt;?&gt; cmd = help.getRegisteredCommand();<a name="line.68"></a>
<span class="sourceLineNo">069</span><a name="line.69"></a>
<span class="sourceLineNo">070</span> int searchScore = 0;<a name="line.70"></a>
<span class="sourceLineNo">071</span> for (String word : this.search) {<a name="line.71"></a>
<span class="sourceLineNo">072</span> Pattern pattern = Pattern.compile(".*" + Pattern.quote(word) + ".*", Pattern.CASE_INSENSITIVE);<a name="line.72"></a>
<span class="sourceLineNo">073</span> for (String subCmd : cmd.registeredSubcommands) {<a name="line.73"></a>
<span class="sourceLineNo">074</span> Pattern subCmdPattern = Pattern.compile(".*" + Pattern.quote(subCmd) + ".*", Pattern.CASE_INSENSITIVE);<a name="line.74"></a>
<span class="sourceLineNo">075</span> if (pattern.matcher(subCmd).matches()) {<a name="line.75"></a>
<span class="sourceLineNo">076</span> searchScore += 3;<a name="line.76"></a>
<span class="sourceLineNo">077</span> } else if (subCmdPattern.matcher(word).matches()) {<a name="line.77"></a>
<span class="sourceLineNo">078</span> searchScore++;<a name="line.78"></a>
<span class="sourceLineNo">079</span> }<a name="line.79"></a>
<span class="sourceLineNo">080</span> }<a name="line.80"></a>
<span class="sourceLineNo">081</span><a name="line.81"></a>
<span class="sourceLineNo">045</span> this.perPage = manager.defaultHelpPerPage;<a name="line.45"></a>
<span class="sourceLineNo">046</span><a name="line.46"></a>
<span class="sourceLineNo">047</span> SetMultimap&lt;String, RegisteredCommand&gt; subCommands = rootCommand.getSubCommands();<a name="line.47"></a>
<span class="sourceLineNo">048</span> Set&lt;RegisteredCommand&gt; seen = new HashSet&lt;&gt;();<a name="line.48"></a>
<span class="sourceLineNo">049</span> subCommands.entries().forEach(e -&gt; {<a name="line.49"></a>
<span class="sourceLineNo">050</span> String key = e.getKey();<a name="line.50"></a>
<span class="sourceLineNo">051</span> if (key.equals("__default") || key.equals("__unknown")){<a name="line.51"></a>
<span class="sourceLineNo">052</span> return;<a name="line.52"></a>
<span class="sourceLineNo">053</span> }<a name="line.53"></a>
<span class="sourceLineNo">054</span><a name="line.54"></a>
<span class="sourceLineNo">055</span> RegisteredCommand regCommand = e.getValue();<a name="line.55"></a>
<span class="sourceLineNo">056</span> if (regCommand.hasPermission(issuer) &amp;&amp; !seen.contains(regCommand)) {<a name="line.56"></a>
<span class="sourceLineNo">057</span> this.helpEntries.add(new HelpEntry(regCommand));<a name="line.57"></a>
<span class="sourceLineNo">058</span> seen.add(regCommand);<a name="line.58"></a>
<span class="sourceLineNo">059</span> }<a name="line.59"></a>
<span class="sourceLineNo">060</span> });<a name="line.60"></a>
<span class="sourceLineNo">061</span> }<a name="line.61"></a>
<span class="sourceLineNo">062</span><a name="line.62"></a>
<span class="sourceLineNo">063</span> @UnstableAPI // Not sure on this one yet even when API becomes unstable<a name="line.63"></a>
<span class="sourceLineNo">064</span> protected void updateSearchScore(HelpEntry help) {<a name="line.64"></a>
<span class="sourceLineNo">065</span> if (this.search == null || this.search.isEmpty()) {<a name="line.65"></a>
<span class="sourceLineNo">066</span> help.setSearchScore(1);<a name="line.66"></a>
<span class="sourceLineNo">067</span> return;<a name="line.67"></a>
<span class="sourceLineNo">068</span> }<a name="line.68"></a>
<span class="sourceLineNo">069</span> final RegisteredCommand&lt;?&gt; cmd = help.getRegisteredCommand();<a name="line.69"></a>
<span class="sourceLineNo">070</span><a name="line.70"></a>
<span class="sourceLineNo">071</span> int searchScore = 0;<a name="line.71"></a>
<span class="sourceLineNo">072</span> for (String word : this.search) {<a name="line.72"></a>
<span class="sourceLineNo">073</span> Pattern pattern = Pattern.compile(".*" + Pattern.quote(word) + ".*", Pattern.CASE_INSENSITIVE);<a name="line.73"></a>
<span class="sourceLineNo">074</span> for (String subCmd : cmd.registeredSubcommands) {<a name="line.74"></a>
<span class="sourceLineNo">075</span> Pattern subCmdPattern = Pattern.compile(".*" + Pattern.quote(subCmd) + ".*", Pattern.CASE_INSENSITIVE);<a name="line.75"></a>
<span class="sourceLineNo">076</span> if (pattern.matcher(subCmd).matches()) {<a name="line.76"></a>
<span class="sourceLineNo">077</span> searchScore += 3;<a name="line.77"></a>
<span class="sourceLineNo">078</span> } else if (subCmdPattern.matcher(word).matches()) {<a name="line.78"></a>
<span class="sourceLineNo">079</span> searchScore++;<a name="line.79"></a>
<span class="sourceLineNo">080</span> }<a name="line.80"></a>
<span class="sourceLineNo">081</span> }<a name="line.81"></a>
<span class="sourceLineNo">082</span><a name="line.82"></a>
<span class="sourceLineNo">083</span> if (pattern.matcher(help.getDescription()).matches()) {<a name="line.83"></a>
<span class="sourceLineNo">084</span> searchScore += 2;<a name="line.84"></a>
<span class="sourceLineNo">085</span> }<a name="line.85"></a>
<span class="sourceLineNo">086</span> if (pattern.matcher(help.getParameterSyntax()).matches()) {<a name="line.86"></a>
<span class="sourceLineNo">087</span> searchScore++;<a name="line.87"></a>
<span class="sourceLineNo">088</span> }<a name="line.88"></a>
<span class="sourceLineNo">089</span> if (help.getSearchTags() != null &amp;&amp; pattern.matcher(help.getSearchTags()).matches()) {<a name="line.89"></a>
<span class="sourceLineNo">090</span> searchScore += 2;<a name="line.90"></a>
<span class="sourceLineNo">091</span> }<a name="line.91"></a>
<span class="sourceLineNo">092</span> }<a name="line.92"></a>
<span class="sourceLineNo">093</span> help.setSearchScore(searchScore);<a name="line.93"></a>
<span class="sourceLineNo">094</span> }<a name="line.94"></a>
<span class="sourceLineNo">095</span><a name="line.95"></a>
<span class="sourceLineNo">096</span> public CommandManager getManager() {<a name="line.96"></a>
<span class="sourceLineNo">097</span> return manager;<a name="line.97"></a>
<span class="sourceLineNo">098</span> }<a name="line.98"></a>
<span class="sourceLineNo">099</span><a name="line.99"></a>
<span class="sourceLineNo">100</span> public void showHelp() {<a name="line.100"></a>
<span class="sourceLineNo">101</span> showHelp(issuer, MessageKeys.HELP_FORMAT);<a name="line.101"></a>
<span class="sourceLineNo">102</span> }<a name="line.102"></a>
<span class="sourceLineNo">103</span><a name="line.103"></a>
<span class="sourceLineNo">104</span> public void showHelp(CommandIssuer issuer) {<a name="line.104"></a>
<span class="sourceLineNo">105</span> showHelp(issuer, MessageKeys.HELP_FORMAT);<a name="line.105"></a>
<span class="sourceLineNo">106</span> }<a name="line.106"></a>
<span class="sourceLineNo">107</span><a name="line.107"></a>
<span class="sourceLineNo">108</span> public void showHelp(CommandIssuer issuer, MessageKeyProvider format) {<a name="line.108"></a>
<span class="sourceLineNo">109</span> Iterator&lt;HelpEntry&gt; results = getHelpEntries().stream()<a name="line.109"></a>
<span class="sourceLineNo">110</span> .filter(HelpEntry::shouldShow)<a name="line.110"></a>
<span class="sourceLineNo">111</span> .sorted(Comparator.comparingInt(helpEntry -&gt; helpEntry.getSearchScore() * -1)).iterator();<a name="line.111"></a>
<span class="sourceLineNo">112</span> if (!results.hasNext()) {<a name="line.112"></a>
<span class="sourceLineNo">113</span> issuer.sendMessage(MessageType.ERROR, MessageKeys.NO_COMMAND_MATCHED_SEARCH, "{search}", ACFUtil.join(this.search, " "));<a name="line.113"></a>
<span class="sourceLineNo">114</span> results = getHelpEntries().iterator();<a name="line.114"></a>
<span class="sourceLineNo">115</span> }<a name="line.115"></a>
<span class="sourceLineNo">116</span><a name="line.116"></a>
<span class="sourceLineNo">117</span> while (results.hasNext()) {<a name="line.117"></a>
<span class="sourceLineNo">118</span> HelpEntry e = results.next();<a name="line.118"></a>
<span class="sourceLineNo">119</span> String formatted = this.manager.formatMessage(issuer, MessageType.HELP, format, getFormatReplacements(e));<a name="line.119"></a>
<span class="sourceLineNo">120</span> for (String msg : ACFPatterns.NEWLINE.split(formatted)) {<a name="line.120"></a>
<span class="sourceLineNo">121</span> issuer.sendMessageInternal(ACFUtil.rtrim(msg));<a name="line.121"></a>
<span class="sourceLineNo">122</span> }<a name="line.122"></a>
<span class="sourceLineNo">123</span> }<a name="line.123"></a>
<span class="sourceLineNo">124</span> }<a name="line.124"></a>
<span class="sourceLineNo">125</span><a name="line.125"></a>
<span class="sourceLineNo">126</span> /**<a name="line.126"></a>
<span class="sourceLineNo">127</span> * Override this to control replacements<a name="line.127"></a>
<span class="sourceLineNo">128</span> * @param e<a name="line.128"></a>
<span class="sourceLineNo">129</span> * @return<a name="line.129"></a>
<span class="sourceLineNo">130</span> */<a name="line.130"></a>
<span class="sourceLineNo">131</span> @NotNull<a name="line.131"></a>
<span class="sourceLineNo">132</span> public String[] getFormatReplacements(HelpEntry e) {<a name="line.132"></a>
<span class="sourceLineNo">133</span> //{command} {parameters} {separator} {description}<a name="line.133"></a>
<span class="sourceLineNo">134</span> return new String[] {<a name="line.134"></a>
<span class="sourceLineNo">135</span> "{command}", e.getCommand(),<a name="line.135"></a>
<span class="sourceLineNo">136</span> "{parameters}", e.getParameterSyntax(),<a name="line.136"></a>
<span class="sourceLineNo">137</span> "{separator}", e.getDescription().isEmpty() ? "" : "-",<a name="line.137"></a>
<span class="sourceLineNo">138</span> "{description}", e.getDescription()<a name="line.138"></a>
<span class="sourceLineNo">139</span> };<a name="line.139"></a>
<span class="sourceLineNo">140</span> }<a name="line.140"></a>
<span class="sourceLineNo">141</span><a name="line.141"></a>
<span class="sourceLineNo">142</span> public List&lt;HelpEntry&gt; getHelpEntries() {<a name="line.142"></a>
<span class="sourceLineNo">143</span> return helpEntries;<a name="line.143"></a>
<span class="sourceLineNo">144</span> }<a name="line.144"></a>
<span class="sourceLineNo">145</span><a name="line.145"></a>
<span class="sourceLineNo">146</span> public void setPage(int page) {<a name="line.146"></a>
<span class="sourceLineNo">147</span> this.page = page;<a name="line.147"></a>
<span class="sourceLineNo">148</span> }<a name="line.148"></a>
<span class="sourceLineNo">149</span><a name="line.149"></a>
<span class="sourceLineNo">150</span> public void setSearch(List&lt;String&gt; search) {<a name="line.150"></a>
<span class="sourceLineNo">151</span> this.search = search;<a name="line.151"></a>
<span class="sourceLineNo">152</span> getHelpEntries().forEach(this::updateSearchScore);<a name="line.152"></a>
<span class="sourceLineNo">153</span> }<a name="line.153"></a>
<span class="sourceLineNo">154</span>}<a name="line.154"></a>
<span class="sourceLineNo">083</span><a name="line.83"></a>
<span class="sourceLineNo">084</span> if (pattern.matcher(help.getDescription()).matches()) {<a name="line.84"></a>
<span class="sourceLineNo">085</span> searchScore += 2;<a name="line.85"></a>
<span class="sourceLineNo">086</span> }<a name="line.86"></a>
<span class="sourceLineNo">087</span> if (pattern.matcher(help.getParameterSyntax()).matches()) {<a name="line.87"></a>
<span class="sourceLineNo">088</span> searchScore++;<a name="line.88"></a>
<span class="sourceLineNo">089</span> }<a name="line.89"></a>
<span class="sourceLineNo">090</span> if (help.getSearchTags() != null &amp;&amp; pattern.matcher(help.getSearchTags()).matches()) {<a name="line.90"></a>
<span class="sourceLineNo">091</span> searchScore += 2;<a name="line.91"></a>
<span class="sourceLineNo">092</span> }<a name="line.92"></a>
<span class="sourceLineNo">093</span> }<a name="line.93"></a>
<span class="sourceLineNo">094</span> help.setSearchScore(searchScore);<a name="line.94"></a>
<span class="sourceLineNo">095</span> }<a name="line.95"></a>
<span class="sourceLineNo">096</span><a name="line.96"></a>
<span class="sourceLineNo">097</span> public CommandManager getManager() {<a name="line.97"></a>
<span class="sourceLineNo">098</span> return manager;<a name="line.98"></a>
<span class="sourceLineNo">099</span> }<a name="line.99"></a>
<span class="sourceLineNo">100</span><a name="line.100"></a>
<span class="sourceLineNo">101</span> public void showHelp() {<a name="line.101"></a>
<span class="sourceLineNo">102</span> showHelp(issuer, MessageKeys.HELP_FORMAT);<a name="line.102"></a>
<span class="sourceLineNo">103</span> }<a name="line.103"></a>
<span class="sourceLineNo">104</span><a name="line.104"></a>
<span class="sourceLineNo">105</span> public void showHelp(CommandIssuer issuer) {<a name="line.105"></a>
<span class="sourceLineNo">106</span> showHelp(issuer, MessageKeys.HELP_FORMAT);<a name="line.106"></a>
<span class="sourceLineNo">107</span> }<a name="line.107"></a>
<span class="sourceLineNo">108</span><a name="line.108"></a>
<span class="sourceLineNo">109</span> public void showHelp(CommandIssuer issuer, MessageKeyProvider format) {<a name="line.109"></a>
<span class="sourceLineNo">110</span> List&lt;HelpEntry&gt; helpEntries = getHelpEntries();<a name="line.110"></a>
<span class="sourceLineNo">111</span> Iterator&lt;HelpEntry&gt; results = helpEntries.stream()<a name="line.111"></a>
<span class="sourceLineNo">112</span> .filter(HelpEntry::shouldShow)<a name="line.112"></a>
<span class="sourceLineNo">113</span> .sorted(Comparator.comparingInt(helpEntry -&gt; helpEntry.getSearchScore() * -1)).iterator();<a name="line.113"></a>
<span class="sourceLineNo">114</span> if (!results.hasNext()) {<a name="line.114"></a>
<span class="sourceLineNo">115</span> issuer.sendMessage(MessageType.ERROR, MessageKeys.NO_COMMAND_MATCHED_SEARCH, "{search}", ACFUtil.join(this.search, " "));<a name="line.115"></a>
<span class="sourceLineNo">116</span> helpEntries = getHelpEntries();<a name="line.116"></a>
<span class="sourceLineNo">117</span> results = helpEntries.iterator();<a name="line.117"></a>
<span class="sourceLineNo">118</span> }<a name="line.118"></a>
<span class="sourceLineNo">119</span> int totalResults = helpEntries.size();<a name="line.119"></a>
<span class="sourceLineNo">120</span> int min = (this.page-1) * this.perPage; // TODO: per page configurable?<a name="line.120"></a>
<span class="sourceLineNo">121</span> int max = min + this.perPage;<a name="line.121"></a>
<span class="sourceLineNo">122</span> int i = 0;<a name="line.122"></a>
<span class="sourceLineNo">123</span> if (min &gt;= totalResults) {<a name="line.123"></a>
<span class="sourceLineNo">124</span> issuer.sendMessage(MessageType.HELP, MessageKeys.HELP_NO_RESULTS);<a name="line.124"></a>
<span class="sourceLineNo">125</span> return;<a name="line.125"></a>
<span class="sourceLineNo">126</span> }<a name="line.126"></a>
<span class="sourceLineNo">127</span><a name="line.127"></a>
<span class="sourceLineNo">128</span> while (results.hasNext()) {<a name="line.128"></a>
<span class="sourceLineNo">129</span> HelpEntry e = results.next();<a name="line.129"></a>
<span class="sourceLineNo">130</span> if (i &gt;= max) {<a name="line.130"></a>
<span class="sourceLineNo">131</span> break;<a name="line.131"></a>
<span class="sourceLineNo">132</span> }<a name="line.132"></a>
<span class="sourceLineNo">133</span> if (i++ &lt; min) {<a name="line.133"></a>
<span class="sourceLineNo">134</span> continue;<a name="line.134"></a>
<span class="sourceLineNo">135</span> }<a name="line.135"></a>
<span class="sourceLineNo">136</span><a name="line.136"></a>
<span class="sourceLineNo">137</span> String formatted = this.manager.formatMessage(issuer, MessageType.HELP, format, getFormatReplacements(e));<a name="line.137"></a>
<span class="sourceLineNo">138</span> for (String msg : ACFPatterns.NEWLINE.split(formatted)) {<a name="line.138"></a>
<span class="sourceLineNo">139</span> issuer.sendMessageInternal(ACFUtil.rtrim(msg));<a name="line.139"></a>
<span class="sourceLineNo">140</span> }<a name="line.140"></a>
<span class="sourceLineNo">141</span> }<a name="line.141"></a>
<span class="sourceLineNo">142</span> if (min &gt; 0 || results.hasNext()) {<a name="line.142"></a>
<span class="sourceLineNo">143</span> issuer.sendMessage(MessageType.HELP, MessageKeys.HELP_PAGE_INFORMATION,<a name="line.143"></a>
<span class="sourceLineNo">144</span> "{page}", "" + this.page,<a name="line.144"></a>
<span class="sourceLineNo">145</span> "{totalpages}", ""+ (int)Math.ceil((float)totalResults / (float)this.perPage),<a name="line.145"></a>
<span class="sourceLineNo">146</span> "{results}", "" + totalResults<a name="line.146"></a>
<span class="sourceLineNo">147</span> );<a name="line.147"></a>
<span class="sourceLineNo">148</span> }<a name="line.148"></a>
<span class="sourceLineNo">149</span> }<a name="line.149"></a>
<span class="sourceLineNo">150</span><a name="line.150"></a>
<span class="sourceLineNo">151</span> /**<a name="line.151"></a>
<span class="sourceLineNo">152</span> * Override this to control replacements<a name="line.152"></a>
<span class="sourceLineNo">153</span> * @param e<a name="line.153"></a>
<span class="sourceLineNo">154</span> * @return<a name="line.154"></a>
<span class="sourceLineNo">155</span> */<a name="line.155"></a>
<span class="sourceLineNo">156</span> @NotNull<a name="line.156"></a>
<span class="sourceLineNo">157</span> public String[] getFormatReplacements(HelpEntry e) {<a name="line.157"></a>
<span class="sourceLineNo">158</span> //{command} {parameters} {separator} {description}<a name="line.158"></a>
<span class="sourceLineNo">159</span> return new String[] {<a name="line.159"></a>
<span class="sourceLineNo">160</span> "{command}", e.getCommand(),<a name="line.160"></a>
<span class="sourceLineNo">161</span> "{parameters}", e.getParameterSyntax(),<a name="line.161"></a>
<span class="sourceLineNo">162</span> "{separator}", e.getDescription().isEmpty() ? "" : "-",<a name="line.162"></a>
<span class="sourceLineNo">163</span> "{description}", e.getDescription()<a name="line.163"></a>
<span class="sourceLineNo">164</span> };<a name="line.164"></a>
<span class="sourceLineNo">165</span> }<a name="line.165"></a>
<span class="sourceLineNo">166</span><a name="line.166"></a>
<span class="sourceLineNo">167</span> public List&lt;HelpEntry&gt; getHelpEntries() {<a name="line.167"></a>
<span class="sourceLineNo">168</span> return helpEntries;<a name="line.168"></a>
<span class="sourceLineNo">169</span> }<a name="line.169"></a>
<span class="sourceLineNo">170</span><a name="line.170"></a>
<span class="sourceLineNo">171</span> public void setPerPage(int perPage) {<a name="line.171"></a>
<span class="sourceLineNo">172</span> this.perPage = perPage;<a name="line.172"></a>
<span class="sourceLineNo">173</span> }<a name="line.173"></a>
<span class="sourceLineNo">174</span><a name="line.174"></a>
<span class="sourceLineNo">175</span> public void setPage(int page) {<a name="line.175"></a>
<span class="sourceLineNo">176</span> this.page = page;<a name="line.176"></a>
<span class="sourceLineNo">177</span> }<a name="line.177"></a>
<span class="sourceLineNo">178</span><a name="line.178"></a>
<span class="sourceLineNo">179</span> public void setPage(int page, int perPage) {<a name="line.179"></a>
<span class="sourceLineNo">180</span> this.setPage(page);<a name="line.180"></a>
<span class="sourceLineNo">181</span> this.setPerPage(perPage);<a name="line.181"></a>
<span class="sourceLineNo">182</span> }<a name="line.182"></a>
<span class="sourceLineNo">183</span><a name="line.183"></a>
<span class="sourceLineNo">184</span> public void setSearch(List&lt;String&gt; search) {<a name="line.184"></a>
<span class="sourceLineNo">185</span> this.search = search;<a name="line.185"></a>
<span class="sourceLineNo">186</span> getHelpEntries().forEach(this::updateSearchScore);<a name="line.186"></a>
<span class="sourceLineNo">187</span> }<a name="line.187"></a>
<span class="sourceLineNo">188</span>}<a name="line.188"></a>
@@ -60,255 +60,268 @@
<span class="sourceLineNo">052</span> protected Set&lt;Locale&gt; supportedLanguages = Sets.newHashSet(Locales.ENGLISH, Locales.GERMAN, Locales.SPANISH, Locales.CZECH);<a name="line.52"></a>
<span class="sourceLineNo">053</span> protected Map&lt;MessageType, F&gt; formatters = new IdentityHashMap&lt;&gt;();<a name="line.53"></a>
<span class="sourceLineNo">054</span> protected F defaultFormatter;<a name="line.54"></a>
<span class="sourceLineNo">055</span> private Set&lt;String&gt; unstableAPIs = Sets.newHashSet();<a name="line.55"></a>
<span class="sourceLineNo">056</span><a name="line.56"></a>
<span class="sourceLineNo">057</span> public static CommandOperationContext getCurrentCommandOperationContext() {<a name="line.57"></a>
<span class="sourceLineNo">058</span> return commandOperationContext.get().peek();<a name="line.58"></a>
<span class="sourceLineNo">059</span> }<a name="line.59"></a>
<span class="sourceLineNo">060</span><a name="line.60"></a>
<span class="sourceLineNo">061</span> public static CommandIssuer getCurrentCommandIssuer() {<a name="line.61"></a>
<span class="sourceLineNo">062</span> CommandOperationContext context = commandOperationContext.get().peek();<a name="line.62"></a>
<span class="sourceLineNo">063</span> return context != null ? context.getCommandIssuer() : null;<a name="line.63"></a>
<span class="sourceLineNo">064</span> }<a name="line.64"></a>
<span class="sourceLineNo">065</span><a name="line.65"></a>
<span class="sourceLineNo">066</span> public static CommandManager getCurrentCommandManager() {<a name="line.66"></a>
<span class="sourceLineNo">067</span> CommandOperationContext context = commandOperationContext.get().peek();<a name="line.67"></a>
<span class="sourceLineNo">068</span> return context != null ? context.getCommandManager() : null;<a name="line.68"></a>
<span class="sourceLineNo">069</span> }<a name="line.69"></a>
<span class="sourceLineNo">070</span><a name="line.70"></a>
<span class="sourceLineNo">071</span> public F setFormat(MessageType type, F formatter) {<a name="line.71"></a>
<span class="sourceLineNo">072</span> return formatters.put(type, formatter);<a name="line.72"></a>
<span class="sourceLineNo">073</span> }<a name="line.73"></a>
<span class="sourceLineNo">074</span><a name="line.74"></a>
<span class="sourceLineNo">075</span> public F getFormat(MessageType type) {<a name="line.75"></a>
<span class="sourceLineNo">076</span> return formatters.getOrDefault(type, defaultFormatter);<a name="line.76"></a>
<span class="sourceLineNo">077</span> }<a name="line.77"></a>
<span class="sourceLineNo">078</span><a name="line.78"></a>
<span class="sourceLineNo">079</span> public void setFormat(MessageType type, FT... colors) {<a name="line.79"></a>
<span class="sourceLineNo">080</span> F format = getFormat(type);<a name="line.80"></a>
<span class="sourceLineNo">081</span> for (int i = 0; i &lt; colors.length; i++) {<a name="line.81"></a>
<span class="sourceLineNo">082</span> format.setColor(i, colors[i]);<a name="line.82"></a>
<span class="sourceLineNo">083</span> }<a name="line.83"></a>
<span class="sourceLineNo">084</span> }<a name="line.84"></a>
<span class="sourceLineNo">085</span><a name="line.85"></a>
<span class="sourceLineNo">086</span> public void setFormat(MessageType type, int i, FT color) {<a name="line.86"></a>
<span class="sourceLineNo">087</span> F format = getFormat(type);<a name="line.87"></a>
<span class="sourceLineNo">088</span> format.setColor(i, color);<a name="line.88"></a>
<span class="sourceLineNo">089</span> }<a name="line.89"></a>
<span class="sourceLineNo">090</span><a name="line.90"></a>
<span class="sourceLineNo">091</span> public F getDefaultFormatter() {<a name="line.91"></a>
<span class="sourceLineNo">092</span> return defaultFormatter;<a name="line.92"></a>
<span class="sourceLineNo">093</span> }<a name="line.93"></a>
<span class="sourceLineNo">094</span><a name="line.94"></a>
<span class="sourceLineNo">095</span> public void setDefaultFormatter(F defaultFormatter) {<a name="line.95"></a>
<span class="sourceLineNo">096</span> this.defaultFormatter = defaultFormatter;<a name="line.96"></a>
<span class="sourceLineNo">097</span> }<a name="line.97"></a>
<span class="sourceLineNo">098</span><a name="line.98"></a>
<span class="sourceLineNo">099</span> /**<a name="line.99"></a>
<span class="sourceLineNo">100</span> * Gets the command contexts manager<a name="line.100"></a>
<span class="sourceLineNo">101</span> * @return Command Contexts<a name="line.101"></a>
<span class="sourceLineNo">102</span> */<a name="line.102"></a>
<span class="sourceLineNo">103</span> public abstract CommandContexts&lt;?&gt; getCommandContexts();<a name="line.103"></a>
<span class="sourceLineNo">104</span><a name="line.104"></a>
<span class="sourceLineNo">105</span> /**<a name="line.105"></a>
<span class="sourceLineNo">106</span> * Gets the command completions manager<a name="line.106"></a>
<span class="sourceLineNo">107</span> * @return Command Completions<a name="line.107"></a>
<span class="sourceLineNo">108</span> */<a name="line.108"></a>
<span class="sourceLineNo">109</span> public abstract CommandCompletions&lt;?&gt; getCommandCompletions();<a name="line.109"></a>
<span class="sourceLineNo">110</span><a name="line.110"></a>
<span class="sourceLineNo">111</span> /** @deprecated Unstable API */ @Deprecated @UnstableAPI<a name="line.111"></a>
<span class="sourceLineNo">112</span> public CommandHelp generateCommandHelp(@NotNull String command) {<a name="line.112"></a>
<span class="sourceLineNo">113</span> verifyUnstableAPI("help");<a name="line.113"></a>
<span class="sourceLineNo">114</span> CommandOperationContext context = getCurrentCommandOperationContext();<a name="line.114"></a>
<span class="sourceLineNo">115</span> if (context == null) {<a name="line.115"></a>
<span class="sourceLineNo">116</span> throw new IllegalStateException("This method can only be called as part of a command execution.");<a name="line.116"></a>
<span class="sourceLineNo">117</span> }<a name="line.117"></a>
<span class="sourceLineNo">118</span> return generateCommandHelp(context.getCommandIssuer(), command);<a name="line.118"></a>
<span class="sourceLineNo">119</span> }<a name="line.119"></a>
<span class="sourceLineNo">120</span><a name="line.120"></a>
<span class="sourceLineNo">121</span> /** @deprecated Unstable API */ @Deprecated @UnstableAPI<a name="line.121"></a>
<span class="sourceLineNo">122</span> public CommandHelp generateCommandHelp(CommandIssuer issuer, @NotNull String command) {<a name="line.122"></a>
<span class="sourceLineNo">123</span> verifyUnstableAPI("help");<a name="line.123"></a>
<span class="sourceLineNo">124</span> return generateCommandHelp(issuer, obtainRootCommand(ACFPatterns.SPACE.split(command, 2)[0]));<a name="line.124"></a>
<span class="sourceLineNo">125</span> }<a name="line.125"></a>
<span class="sourceLineNo">126</span><a name="line.126"></a>
<span class="sourceLineNo">127</span> /** @deprecated Unstable API */ @Deprecated @UnstableAPI<a name="line.127"></a>
<span class="sourceLineNo">128</span> public CommandHelp generateCommandHelp() {<a name="line.128"></a>
<span class="sourceLineNo">129</span> verifyUnstableAPI("help");<a name="line.129"></a>
<span class="sourceLineNo">130</span> CommandOperationContext context = getCurrentCommandOperationContext();<a name="line.130"></a>
<span class="sourceLineNo">131</span> if (context == null) {<a name="line.131"></a>
<span class="sourceLineNo">132</span> throw new IllegalStateException("This method can only be called as part of a command execution.");<a name="line.132"></a>
<span class="sourceLineNo">133</span> }<a name="line.133"></a>
<span class="sourceLineNo">134</span> String commandLabel = context.getCommandLabel();<a name="line.134"></a>
<span class="sourceLineNo">135</span> return generateCommandHelp(context.getCommandIssuer(), this.obtainRootCommand(commandLabel));<a name="line.135"></a>
<span class="sourceLineNo">136</span> }<a name="line.136"></a>
<span class="sourceLineNo">137</span><a name="line.137"></a>
<span class="sourceLineNo">138</span> /** @deprecated Unstable API */ @Deprecated @UnstableAPI<a name="line.138"></a>
<span class="sourceLineNo">139</span> public CommandHelp generateCommandHelp(CommandIssuer issuer, RootCommand rootCommand) {<a name="line.139"></a>
<span class="sourceLineNo">140</span> verifyUnstableAPI("help");<a name="line.140"></a>
<span class="sourceLineNo">141</span> return new CommandHelp(this, rootCommand, issuer);<a name="line.141"></a>
<span class="sourceLineNo">142</span> }<a name="line.142"></a>
<span class="sourceLineNo">143</span><a name="line.143"></a>
<span class="sourceLineNo">144</span> /**<a name="line.144"></a>
<span class="sourceLineNo">145</span> * Registers a command with ACF<a name="line.145"></a>
<span class="sourceLineNo">146</span> *<a name="line.146"></a>
<span class="sourceLineNo">147</span> * @param command The command to register<a name="line.147"></a>
<span class="sourceLineNo">148</span> * @return boolean<a name="line.148"></a>
<span class="sourceLineNo">149</span> */<a name="line.149"></a>
<span class="sourceLineNo">150</span> public abstract void registerCommand(BaseCommand command);<a name="line.150"></a>
<span class="sourceLineNo">151</span> public abstract boolean hasRegisteredCommands();<a name="line.151"></a>
<span class="sourceLineNo">152</span> public abstract boolean isCommandIssuer(Class&lt;?&gt; type);<a name="line.152"></a>
<span class="sourceLineNo">153</span><a name="line.153"></a>
<span class="sourceLineNo">154</span> // TODO: Change this to I if we make a breaking change<a name="line.154"></a>
<span class="sourceLineNo">155</span> public abstract CommandIssuer getCommandIssuer(Object issuer);<a name="line.155"></a>
<span class="sourceLineNo">055</span> protected int defaultHelpPerPage = 10;<a name="line.55"></a>
<span class="sourceLineNo">056</span> private Set&lt;String&gt; unstableAPIs = Sets.newHashSet();<a name="line.56"></a>
<span class="sourceLineNo">057</span><a name="line.57"></a>
<span class="sourceLineNo">058</span> public static CommandOperationContext getCurrentCommandOperationContext() {<a name="line.58"></a>
<span class="sourceLineNo">059</span> return commandOperationContext.get().peek();<a name="line.59"></a>
<span class="sourceLineNo">060</span> }<a name="line.60"></a>
<span class="sourceLineNo">061</span><a name="line.61"></a>
<span class="sourceLineNo">062</span> public static CommandIssuer getCurrentCommandIssuer() {<a name="line.62"></a>
<span class="sourceLineNo">063</span> CommandOperationContext context = commandOperationContext.get().peek();<a name="line.63"></a>
<span class="sourceLineNo">064</span> return context != null ? context.getCommandIssuer() : null;<a name="line.64"></a>
<span class="sourceLineNo">065</span> }<a name="line.65"></a>
<span class="sourceLineNo">066</span><a name="line.66"></a>
<span class="sourceLineNo">067</span> public static CommandManager getCurrentCommandManager() {<a name="line.67"></a>
<span class="sourceLineNo">068</span> CommandOperationContext context = commandOperationContext.get().peek();<a name="line.68"></a>
<span class="sourceLineNo">069</span> return context != null ? context.getCommandManager() : null;<a name="line.69"></a>
<span class="sourceLineNo">070</span> }<a name="line.70"></a>
<span class="sourceLineNo">071</span><a name="line.71"></a>
<span class="sourceLineNo">072</span> public F setFormat(MessageType type, F formatter) {<a name="line.72"></a>
<span class="sourceLineNo">073</span> return formatters.put(type, formatter);<a name="line.73"></a>
<span class="sourceLineNo">074</span> }<a name="line.74"></a>
<span class="sourceLineNo">075</span><a name="line.75"></a>
<span class="sourceLineNo">076</span> public F getFormat(MessageType type) {<a name="line.76"></a>
<span class="sourceLineNo">077</span> return formatters.getOrDefault(type, defaultFormatter);<a name="line.77"></a>
<span class="sourceLineNo">078</span> }<a name="line.78"></a>
<span class="sourceLineNo">079</span><a name="line.79"></a>
<span class="sourceLineNo">080</span> public void setFormat(MessageType type, FT... colors) {<a name="line.80"></a>
<span class="sourceLineNo">081</span> F format = getFormat(type);<a name="line.81"></a>
<span class="sourceLineNo">082</span> for (int i = 0; i &lt; colors.length; i++) {<a name="line.82"></a>
<span class="sourceLineNo">083</span> format.setColor(i, colors[i]);<a name="line.83"></a>
<span class="sourceLineNo">084</span> }<a name="line.84"></a>
<span class="sourceLineNo">085</span> }<a name="line.85"></a>
<span class="sourceLineNo">086</span><a name="line.86"></a>
<span class="sourceLineNo">087</span> public void setFormat(MessageType type, int i, FT color) {<a name="line.87"></a>
<span class="sourceLineNo">088</span> F format = getFormat(type);<a name="line.88"></a>
<span class="sourceLineNo">089</span> format.setColor(i, color);<a name="line.89"></a>
<span class="sourceLineNo">090</span> }<a name="line.90"></a>
<span class="sourceLineNo">091</span><a name="line.91"></a>
<span class="sourceLineNo">092</span> public F getDefaultFormatter() {<a name="line.92"></a>
<span class="sourceLineNo">093</span> return defaultFormatter;<a name="line.93"></a>
<span class="sourceLineNo">094</span> }<a name="line.94"></a>
<span class="sourceLineNo">095</span><a name="line.95"></a>
<span class="sourceLineNo">096</span> public void setDefaultFormatter(F defaultFormatter) {<a name="line.96"></a>
<span class="sourceLineNo">097</span> this.defaultFormatter = defaultFormatter;<a name="line.97"></a>
<span class="sourceLineNo">098</span> }<a name="line.98"></a>
<span class="sourceLineNo">099</span><a name="line.99"></a>
<span class="sourceLineNo">100</span> /**<a name="line.100"></a>
<span class="sourceLineNo">101</span> * Gets the command contexts manager<a name="line.101"></a>
<span class="sourceLineNo">102</span> * @return Command Contexts<a name="line.102"></a>
<span class="sourceLineNo">103</span> */<a name="line.103"></a>
<span class="sourceLineNo">104</span> public abstract CommandContexts&lt;?&gt; getCommandContexts();<a name="line.104"></a>
<span class="sourceLineNo">105</span><a name="line.105"></a>
<span class="sourceLineNo">106</span> /**<a name="line.106"></a>
<span class="sourceLineNo">107</span> * Gets the command completions manager<a name="line.107"></a>
<span class="sourceLineNo">108</span> * @return Command Completions<a name="line.108"></a>
<span class="sourceLineNo">109</span> */<a name="line.109"></a>
<span class="sourceLineNo">110</span> public abstract CommandCompletions&lt;?&gt; getCommandCompletions();<a name="line.110"></a>
<span class="sourceLineNo">111</span><a name="line.111"></a>
<span class="sourceLineNo">112</span> /** @deprecated Unstable API */ @Deprecated @UnstableAPI<a name="line.112"></a>
<span class="sourceLineNo">113</span> public CommandHelp generateCommandHelp(@NotNull String command) {<a name="line.113"></a>
<span class="sourceLineNo">114</span> verifyUnstableAPI("help");<a name="line.114"></a>
<span class="sourceLineNo">115</span> CommandOperationContext context = getCurrentCommandOperationContext();<a name="line.115"></a>
<span class="sourceLineNo">116</span> if (context == null) {<a name="line.116"></a>
<span class="sourceLineNo">117</span> throw new IllegalStateException("This method can only be called as part of a command execution.");<a name="line.117"></a>
<span class="sourceLineNo">118</span> }<a name="line.118"></a>
<span class="sourceLineNo">119</span> return generateCommandHelp(context.getCommandIssuer(), command);<a name="line.119"></a>
<span class="sourceLineNo">120</span> }<a name="line.120"></a>
<span class="sourceLineNo">121</span><a name="line.121"></a>
<span class="sourceLineNo">122</span> /** @deprecated Unstable API */ @Deprecated @UnstableAPI<a name="line.122"></a>
<span class="sourceLineNo">123</span> public CommandHelp generateCommandHelp(CommandIssuer issuer, @NotNull String command) {<a name="line.123"></a>
<span class="sourceLineNo">124</span> verifyUnstableAPI("help");<a name="line.124"></a>
<span class="sourceLineNo">125</span> return generateCommandHelp(issuer, obtainRootCommand(ACFPatterns.SPACE.split(command, 2)[0]));<a name="line.125"></a>
<span class="sourceLineNo">126</span> }<a name="line.126"></a>
<span class="sourceLineNo">127</span><a name="line.127"></a>
<span class="sourceLineNo">128</span> /** @deprecated Unstable API */ @Deprecated @UnstableAPI<a name="line.128"></a>
<span class="sourceLineNo">129</span> public CommandHelp generateCommandHelp() {<a name="line.129"></a>
<span class="sourceLineNo">130</span> verifyUnstableAPI("help");<a name="line.130"></a>
<span class="sourceLineNo">131</span> CommandOperationContext context = getCurrentCommandOperationContext();<a name="line.131"></a>
<span class="sourceLineNo">132</span> if (context == null) {<a name="line.132"></a>
<span class="sourceLineNo">133</span> throw new IllegalStateException("This method can only be called as part of a command execution.");<a name="line.133"></a>
<span class="sourceLineNo">134</span> }<a name="line.134"></a>
<span class="sourceLineNo">135</span> String commandLabel = context.getCommandLabel();<a name="line.135"></a>
<span class="sourceLineNo">136</span> return generateCommandHelp(context.getCommandIssuer(), this.obtainRootCommand(commandLabel));<a name="line.136"></a>
<span class="sourceLineNo">137</span> }<a name="line.137"></a>
<span class="sourceLineNo">138</span><a name="line.138"></a>
<span class="sourceLineNo">139</span> /** @deprecated Unstable API */ @Deprecated @UnstableAPI<a name="line.139"></a>
<span class="sourceLineNo">140</span> public CommandHelp generateCommandHelp(CommandIssuer issuer, RootCommand rootCommand) {<a name="line.140"></a>
<span class="sourceLineNo">141</span> verifyUnstableAPI("help");<a name="line.141"></a>
<span class="sourceLineNo">142</span> return new CommandHelp(this, rootCommand, issuer);<a name="line.142"></a>
<span class="sourceLineNo">143</span> }<a name="line.143"></a>
<span class="sourceLineNo">144</span><a name="line.144"></a>
<span class="sourceLineNo">145</span> /** @deprecated Unstable API */ @Deprecated @UnstableAPI<a name="line.145"></a>
<span class="sourceLineNo">146</span> public int getDefaultHelpPerPage() {<a name="line.146"></a>
<span class="sourceLineNo">147</span> verifyUnstableAPI("help");<a name="line.147"></a>
<span class="sourceLineNo">148</span> return defaultHelpPerPage;<a name="line.148"></a>
<span class="sourceLineNo">149</span> }<a name="line.149"></a>
<span class="sourceLineNo">150</span><a name="line.150"></a>
<span class="sourceLineNo">151</span> /** @deprecated Unstable API */ @Deprecated @UnstableAPI<a name="line.151"></a>
<span class="sourceLineNo">152</span> public void setDefaultHelpPerPage(int defaultHelpPerPage) {<a name="line.152"></a>
<span class="sourceLineNo">153</span> verifyUnstableAPI("help");<a name="line.153"></a>
<span class="sourceLineNo">154</span> this.defaultHelpPerPage = defaultHelpPerPage;<a name="line.154"></a>
<span class="sourceLineNo">155</span> }<a name="line.155"></a>
<span class="sourceLineNo">156</span><a name="line.156"></a>
<span class="sourceLineNo">157</span> public abstract RootCommand createRootCommand(String cmd);<a name="line.157"></a>
<span class="sourceLineNo">158</span><a name="line.158"></a>
<span class="sourceLineNo">159</span> /**<a name="line.159"></a>
<span class="sourceLineNo">160</span> * Returns a Locales Manager to add and modify language tables for your commands.<a name="line.160"></a>
<span class="sourceLineNo">161</span> * @return<a name="line.161"></a>
<span class="sourceLineNo">157</span> /**<a name="line.157"></a>
<span class="sourceLineNo">158</span> * Registers a command with ACF<a name="line.158"></a>
<span class="sourceLineNo">159</span> *<a name="line.159"></a>
<span class="sourceLineNo">160</span> * @param command The command to register<a name="line.160"></a>
<span class="sourceLineNo">161</span> * @return boolean<a name="line.161"></a>
<span class="sourceLineNo">162</span> */<a name="line.162"></a>
<span class="sourceLineNo">163</span> public abstract Locales getLocales();<a name="line.163"></a>
<span class="sourceLineNo">164</span><a name="line.164"></a>
<span class="sourceLineNo">165</span> public abstract &lt;R extends CommandExecutionContext&gt; R createCommandContext(RegisteredCommand command, Parameter parameter, CommandIssuer sender, List&lt;String&gt; args, int i, Map&lt;String, Object&gt; passedArgs);<a name="line.165"></a>
<span class="sourceLineNo">163</span> public abstract void registerCommand(BaseCommand command);<a name="line.163"></a>
<span class="sourceLineNo">164</span> public abstract boolean hasRegisteredCommands();<a name="line.164"></a>
<span class="sourceLineNo">165</span> public abstract boolean isCommandIssuer(Class&lt;?&gt; type);<a name="line.165"></a>
<span class="sourceLineNo">166</span><a name="line.166"></a>
<span class="sourceLineNo">167</span> public abstract CommandCompletionContext createCompletionContext(RegisteredCommand command, CommandIssuer sender, String input, String config, String[] args);<a name="line.167"></a>
<span class="sourceLineNo">168</span><a name="line.168"></a>
<span class="sourceLineNo">169</span> public abstract void log(final LogLevel level, final String message, final Throwable throwable);<a name="line.169"></a>
<span class="sourceLineNo">170</span><a name="line.170"></a>
<span class="sourceLineNo">171</span> public void log(final LogLevel level, final String message) {<a name="line.171"></a>
<span class="sourceLineNo">172</span> log(level, message, null);<a name="line.172"></a>
<span class="sourceLineNo">173</span> }<a name="line.173"></a>
<span class="sourceLineNo">174</span><a name="line.174"></a>
<span class="sourceLineNo">175</span> /**<a name="line.175"></a>
<span class="sourceLineNo">176</span> * Lets you add custom string replacements that can be applied to annotation values,<a name="line.176"></a>
<span class="sourceLineNo">177</span> * to reduce duplication/repetition of common values such as permission nodes and command prefixes.<a name="line.177"></a>
<span class="sourceLineNo">178</span> *<a name="line.178"></a>
<span class="sourceLineNo">179</span> * Any replacement registered starts with a %<a name="line.179"></a>
<span class="sourceLineNo">180</span> *<a name="line.180"></a>
<span class="sourceLineNo">181</span> * So for ex @CommandPermission("%staff")<a name="line.181"></a>
<span class="sourceLineNo">182</span> * @return Replacements Manager<a name="line.182"></a>
<span class="sourceLineNo">183</span> */<a name="line.183"></a>
<span class="sourceLineNo">184</span> public CommandReplacements getCommandReplacements() {<a name="line.184"></a>
<span class="sourceLineNo">185</span> return replacements;<a name="line.185"></a>
<span class="sourceLineNo">167</span> // TODO: Change this to I if we make a breaking change<a name="line.167"></a>
<span class="sourceLineNo">168</span> public abstract CommandIssuer getCommandIssuer(Object issuer);<a name="line.168"></a>
<span class="sourceLineNo">169</span><a name="line.169"></a>
<span class="sourceLineNo">170</span> public abstract RootCommand createRootCommand(String cmd);<a name="line.170"></a>
<span class="sourceLineNo">171</span><a name="line.171"></a>
<span class="sourceLineNo">172</span> /**<a name="line.172"></a>
<span class="sourceLineNo">173</span> * Returns a Locales Manager to add and modify language tables for your commands.<a name="line.173"></a>
<span class="sourceLineNo">174</span> * @return<a name="line.174"></a>
<span class="sourceLineNo">175</span> */<a name="line.175"></a>
<span class="sourceLineNo">176</span> public abstract Locales getLocales();<a name="line.176"></a>
<span class="sourceLineNo">177</span><a name="line.177"></a>
<span class="sourceLineNo">178</span> public abstract &lt;R extends CommandExecutionContext&gt; R createCommandContext(RegisteredCommand command, Parameter parameter, CommandIssuer sender, List&lt;String&gt; args, int i, Map&lt;String, Object&gt; passedArgs);<a name="line.178"></a>
<span class="sourceLineNo">179</span><a name="line.179"></a>
<span class="sourceLineNo">180</span> public abstract CommandCompletionContext createCompletionContext(RegisteredCommand command, CommandIssuer sender, String input, String config, String[] args);<a name="line.180"></a>
<span class="sourceLineNo">181</span><a name="line.181"></a>
<span class="sourceLineNo">182</span> public abstract void log(final LogLevel level, final String message, final Throwable throwable);<a name="line.182"></a>
<span class="sourceLineNo">183</span><a name="line.183"></a>
<span class="sourceLineNo">184</span> public void log(final LogLevel level, final String message) {<a name="line.184"></a>
<span class="sourceLineNo">185</span> log(level, message, null);<a name="line.185"></a>
<span class="sourceLineNo">186</span> }<a name="line.186"></a>
<span class="sourceLineNo">187</span><a name="line.187"></a>
<span class="sourceLineNo">188</span> public boolean hasPermission(CommandIssuer issuer, String permission) {<a name="line.188"></a>
<span class="sourceLineNo">189</span> return permission == null || permission.isEmpty() || issuer.hasPermission(permission);<a name="line.189"></a>
<span class="sourceLineNo">190</span> }<a name="line.190"></a>
<span class="sourceLineNo">191</span><a name="line.191"></a>
<span class="sourceLineNo">192</span> public synchronized RootCommand obtainRootCommand(String cmd) {<a name="line.192"></a>
<span class="sourceLineNo">193</span> return rootCommands.computeIfAbsent(cmd.toLowerCase(), this::createRootCommand);<a name="line.193"></a>
<span class="sourceLineNo">194</span> }<a name="line.194"></a>
<span class="sourceLineNo">195</span><a name="line.195"></a>
<span class="sourceLineNo">196</span> public RegisteredCommand createRegisteredCommand(BaseCommand command, String cmdName, Method method, String prefSubCommand) {<a name="line.196"></a>
<span class="sourceLineNo">197</span> return new RegisteredCommand(command, cmdName, method, prefSubCommand);<a name="line.197"></a>
<span class="sourceLineNo">198</span> }<a name="line.198"></a>
<span class="sourceLineNo">199</span><a name="line.199"></a>
<span class="sourceLineNo">200</span> /**<a name="line.200"></a>
<span class="sourceLineNo">201</span> * Sets the default {@link ExceptionHandler} that is called when an exception occurs while executing a command, if the command doesn't have it's own exception handler registered.<a name="line.201"></a>
<span class="sourceLineNo">202</span> *<a name="line.202"></a>
<span class="sourceLineNo">203</span> * @param exceptionHandler the handler that should handle uncaught exceptions<a name="line.203"></a>
<span class="sourceLineNo">204</span> */<a name="line.204"></a>
<span class="sourceLineNo">205</span> public void setDefaultExceptionHandler(ExceptionHandler exceptionHandler) {<a name="line.205"></a>
<span class="sourceLineNo">206</span> defaultExceptionHandler = exceptionHandler;<a name="line.206"></a>
<span class="sourceLineNo">188</span> /**<a name="line.188"></a>
<span class="sourceLineNo">189</span> * Lets you add custom string replacements that can be applied to annotation values,<a name="line.189"></a>
<span class="sourceLineNo">190</span> * to reduce duplication/repetition of common values such as permission nodes and command prefixes.<a name="line.190"></a>
<span class="sourceLineNo">191</span> *<a name="line.191"></a>
<span class="sourceLineNo">192</span> * Any replacement registered starts with a %<a name="line.192"></a>
<span class="sourceLineNo">193</span> *<a name="line.193"></a>
<span class="sourceLineNo">194</span> * So for ex @CommandPermission("%staff")<a name="line.194"></a>
<span class="sourceLineNo">195</span> * @return Replacements Manager<a name="line.195"></a>
<span class="sourceLineNo">196</span> */<a name="line.196"></a>
<span class="sourceLineNo">197</span> public CommandReplacements getCommandReplacements() {<a name="line.197"></a>
<span class="sourceLineNo">198</span> return replacements;<a name="line.198"></a>
<span class="sourceLineNo">199</span> }<a name="line.199"></a>
<span class="sourceLineNo">200</span><a name="line.200"></a>
<span class="sourceLineNo">201</span> public boolean hasPermission(CommandIssuer issuer, String permission) {<a name="line.201"></a>
<span class="sourceLineNo">202</span> return permission == null || permission.isEmpty() || issuer.hasPermission(permission);<a name="line.202"></a>
<span class="sourceLineNo">203</span> }<a name="line.203"></a>
<span class="sourceLineNo">204</span><a name="line.204"></a>
<span class="sourceLineNo">205</span> public synchronized RootCommand obtainRootCommand(String cmd) {<a name="line.205"></a>
<span class="sourceLineNo">206</span> return rootCommands.computeIfAbsent(cmd.toLowerCase(), this::createRootCommand);<a name="line.206"></a>
<span class="sourceLineNo">207</span> }<a name="line.207"></a>
<span class="sourceLineNo">208</span><a name="line.208"></a>
<span class="sourceLineNo">209</span> /**<a name="line.209"></a>
<span class="sourceLineNo">210</span> * Gets the current default exception handler, might be null.<a name="line.210"></a>
<span class="sourceLineNo">211</span> *<a name="line.211"></a>
<span class="sourceLineNo">212</span> * @return the default exception handler<a name="line.212"></a>
<span class="sourceLineNo">213</span> */<a name="line.213"></a>
<span class="sourceLineNo">214</span> public ExceptionHandler getDefaultExceptionHandler() {<a name="line.214"></a>
<span class="sourceLineNo">215</span> return defaultExceptionHandler;<a name="line.215"></a>
<span class="sourceLineNo">216</span> }<a name="line.216"></a>
<span class="sourceLineNo">217</span><a name="line.217"></a>
<span class="sourceLineNo">218</span> protected boolean handleUncaughtException(BaseCommand scope, RegisteredCommand registeredCommand, CommandIssuer sender, List&lt;String&gt; args, Throwable t) {<a name="line.218"></a>
<span class="sourceLineNo">219</span> boolean result = false;<a name="line.219"></a>
<span class="sourceLineNo">220</span> if (scope.getExceptionHandler() != null) {<a name="line.220"></a>
<span class="sourceLineNo">221</span> result = scope.getExceptionHandler().execute(scope, registeredCommand, sender, args, t);<a name="line.221"></a>
<span class="sourceLineNo">222</span> } else if (defaultExceptionHandler != null) {<a name="line.222"></a>
<span class="sourceLineNo">223</span> result = defaultExceptionHandler.execute(scope, registeredCommand, sender, args, t);<a name="line.223"></a>
<span class="sourceLineNo">224</span> }<a name="line.224"></a>
<span class="sourceLineNo">225</span> return result;<a name="line.225"></a>
<span class="sourceLineNo">226</span> }<a name="line.226"></a>
<span class="sourceLineNo">227</span><a name="line.227"></a>
<span class="sourceLineNo">228</span> public void sendMessage(I issuerArg, MessageType type, MessageKeyProvider key, String... replacements) {<a name="line.228"></a>
<span class="sourceLineNo">229</span> sendMessage(getCommandIssuer(issuerArg), type, key, replacements);<a name="line.229"></a>
<span class="sourceLineNo">230</span> }<a name="line.230"></a>
<span class="sourceLineNo">231</span><a name="line.231"></a>
<span class="sourceLineNo">232</span> public void sendMessage(CommandIssuer issuer, MessageType type, MessageKeyProvider key, String... replacements) {<a name="line.232"></a>
<span class="sourceLineNo">233</span> String message = formatMessage(issuer, type, key, replacements);<a name="line.233"></a>
<span class="sourceLineNo">234</span><a name="line.234"></a>
<span class="sourceLineNo">235</span> for (String msg : ACFPatterns.NEWLINE.split(message)) {<a name="line.235"></a>
<span class="sourceLineNo">236</span> issuer.sendMessageInternal(ACFUtil.rtrim(msg));<a name="line.236"></a>
<span class="sourceLineNo">209</span> public RegisteredCommand createRegisteredCommand(BaseCommand command, String cmdName, Method method, String prefSubCommand) {<a name="line.209"></a>
<span class="sourceLineNo">210</span> return new RegisteredCommand(command, cmdName, method, prefSubCommand);<a name="line.210"></a>
<span class="sourceLineNo">211</span> }<a name="line.211"></a>
<span class="sourceLineNo">212</span><a name="line.212"></a>
<span class="sourceLineNo">213</span> /**<a name="line.213"></a>
<span class="sourceLineNo">214</span> * Sets the default {@link ExceptionHandler} that is called when an exception occurs while executing a command, if the command doesn't have it's own exception handler registered.<a name="line.214"></a>
<span class="sourceLineNo">215</span> *<a name="line.215"></a>
<span class="sourceLineNo">216</span> * @param exceptionHandler the handler that should handle uncaught exceptions<a name="line.216"></a>
<span class="sourceLineNo">217</span> */<a name="line.217"></a>
<span class="sourceLineNo">218</span> public void setDefaultExceptionHandler(ExceptionHandler exceptionHandler) {<a name="line.218"></a>
<span class="sourceLineNo">219</span> defaultExceptionHandler = exceptionHandler;<a name="line.219"></a>
<span class="sourceLineNo">220</span> }<a name="line.220"></a>
<span class="sourceLineNo">221</span><a name="line.221"></a>
<span class="sourceLineNo">222</span> /**<a name="line.222"></a>
<span class="sourceLineNo">223</span> * Gets the current default exception handler, might be null.<a name="line.223"></a>
<span class="sourceLineNo">224</span> *<a name="line.224"></a>
<span class="sourceLineNo">225</span> * @return the default exception handler<a name="line.225"></a>
<span class="sourceLineNo">226</span> */<a name="line.226"></a>
<span class="sourceLineNo">227</span> public ExceptionHandler getDefaultExceptionHandler() {<a name="line.227"></a>
<span class="sourceLineNo">228</span> return defaultExceptionHandler;<a name="line.228"></a>
<span class="sourceLineNo">229</span> }<a name="line.229"></a>
<span class="sourceLineNo">230</span><a name="line.230"></a>
<span class="sourceLineNo">231</span> protected boolean handleUncaughtException(BaseCommand scope, RegisteredCommand registeredCommand, CommandIssuer sender, List&lt;String&gt; args, Throwable t) {<a name="line.231"></a>
<span class="sourceLineNo">232</span> boolean result = false;<a name="line.232"></a>
<span class="sourceLineNo">233</span> if (scope.getExceptionHandler() != null) {<a name="line.233"></a>
<span class="sourceLineNo">234</span> result = scope.getExceptionHandler().execute(scope, registeredCommand, sender, args, t);<a name="line.234"></a>
<span class="sourceLineNo">235</span> } else if (defaultExceptionHandler != null) {<a name="line.235"></a>
<span class="sourceLineNo">236</span> result = defaultExceptionHandler.execute(scope, registeredCommand, sender, args, t);<a name="line.236"></a>
<span class="sourceLineNo">237</span> }<a name="line.237"></a>
<span class="sourceLineNo">238</span> }<a name="line.238"></a>
<span class="sourceLineNo">239</span><a name="line.239"></a>
<span class="sourceLineNo">240</span> public String formatMessage(CommandIssuer issuer, MessageType type, MessageKeyProvider key, String... replacements) {<a name="line.240"></a>
<span class="sourceLineNo">241</span> String message = getLocales().getMessage(issuer, key.getMessageKey());<a name="line.241"></a>
<span class="sourceLineNo">242</span> if (replacements.length &gt; 0) {<a name="line.242"></a>
<span class="sourceLineNo">243</span> message = ACFUtil.replaceStrings(message, replacements);<a name="line.243"></a>
<span class="sourceLineNo">244</span> }<a name="line.244"></a>
<span class="sourceLineNo">245</span><a name="line.245"></a>
<span class="sourceLineNo">246</span> message = getCommandReplacements().replace(message);<a name="line.246"></a>
<span class="sourceLineNo">238</span> return result;<a name="line.238"></a>
<span class="sourceLineNo">239</span> }<a name="line.239"></a>
<span class="sourceLineNo">240</span><a name="line.240"></a>
<span class="sourceLineNo">241</span> public void sendMessage(I issuerArg, MessageType type, MessageKeyProvider key, String... replacements) {<a name="line.241"></a>
<span class="sourceLineNo">242</span> sendMessage(getCommandIssuer(issuerArg), type, key, replacements);<a name="line.242"></a>
<span class="sourceLineNo">243</span> }<a name="line.243"></a>
<span class="sourceLineNo">244</span><a name="line.244"></a>
<span class="sourceLineNo">245</span> public void sendMessage(CommandIssuer issuer, MessageType type, MessageKeyProvider key, String... replacements) {<a name="line.245"></a>
<span class="sourceLineNo">246</span> String message = formatMessage(issuer, type, key, replacements);<a name="line.246"></a>
<span class="sourceLineNo">247</span><a name="line.247"></a>
<span class="sourceLineNo">248</span> MessageFormatter formatter = formatters.getOrDefault(type, defaultFormatter);<a name="line.248"></a>
<span class="sourceLineNo">249</span> if (formatter != null) {<a name="line.249"></a>
<span class="sourceLineNo">250</span> message = formatter.format(message);<a name="line.250"></a>
<span class="sourceLineNo">251</span> }<a name="line.251"></a>
<span class="sourceLineNo">252</span> return message;<a name="line.252"></a>
<span class="sourceLineNo">253</span> }<a name="line.253"></a>
<span class="sourceLineNo">254</span><a name="line.254"></a>
<span class="sourceLineNo">255</span> public Locale getIssuerLocale(CommandIssuer issuer) {<a name="line.255"></a>
<span class="sourceLineNo">256</span> return getLocales().getDefaultLocale();<a name="line.256"></a>
<span class="sourceLineNo">257</span> }<a name="line.257"></a>
<span class="sourceLineNo">248</span> for (String msg : ACFPatterns.NEWLINE.split(message)) {<a name="line.248"></a>
<span class="sourceLineNo">249</span> issuer.sendMessageInternal(ACFUtil.rtrim(msg));<a name="line.249"></a>
<span class="sourceLineNo">250</span> }<a name="line.250"></a>
<span class="sourceLineNo">251</span> }<a name="line.251"></a>
<span class="sourceLineNo">252</span><a name="line.252"></a>
<span class="sourceLineNo">253</span> public String formatMessage(CommandIssuer issuer, MessageType type, MessageKeyProvider key, String... replacements) {<a name="line.253"></a>
<span class="sourceLineNo">254</span> String message = getLocales().getMessage(issuer, key.getMessageKey());<a name="line.254"></a>
<span class="sourceLineNo">255</span> if (replacements.length &gt; 0) {<a name="line.255"></a>
<span class="sourceLineNo">256</span> message = ACFUtil.replaceStrings(message, replacements);<a name="line.256"></a>
<span class="sourceLineNo">257</span> }<a name="line.257"></a>
<span class="sourceLineNo">258</span><a name="line.258"></a>
<span class="sourceLineNo">259</span><a name="line.259"></a>
<span class="sourceLineNo">260</span> public CommandOperationContext createCommandOperationContext(BaseCommand command, CommandIssuer issuer, String commandLabel, String[] args) {<a name="line.260"></a>
<span class="sourceLineNo">261</span> return new CommandOperationContext(<a name="line.261"></a>
<span class="sourceLineNo">262</span> this,<a name="line.262"></a>
<span class="sourceLineNo">263</span> issuer,<a name="line.263"></a>
<span class="sourceLineNo">264</span> command,<a name="line.264"></a>
<span class="sourceLineNo">265</span> commandLabel,<a name="line.265"></a>
<span class="sourceLineNo">266</span> args<a name="line.266"></a>
<span class="sourceLineNo">267</span> );<a name="line.267"></a>
<span class="sourceLineNo">268</span> }<a name="line.268"></a>
<span class="sourceLineNo">269</span><a name="line.269"></a>
<span class="sourceLineNo">270</span> /**<a name="line.270"></a>
<span class="sourceLineNo">271</span> * Gets a list of all currently supported languages for this manager.<a name="line.271"></a>
<span class="sourceLineNo">272</span> * These locales will be automatically loaded from<a name="line.272"></a>
<span class="sourceLineNo">273</span> * @return<a name="line.273"></a>
<span class="sourceLineNo">274</span> */<a name="line.274"></a>
<span class="sourceLineNo">275</span> public Set&lt;Locale&gt; getSupportedLanguages() {<a name="line.275"></a>
<span class="sourceLineNo">276</span> return supportedLanguages;<a name="line.276"></a>
<span class="sourceLineNo">277</span> }<a name="line.277"></a>
<span class="sourceLineNo">278</span><a name="line.278"></a>
<span class="sourceLineNo">279</span> /**<a name="line.279"></a>
<span class="sourceLineNo">280</span> * Adds a new locale to the list of automatic Locales to load Message Bundles for.<a name="line.280"></a>
<span class="sourceLineNo">281</span> * All bundles loaded under the previous supported languages will now automatically load for this new locale too.<a name="line.281"></a>
<span class="sourceLineNo">282</span> *<a name="line.282"></a>
<span class="sourceLineNo">283</span> * @param locale<a name="line.283"></a>
<span class="sourceLineNo">284</span> */<a name="line.284"></a>
<span class="sourceLineNo">285</span> public void addSupportedLanguage(Locale locale) {<a name="line.285"></a>
<span class="sourceLineNo">286</span> supportedLanguages.add(locale);<a name="line.286"></a>
<span class="sourceLineNo">287</span> getLocales().loadMissingBundles();<a name="line.287"></a>
<span class="sourceLineNo">288</span> }<a name="line.288"></a>
<span class="sourceLineNo">289</span><a name="line.289"></a>
<span class="sourceLineNo">290</span> /**<a name="line.290"></a>
<span class="sourceLineNo">291</span> * @deprecated Use this with caution! If you enable and use Unstable API's, your next compile using ACF<a name="line.291"></a>
<span class="sourceLineNo">292</span> * may require you to update your implementation to those unstable API's<a name="line.292"></a>
<span class="sourceLineNo">293</span> */<a name="line.293"></a>
<span class="sourceLineNo">294</span> @Deprecated<a name="line.294"></a>
<span class="sourceLineNo">295</span> public void enableUnstableAPI(String api) {<a name="line.295"></a>
<span class="sourceLineNo">296</span> unstableAPIs.add(api);<a name="line.296"></a>
<span class="sourceLineNo">297</span> }<a name="line.297"></a>
<span class="sourceLineNo">298</span> void verifyUnstableAPI(String api) {<a name="line.298"></a>
<span class="sourceLineNo">299</span> if (!unstableAPIs.contains(api)) {<a name="line.299"></a>
<span class="sourceLineNo">300</span> throw new IllegalStateException("Using an unstable API that has not been enabled ( " + api + "). See https://acfunstable.emc.gs");<a name="line.300"></a>
<span class="sourceLineNo">301</span> }<a name="line.301"></a>
<span class="sourceLineNo">302</span> }<a name="line.302"></a>
<span class="sourceLineNo">303</span>}<a name="line.303"></a>
<span class="sourceLineNo">259</span> message = getCommandReplacements().replace(message);<a name="line.259"></a>
<span class="sourceLineNo">260</span><a name="line.260"></a>
<span class="sourceLineNo">261</span> MessageFormatter formatter = formatters.getOrDefault(type, defaultFormatter);<a name="line.261"></a>
<span class="sourceLineNo">262</span> if (formatter != null) {<a name="line.262"></a>
<span class="sourceLineNo">263</span> message = formatter.format(message);<a name="line.263"></a>
<span class="sourceLineNo">264</span> }<a name="line.264"></a>
<span class="sourceLineNo">265</span> return message;<a name="line.265"></a>
<span class="sourceLineNo">266</span> }<a name="line.266"></a>
<span class="sourceLineNo">267</span><a name="line.267"></a>
<span class="sourceLineNo">268</span> public Locale getIssuerLocale(CommandIssuer issuer) {<a name="line.268"></a>
<span class="sourceLineNo">269</span> return getLocales().getDefaultLocale();<a name="line.269"></a>
<span class="sourceLineNo">270</span> }<a name="line.270"></a>
<span class="sourceLineNo">271</span><a name="line.271"></a>
<span class="sourceLineNo">272</span><a name="line.272"></a>
<span class="sourceLineNo">273</span> public CommandOperationContext createCommandOperationContext(BaseCommand command, CommandIssuer issuer, String commandLabel, String[] args) {<a name="line.273"></a>
<span class="sourceLineNo">274</span> return new CommandOperationContext(<a name="line.274"></a>
<span class="sourceLineNo">275</span> this,<a name="line.275"></a>
<span class="sourceLineNo">276</span> issuer,<a name="line.276"></a>
<span class="sourceLineNo">277</span> command,<a name="line.277"></a>
<span class="sourceLineNo">278</span> commandLabel,<a name="line.278"></a>
<span class="sourceLineNo">279</span> args<a name="line.279"></a>
<span class="sourceLineNo">280</span> );<a name="line.280"></a>
<span class="sourceLineNo">281</span> }<a name="line.281"></a>
<span class="sourceLineNo">282</span><a name="line.282"></a>
<span class="sourceLineNo">283</span> /**<a name="line.283"></a>
<span class="sourceLineNo">284</span> * Gets a list of all currently supported languages for this manager.<a name="line.284"></a>
<span class="sourceLineNo">285</span> * These locales will be automatically loaded from<a name="line.285"></a>
<span class="sourceLineNo">286</span> * @return<a name="line.286"></a>
<span class="sourceLineNo">287</span> */<a name="line.287"></a>
<span class="sourceLineNo">288</span> public Set&lt;Locale&gt; getSupportedLanguages() {<a name="line.288"></a>
<span class="sourceLineNo">289</span> return supportedLanguages;<a name="line.289"></a>
<span class="sourceLineNo">290</span> }<a name="line.290"></a>
<span class="sourceLineNo">291</span><a name="line.291"></a>
<span class="sourceLineNo">292</span> /**<a name="line.292"></a>
<span class="sourceLineNo">293</span> * Adds a new locale to the list of automatic Locales to load Message Bundles for.<a name="line.293"></a>
<span class="sourceLineNo">294</span> * All bundles loaded under the previous supported languages will now automatically load for this new locale too.<a name="line.294"></a>
<span class="sourceLineNo">295</span> *<a name="line.295"></a>
<span class="sourceLineNo">296</span> * @param locale<a name="line.296"></a>
<span class="sourceLineNo">297</span> */<a name="line.297"></a>
<span class="sourceLineNo">298</span> public void addSupportedLanguage(Locale locale) {<a name="line.298"></a>
<span class="sourceLineNo">299</span> supportedLanguages.add(locale);<a name="line.299"></a>
<span class="sourceLineNo">300</span> getLocales().loadMissingBundles();<a name="line.300"></a>
<span class="sourceLineNo">301</span> }<a name="line.301"></a>
<span class="sourceLineNo">302</span><a name="line.302"></a>
<span class="sourceLineNo">303</span> /**<a name="line.303"></a>
<span class="sourceLineNo">304</span> * @deprecated Use this with caution! If you enable and use Unstable API's, your next compile using ACF<a name="line.304"></a>
<span class="sourceLineNo">305</span> * may require you to update your implementation to those unstable API's<a name="line.305"></a>
<span class="sourceLineNo">306</span> */<a name="line.306"></a>
<span class="sourceLineNo">307</span> @Deprecated<a name="line.307"></a>
<span class="sourceLineNo">308</span> public void enableUnstableAPI(String api) {<a name="line.308"></a>
<span class="sourceLineNo">309</span> unstableAPIs.add(api);<a name="line.309"></a>
<span class="sourceLineNo">310</span> }<a name="line.310"></a>
<span class="sourceLineNo">311</span> void verifyUnstableAPI(String api) {<a name="line.311"></a>
<span class="sourceLineNo">312</span> if (!unstableAPIs.contains(api)) {<a name="line.312"></a>
<span class="sourceLineNo">313</span> throw new IllegalStateException("Using an unstable API that has not been enabled ( " + api + "). See https://acfunstable.emc.gs");<a name="line.313"></a>
<span class="sourceLineNo">314</span> }<a name="line.314"></a>
<span class="sourceLineNo">315</span> }<a name="line.315"></a>
<span class="sourceLineNo">316</span>}<a name="line.316"></a>
@@ -53,13 +53,16 @@
<span class="sourceLineNo">045</span> NOT_ALLOWED_ON_CONSOLE,<a name="line.45"></a>
<span class="sourceLineNo">046</span> COULD_NOT_FIND_PLAYER,<a name="line.46"></a>
<span class="sourceLineNo">047</span> HELP_FORMAT,<a name="line.47"></a>
<span class="sourceLineNo">048</span> NO_COMMAND_MATCHED_SEARCH;<a name="line.48"></a>
<span class="sourceLineNo">049</span><a name="line.49"></a>
<span class="sourceLineNo">050</span> private final MessageKey key = MessageKey.of("acf-core." + this.name().toLowerCase());<a name="line.50"></a>
<span class="sourceLineNo">051</span> public MessageKey getMessageKey() {<a name="line.51"></a>
<span class="sourceLineNo">052</span> return key;<a name="line.52"></a>
<span class="sourceLineNo">053</span> }<a name="line.53"></a>
<span class="sourceLineNo">054</span>}<a name="line.54"></a>
<span class="sourceLineNo">048</span> NO_COMMAND_MATCHED_SEARCH,<a name="line.48"></a>
<span class="sourceLineNo">049</span> HELP_PAGE_INFORMATION,<a name="line.49"></a>
<span class="sourceLineNo">050</span> HELP_NO_RESULTS<a name="line.50"></a>
<span class="sourceLineNo">051</span> ;<a name="line.51"></a>
<span class="sourceLineNo">052</span><a name="line.52"></a>
<span class="sourceLineNo">053</span> private final MessageKey key = MessageKey.of("acf-core." + this.name().toLowerCase());<a name="line.53"></a>
<span class="sourceLineNo">054</span> public MessageKey getMessageKey() {<a name="line.54"></a>
<span class="sourceLineNo">055</span> return key;<a name="line.55"></a>
<span class="sourceLineNo">056</span> }<a name="line.56"></a>
<span class="sourceLineNo">057</span>}<a name="line.57"></a>