update javadocs

This commit is contained in:
Aikar
2017-11-22 22:41:16 -05:00
parent 70571a4a0a
commit 1e85b9bf42
7 changed files with 322 additions and 257 deletions
@@ -148,7 +148,7 @@ extends co.aikar.commands.RegisteredCommand&lt;<a href="../../../co/aikar/comman
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;co.aikar.commands.RegisteredCommand</h3>
<code>addSubcommand, addSubcommands, getCommand, getPermission, getPrefSubCommand, getSyntaxText</code></li>
<code>addSubcommand, addSubcommands, getCommand, getPermission, getPermissions, getPrefSubCommand, getSyntaxText, requiresPermission</code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
@@ -148,7 +148,7 @@ extends co.aikar.commands.RegisteredCommand&lt;<a href="../../../co/aikar/comman
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;co.aikar.commands.RegisteredCommand</h3>
<code>addSubcommand, addSubcommands, getCommand, getPermission, getPrefSubCommand, getSyntaxText</code></li>
<code>addSubcommand, addSubcommands, getCommand, getPermission, getPermissions, getPrefSubCommand, getSyntaxText, requiresPermission</code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
@@ -18,8 +18,8 @@
catch(err) {
}
//-->
var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var methods = {"i0":10,"i1":10,"i2":10,"i3":42,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"],32:["t6","Deprecated Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
@@ -109,7 +109,7 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<hr>
<br>
<pre>public class <a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.46">RegisteredCommand</a>&lt;R extends <a href="../../../co/aikar/commands/CommandExecutionContext.html" title="class in co.aikar.commands">CommandExecutionContext</a>&lt;? extends <a href="../../../co/aikar/commands/CommandExecutionContext.html" title="class in co.aikar.commands">CommandExecutionContext</a>,? extends <a href="../../../co/aikar/commands/CommandIssuer.html" title="interface in co.aikar.commands">CommandIssuer</a>&gt;&gt;
<pre>public class <a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.48">RegisteredCommand</a>&lt;R extends <a href="../../../co/aikar/commands/CommandExecutionContext.html" title="class in co.aikar.commands">CommandExecutionContext</a>&lt;? extends <a href="../../../co/aikar/commands/CommandExecutionContext.html" title="class in co.aikar.commands">CommandExecutionContext</a>,? extends <a href="../../../co/aikar/commands/CommandIssuer.html" title="interface in co.aikar.commands">CommandIssuer</a>&gt;&gt;
extends <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
</li>
</ul>
@@ -124,7 +124,7 @@ extends <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?
</a>
<h3>Method Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t6" class="tableTab"><span><a href="javascript:show(32);">Deprecated Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
@@ -143,24 +143,34 @@ extends <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?
</tr>
<tr id="i3" class="rowColor">
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../co/aikar/commands/RegisteredCommand.html#getPermission--">getPermission</a></span>()</code>&nbsp;</td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../co/aikar/commands/RegisteredCommand.html#getPermission--">getPermission</a></span>()</code>
<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;&nbsp;</div>
</td>
</tr>
<tr id="i4" class="altColor">
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../co/aikar/commands/RegisteredCommand.html#getPrefSubCommand--">getPrefSubCommand</a></span>()</code>&nbsp;</td>
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a>&lt;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../co/aikar/commands/RegisteredCommand.html#getPermissions--">getPermissions</a></span>()</code>&nbsp;</td>
</tr>
<tr id="i5" class="rowColor">
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../co/aikar/commands/RegisteredCommand.html#getSyntaxText--">getSyntaxText</a></span>()</code>&nbsp;</td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../co/aikar/commands/RegisteredCommand.html#getPrefSubCommand--">getPrefSubCommand</a></span>()</code>&nbsp;</td>
</tr>
<tr id="i6" class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../co/aikar/commands/RegisteredCommand.html#postCommand--">postCommand</a></span>()</code>&nbsp;</td>
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../co/aikar/commands/RegisteredCommand.html#getSyntaxText--">getSyntaxText</a></span>()</code>&nbsp;</td>
</tr>
<tr id="i7" class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../co/aikar/commands/RegisteredCommand.html#postCommand--">postCommand</a></span>()</code>&nbsp;</td>
</tr>
<tr id="i8" class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../co/aikar/commands/RegisteredCommand.html#preCommand--">preCommand</a></span>()</code>&nbsp;</td>
</tr>
<tr id="i9" class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../co/aikar/commands/RegisteredCommand.html#requiresPermission-java.lang.String-">requiresPermission</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;permission)</code>&nbsp;</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
@@ -189,7 +199,7 @@ extends <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?
<ul class="blockList">
<li class="blockList">
<h4>preCommand</h4>
<pre>public&nbsp;void&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.148">preCommand</a>()</pre>
<pre>public&nbsp;void&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.150">preCommand</a>()</pre>
</li>
</ul>
<a name="postCommand--">
@@ -198,7 +208,7 @@ extends <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?
<ul class="blockList">
<li class="blockList">
<h4>postCommand</h4>
<pre>public&nbsp;void&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.149">postCommand</a>()</pre>
<pre>public&nbsp;void&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.151">postCommand</a>()</pre>
</li>
</ul>
<a name="getPermission--">
@@ -207,7 +217,31 @@ extends <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?
<ul class="blockList">
<li class="blockList">
<h4>getPermission</h4>
<pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.240">getPermission</a>()</pre>
<pre><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Deprecated.html?is-external=true" title="class or interface in java.lang">@Deprecated</a>
public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.248">getPermission</a>()</pre>
<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../co/aikar/commands/RegisteredCommand.html#getPermissions--"><code>getPermissions()</code></a></dd>
</dl>
</li>
</ul>
<a name="getPermissions--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getPermissions</h4>
<pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a>&lt;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&gt;&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.255">getPermissions</a>()</pre>
</li>
</ul>
<a name="requiresPermission-java.lang.String-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>requiresPermission</h4>
<pre>public&nbsp;boolean&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.262">requiresPermission</a>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;permission)</pre>
</li>
</ul>
<a name="getPrefSubCommand--">
@@ -216,7 +250,7 @@ extends <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?
<ul class="blockList">
<li class="blockList">
<h4>getPrefSubCommand</h4>
<pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.244">getPrefSubCommand</a>()</pre>
<pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.266">getPrefSubCommand</a>()</pre>
</li>
</ul>
<a name="getSyntaxText--">
@@ -225,7 +259,7 @@ extends <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?
<ul class="blockList">
<li class="blockList">
<h4>getSyntaxText</h4>
<pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.248">getSyntaxText</a>()</pre>
<pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.270">getSyntaxText</a>()</pre>
</li>
</ul>
<a name="getCommand--">
@@ -234,7 +268,7 @@ extends <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?
<ul class="blockList">
<li class="blockList">
<h4>getCommand</h4>
<pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.252">getCommand</a>()</pre>
<pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.274">getCommand</a>()</pre>
</li>
</ul>
<a name="addSubcommand-java.lang.String-">
@@ -243,7 +277,7 @@ extends <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?
<ul class="blockList">
<li class="blockList">
<h4>addSubcommand</h4>
<pre>public&nbsp;void&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.256">addSubcommand</a>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;cmd)</pre>
<pre>public&nbsp;void&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.278">addSubcommand</a>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;cmd)</pre>
</li>
</ul>
<a name="addSubcommands-java.util.Collection-">
@@ -252,7 +286,7 @@ extends <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?
<ul class="blockListLast">
<li class="blockList">
<h4>addSubcommands</h4>
<pre>public&nbsp;void&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.259">addSubcommands</a>(<a href="http://docs.oracle.com/javase/8/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&gt;&nbsp;cmd)</pre>
<pre>public&nbsp;void&nbsp;<a href="../../../src-html/co/aikar/commands/RegisteredCommand.html#line.281">addSubcommands</a>(<a href="http://docs.oracle.com/javase/8/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&gt;&nbsp;cmd)</pre>
</li>
</ul>
</li>
+7 -4
View File
@@ -165,25 +165,28 @@
</td>
</tr>
<tr class="rowColor">
<td class="colOne"><a href="co/aikar/commands/ACFUtil.html#random-java.lang.Class-">co.aikar.commands.ACFUtil.random(Class&lt;? extends T&gt;)</a></td>
<td class="colOne"><a href="co/aikar/commands/RegisteredCommand.html#getPermission--">co.aikar.commands.RegisteredCommand.getPermission()</a>&nbsp;</td>
</tr>
<tr class="altColor">
<td class="colOne"><a href="co/aikar/commands/ACFUtil.html#random-java.lang.Class-">co.aikar.commands.ACFUtil.random(Class&lt;? extends T&gt;)</a></td>
</tr>
<tr class="rowColor">
<td class="colOne"><a href="co/aikar/commands/CommandContexts.html#registerSenderAwareContext-java.lang.Class-co.aikar.commands.contexts.IssuerAwareContextResolver-">co.aikar.commands.CommandContexts.registerSenderAwareContext(Class&lt;T&gt;, IssuerAwareContextResolver&lt;T, R&gt;)</a>
<div class="block"><span class="deprecationComment">Please switch to <a href="co/aikar/commands/CommandContexts.html#registerIssuerAwareContext-java.lang.Class-co.aikar.commands.contexts.IssuerAwareContextResolver-"><code>CommandContexts.registerIssuerAwareContext(Class, IssuerAwareContextResolver)</code></a>
as the core wants to use the platform agnostic term of "Issuer" instead of Sender</span></div>
</td>
</tr>
<tr class="rowColor">
<tr class="altColor">
<td class="colOne"><a href="co/aikar/commands/CommandIssuer.html#sendMessageInternal-java.lang.String-">co.aikar.commands.CommandIssuer.sendMessageInternal(String)</a>
<div class="block"><span class="deprecationComment">Do not call this, for internal use. Not considered part of the API and may break.</span></div>
</td>
</tr>
<tr class="altColor">
<tr class="rowColor">
<td class="colOne"><a href="co/aikar/commands/CommandManager.html#setDefaultHelpPerPage-int-">co.aikar.commands.CommandManager.setDefaultHelpPerPage(int)</a>
<div class="block"><span class="deprecationComment">Unstable API</span></div>
</td>
</tr>
<tr class="rowColor">
<tr class="altColor">
<td class="colOne"><a href="co/aikar/commands/BaseCommand.html#showCommandHelp--">co.aikar.commands.BaseCommand.showCommandHelp()</a>
<div class="block"><span class="deprecationComment">Unstable API</span></div>
</td>
+6
View File
@@ -577,6 +577,10 @@
<dt><span class="memberNameLink"><a href="co/aikar/commands/CommandExecutionContext.html#getPassedArgs--">getPassedArgs()</a></span> - Method in class co.aikar.commands.<a href="co/aikar/commands/CommandExecutionContext.html" title="class in co.aikar.commands">CommandExecutionContext</a></dt>
<dd>&nbsp;</dd>
<dt><span class="memberNameLink"><a href="co/aikar/commands/RegisteredCommand.html#getPermission--">getPermission()</a></span> - Method in class co.aikar.commands.<a href="co/aikar/commands/RegisteredCommand.html" title="class in co.aikar.commands">RegisteredCommand</a></dt>
<dd>
<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;</div>
</dd>
<dt><span class="memberNameLink"><a href="co/aikar/commands/RegisteredCommand.html#getPermissions--">getPermissions()</a></span> - Method in class co.aikar.commands.<a href="co/aikar/commands/RegisteredCommand.html" title="class in co.aikar.commands">RegisteredCommand</a></dt>
<dd>&nbsp;</dd>
<dt><span class="memberNameLink"><a href="co/aikar/commands/RegisteredCommand.html#getPrefSubCommand--">getPrefSubCommand()</a></span> - Method in class co.aikar.commands.<a href="co/aikar/commands/RegisteredCommand.html" title="class in co.aikar.commands">RegisteredCommand</a></dt>
<dd>&nbsp;</dd>
@@ -1211,6 +1215,8 @@
<dd>&nbsp;</dd>
<dt><span class="memberNameLink"><a href="co/aikar/commands/ACFUtil.html#replaceStrings-java.lang.String-java.lang.String...-">replaceStrings(String, String...)</a></span> - Static method in class co.aikar.commands.<a href="co/aikar/commands/ACFUtil.html" title="class in co.aikar.commands">ACFUtil</a></dt>
<dd>&nbsp;</dd>
<dt><span class="memberNameLink"><a href="co/aikar/commands/RegisteredCommand.html#requiresPermission-java.lang.String-">requiresPermission(String)</a></span> - Method in class co.aikar.commands.<a href="co/aikar/commands/RegisteredCommand.html" title="class in co.aikar.commands">RegisteredCommand</a></dt>
<dd>&nbsp;</dd>
<dt><span class="memberNameLink"><a href="co/aikar/commands/Locales.html#ROMANIAN">ROMANIAN</a></span> - Static variable in class co.aikar.commands.<a href="co/aikar/commands/Locales.html" title="class in co.aikar.commands">Locales</a></dt>
<dd>&nbsp;</dd>
<dt><span class="memberNameLink"><a href="co/aikar/commands/CommandManager.html#rootCommands">rootCommands</a></span> - Variable in class co.aikar.commands.<a href="co/aikar/commands/CommandManager.html" title="class in co.aikar.commands">CommandManager</a></dt>
@@ -36,238 +36,260 @@
<span class="sourceLineNo">028</span>import co.aikar.commands.contexts.IssuerAwareContextResolver;<a name="line.28"></a>
<span class="sourceLineNo">029</span>import co.aikar.commands.contexts.IssuerOnlyContextResolver;<a name="line.29"></a>
<span class="sourceLineNo">030</span>import co.aikar.commands.contexts.OptionalContextResolver;<a name="line.30"></a>
<span class="sourceLineNo">031</span>import com.google.common.collect.Lists;<a name="line.31"></a>
<span class="sourceLineNo">032</span>import com.google.common.collect.Maps;<a name="line.32"></a>
<span class="sourceLineNo">033</span>import com.google.common.collect.Sets;<a name="line.33"></a>
<span class="sourceLineNo">034</span>import org.jetbrains.annotations.Nullable;<a name="line.34"></a>
<span class="sourceLineNo">035</span><a name="line.35"></a>
<span class="sourceLineNo">036</span>import java.lang.reflect.InvocationTargetException;<a name="line.36"></a>
<span class="sourceLineNo">037</span>import java.lang.reflect.Method;<a name="line.37"></a>
<span class="sourceLineNo">038</span>import java.lang.reflect.Parameter;<a name="line.38"></a>
<span class="sourceLineNo">039</span>import java.util.ArrayList;<a name="line.39"></a>
<span class="sourceLineNo">040</span>import java.util.Collection;<a name="line.40"></a>
<span class="sourceLineNo">041</span>import java.util.List;<a name="line.41"></a>
<span class="sourceLineNo">042</span>import java.util.Map;<a name="line.42"></a>
<span class="sourceLineNo">043</span>import java.util.Set;<a name="line.43"></a>
<span class="sourceLineNo">044</span>import java.util.stream.Collectors;<a name="line.44"></a>
<span class="sourceLineNo">045</span><a name="line.45"></a>
<span class="sourceLineNo">046</span>public class RegisteredCommand &lt;R extends CommandExecutionContext&lt;? extends CommandExecutionContext, ? extends CommandIssuer&gt;&gt; {<a name="line.46"></a>
<span class="sourceLineNo">047</span> final BaseCommand scope;<a name="line.47"></a>
<span class="sourceLineNo">048</span> final String command;<a name="line.48"></a>
<span class="sourceLineNo">049</span> final Method method;<a name="line.49"></a>
<span class="sourceLineNo">050</span> final String prefSubCommand;<a name="line.50"></a>
<span class="sourceLineNo">051</span> final Parameter[] parameters;<a name="line.51"></a>
<span class="sourceLineNo">052</span> final ContextResolver&lt;?, R&gt;[] resolvers;<a name="line.52"></a>
<span class="sourceLineNo">053</span> final String syntaxText;<a name="line.53"></a>
<span class="sourceLineNo">054</span> final String helpText;<a name="line.54"></a>
<span class="sourceLineNo">055</span><a name="line.55"></a>
<span class="sourceLineNo">056</span> private final String permission;<a name="line.56"></a>
<span class="sourceLineNo">057</span> final String complete;<a name="line.57"></a>
<span class="sourceLineNo">058</span> final int requiredResolvers;<a name="line.58"></a>
<span class="sourceLineNo">059</span> final int optionalResolvers;<a name="line.59"></a>
<span class="sourceLineNo">060</span> final List&lt;String&gt; registeredSubcommands = new ArrayList&lt;&gt;();<a name="line.60"></a>
<span class="sourceLineNo">061</span><a name="line.61"></a>
<span class="sourceLineNo">062</span> RegisteredCommand(BaseCommand scope, String command, Method method, String prefSubCommand) {<a name="line.62"></a>
<span class="sourceLineNo">063</span> this.scope = scope;<a name="line.63"></a>
<span class="sourceLineNo">064</span> if ("__unknown".equals(prefSubCommand) || "__default".equals(prefSubCommand)) {<a name="line.64"></a>
<span class="sourceLineNo">065</span> prefSubCommand = "";<a name="line.65"></a>
<span class="sourceLineNo">066</span> }<a name="line.66"></a>
<span class="sourceLineNo">067</span> this.command = command + (method.getAnnotation(CommandAlias.class) == null &amp;&amp; !prefSubCommand.isEmpty() ? prefSubCommand : "");<a name="line.67"></a>
<span class="sourceLineNo">068</span> this.method = method;<a name="line.68"></a>
<span class="sourceLineNo">069</span> this.prefSubCommand = prefSubCommand;<a name="line.69"></a>
<span class="sourceLineNo">070</span> CommandPermission permissionAnno = method.getAnnotation(CommandPermission.class);<a name="line.70"></a>
<span class="sourceLineNo">071</span> this.permission = permissionAnno != null ? scope.manager.getCommandReplacements().replace(permissionAnno.value()) : null;<a name="line.71"></a>
<span class="sourceLineNo">072</span> CommandCompletion completionAnno = method.getAnnotation(CommandCompletion.class);<a name="line.72"></a>
<span class="sourceLineNo">073</span> this.complete = completionAnno != null ? scope.manager.getCommandReplacements().replace(completionAnno.value()) : null;<a name="line.73"></a>
<span class="sourceLineNo">074</span> this.parameters = method.getParameters();<a name="line.74"></a>
<span class="sourceLineNo">075</span><a name="line.75"></a>
<span class="sourceLineNo">076</span> Description descriptionAnno = method.getAnnotation(Description.class);<a name="line.76"></a>
<span class="sourceLineNo">077</span> this.helpText = descriptionAnno != null ? descriptionAnno.value() : "";<a name="line.77"></a>
<span class="sourceLineNo">078</span> //noinspection unchecked<a name="line.78"></a>
<span class="sourceLineNo">079</span> this.resolvers = new ContextResolver[this.parameters.length];<a name="line.79"></a>
<span class="sourceLineNo">080</span> final Syntax syntaxStr = method.getAnnotation(Syntax.class);<a name="line.80"></a>
<span class="sourceLineNo">081</span> final CommandManager manager = scope.manager;<a name="line.81"></a>
<span class="sourceLineNo">082</span> final CommandContexts commandContexts = manager.getCommandContexts();<a name="line.82"></a>
<span class="sourceLineNo">083</span><a name="line.83"></a>
<span class="sourceLineNo">084</span> int requiredResolvers = 0;<a name="line.84"></a>
<span class="sourceLineNo">085</span> int optionalResolvers = 0;<a name="line.85"></a>
<span class="sourceLineNo">086</span> StringBuilder syntaxB = new StringBuilder(64);<a name="line.86"></a>
<span class="sourceLineNo">087</span><a name="line.87"></a>
<span class="sourceLineNo">088</span> for (int i = 0; i &lt; parameters.length; i++) {<a name="line.88"></a>
<span class="sourceLineNo">089</span> final Parameter parameter = parameters[i];<a name="line.89"></a>
<span class="sourceLineNo">090</span> final Class&lt;?&gt; type = parameter.getType();<a name="line.90"></a>
<span class="sourceLineNo">091</span><a name="line.91"></a>
<span class="sourceLineNo">092</span> //noinspection unchecked<a name="line.92"></a>
<span class="sourceLineNo">093</span> final ContextResolver&lt;?, R&gt; resolver = commandContexts.getResolver(type);<a name="line.93"></a>
<span class="sourceLineNo">094</span> if (resolver != null) {<a name="line.94"></a>
<span class="sourceLineNo">095</span> resolvers[i] = resolver;<a name="line.95"></a>
<span class="sourceLineNo">096</span><a name="line.96"></a>
<span class="sourceLineNo">097</span> if (!scope.manager.isCommandIssuer(type)) {<a name="line.97"></a>
<span class="sourceLineNo">098</span> String name = parameter.getName();<a name="line.98"></a>
<span class="sourceLineNo">099</span> if (isOptionalResolver(resolver, parameter)) {<a name="line.99"></a>
<span class="sourceLineNo">100</span> optionalResolvers++;<a name="line.100"></a>
<span class="sourceLineNo">101</span> if (!(resolver instanceof IssuerOnlyContextResolver)) {<a name="line.101"></a>
<span class="sourceLineNo">102</span> syntaxB.append('[').append(name).append("] ");<a name="line.102"></a>
<span class="sourceLineNo">103</span> }<a name="line.103"></a>
<span class="sourceLineNo">104</span> } else {<a name="line.104"></a>
<span class="sourceLineNo">105</span> requiredResolvers++;<a name="line.105"></a>
<span class="sourceLineNo">106</span> syntaxB.append('&lt;').append(name).append("&gt; ");<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> } else {<a name="line.109"></a>
<span class="sourceLineNo">110</span> ACFUtil.sneaky(new InvalidCommandContextException(<a name="line.110"></a>
<span class="sourceLineNo">111</span> "Parameter " + type.getSimpleName() + " of " + this.command + " has no applicable context resolver"<a name="line.111"></a>
<span class="sourceLineNo">112</span> ));<a name="line.112"></a>
<span class="sourceLineNo">113</span> }<a name="line.113"></a>
<span class="sourceLineNo">114</span> }<a name="line.114"></a>
<span class="sourceLineNo">115</span> String syntaxText = syntaxB.toString();<a name="line.115"></a>
<span class="sourceLineNo">116</span> this.syntaxText = manager.getCommandReplacements().replace(syntaxStr != null ?<a name="line.116"></a>
<span class="sourceLineNo">117</span> ACFUtil.replace(syntaxStr.value(), "@syntax", syntaxText) : syntaxText);<a name="line.117"></a>
<span class="sourceLineNo">118</span> this.requiredResolvers = requiredResolvers;<a name="line.118"></a>
<span class="sourceLineNo">119</span> this.optionalResolvers = optionalResolvers;<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> private boolean isOptionalResolver(ContextResolver&lt;?, R&gt; resolver, Parameter parameter) {<a name="line.122"></a>
<span class="sourceLineNo">123</span> return isOptionalResolver(resolver)<a name="line.123"></a>
<span class="sourceLineNo">124</span> || parameter.getAnnotation(Optional.class) != null<a name="line.124"></a>
<span class="sourceLineNo">125</span> || parameter.getAnnotation(Default.class) != null;<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> private boolean isOptionalResolver(ContextResolver&lt;?, R&gt; resolver) {<a name="line.128"></a>
<span class="sourceLineNo">129</span> return resolver instanceof IssuerAwareContextResolver || resolver instanceof IssuerOnlyContextResolver<a name="line.129"></a>
<span class="sourceLineNo">130</span> || resolver instanceof OptionalContextResolver;<a name="line.130"></a>
<span class="sourceLineNo">131</span> }<a name="line.131"></a>
<span class="sourceLineNo">132</span><a name="line.132"></a>
<span class="sourceLineNo">133</span> void invoke(CommandIssuer sender, List&lt;String&gt; args) {<a name="line.133"></a>
<span class="sourceLineNo">134</span> if (!scope.canExecute(sender, this)) {<a name="line.134"></a>
<span class="sourceLineNo">135</span> return;<a name="line.135"></a>
<span class="sourceLineNo">136</span> }<a name="line.136"></a>
<span class="sourceLineNo">137</span> preCommand();<a name="line.137"></a>
<span class="sourceLineNo">138</span> try {<a name="line.138"></a>
<span class="sourceLineNo">139</span> Map&lt;String, Object&gt; passedArgs = resolveContexts(sender, args);<a name="line.139"></a>
<span class="sourceLineNo">140</span> if (passedArgs == null) return;<a name="line.140"></a>
<span class="sourceLineNo">141</span><a name="line.141"></a>
<span class="sourceLineNo">142</span> method.invoke(scope, passedArgs.values().toArray());<a name="line.142"></a>
<span class="sourceLineNo">143</span> } catch (Exception e) {<a name="line.143"></a>
<span class="sourceLineNo">144</span> handleException(sender, args, e);<a name="line.144"></a>
<span class="sourceLineNo">145</span> }<a name="line.145"></a>
<span class="sourceLineNo">146</span> postCommand();<a name="line.146"></a>
<span class="sourceLineNo">147</span> }<a name="line.147"></a>
<span class="sourceLineNo">148</span> public void preCommand() {}<a name="line.148"></a>
<span class="sourceLineNo">149</span> public void postCommand() {}<a name="line.149"></a>
<span class="sourceLineNo">150</span><a name="line.150"></a>
<span class="sourceLineNo">151</span> void handleException(CommandIssuer sender, List&lt;String&gt; args, Exception e) {<a name="line.151"></a>
<span class="sourceLineNo">152</span> if (e instanceof InvocationTargetException &amp;&amp; e.getCause() instanceof InvalidCommandArgument) {<a name="line.152"></a>
<span class="sourceLineNo">153</span> e = (Exception) e.getCause();<a name="line.153"></a>
<span class="sourceLineNo">154</span> }<a name="line.154"></a>
<span class="sourceLineNo">155</span> if (e instanceof InvalidCommandArgument) {<a name="line.155"></a>
<span class="sourceLineNo">156</span> InvalidCommandArgument ica = (InvalidCommandArgument) e;<a name="line.156"></a>
<span class="sourceLineNo">157</span> if (ica.key != null) {<a name="line.157"></a>
<span class="sourceLineNo">158</span> sender.sendMessage(MessageType.ERROR, ica.key, ica.replacements);<a name="line.158"></a>
<span class="sourceLineNo">159</span> } else if (e.getMessage() != null &amp;&amp; !e.getMessage().isEmpty()) {<a name="line.159"></a>
<span class="sourceLineNo">160</span> sender.sendMessage(MessageType.ERROR, MessageKeys.ERROR_PREFIX, "{message}", e.getMessage());<a name="line.160"></a>
<span class="sourceLineNo">161</span> }<a name="line.161"></a>
<span class="sourceLineNo">162</span> if (ica.showSyntax) {<a name="line.162"></a>
<span class="sourceLineNo">163</span> scope.showSyntax(sender, this);<a name="line.163"></a>
<span class="sourceLineNo">164</span> }<a name="line.164"></a>
<span class="sourceLineNo">165</span> } else {<a name="line.165"></a>
<span class="sourceLineNo">166</span> boolean handeled = this.scope.manager.handleUncaughtException(scope, this, sender, args, e);<a name="line.166"></a>
<span class="sourceLineNo">167</span> if(!handeled){<a name="line.167"></a>
<span class="sourceLineNo">168</span> sender.sendMessage(MessageType.ERROR, MessageKeys.ERROR_PERFORMING_COMMAND);<a name="line.168"></a>
<span class="sourceLineNo">169</span> }<a name="line.169"></a>
<span class="sourceLineNo">170</span> this.scope.manager.log(LogLevel.ERROR, "Exception in command: " + command + " " + ACFUtil.join(args), e);<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><a name="line.173"></a>
<span class="sourceLineNo">174</span> @Nullable<a name="line.174"></a>
<span class="sourceLineNo">175</span> Map&lt;String, Object&gt; resolveContexts(CommandIssuer sender, List&lt;String&gt; args) throws InvalidCommandArgument {<a name="line.175"></a>
<span class="sourceLineNo">176</span> return resolveContexts(sender, args, parameters.length);<a name="line.176"></a>
<span class="sourceLineNo">177</span> }<a name="line.177"></a>
<span class="sourceLineNo">178</span> @Nullable<a name="line.178"></a>
<span class="sourceLineNo">179</span> Map&lt;String, Object&gt; resolveContexts(CommandIssuer sender, List&lt;String&gt; args, int argLimit) throws InvalidCommandArgument {<a name="line.179"></a>
<span class="sourceLineNo">180</span> args = Lists.newArrayList(args);<a name="line.180"></a>
<span class="sourceLineNo">181</span> String[] origArgs = args.toArray(new String[args.size()]);<a name="line.181"></a>
<span class="sourceLineNo">182</span> Map&lt;String, Object&gt; passedArgs = Maps.newLinkedHashMap();<a name="line.182"></a>
<span class="sourceLineNo">183</span> int remainingRequired = requiredResolvers;<a name="line.183"></a>
<span class="sourceLineNo">184</span> for (int i = 0; i &lt; parameters.length &amp;&amp; i &lt; argLimit; i++) {<a name="line.184"></a>
<span class="sourceLineNo">185</span> boolean isLast = i == parameters.length - 1;<a name="line.185"></a>
<span class="sourceLineNo">186</span> boolean allowOptional = remainingRequired == 0;<a name="line.186"></a>
<span class="sourceLineNo">187</span> final Parameter parameter = parameters[i];<a name="line.187"></a>
<span class="sourceLineNo">188</span> final String parameterName = parameter.getName();<a name="line.188"></a>
<span class="sourceLineNo">189</span> final Class&lt;?&gt; type = parameter.getType();<a name="line.189"></a>
<span class="sourceLineNo">190</span> //noinspection unchecked<a name="line.190"></a>
<span class="sourceLineNo">191</span> final ContextResolver&lt;?, R&gt; resolver = resolvers[i];<a name="line.191"></a>
<span class="sourceLineNo">192</span> R context = this.scope.manager.createCommandContext(this, parameter, sender, args, i, passedArgs);<a name="line.192"></a>
<span class="sourceLineNo">193</span> boolean isOptionalResolver = isOptionalResolver(resolver, parameter);<a name="line.193"></a>
<span class="sourceLineNo">194</span> if (!isOptionalResolver) {<a name="line.194"></a>
<span class="sourceLineNo">195</span> remainingRequired--;<a name="line.195"></a>
<span class="sourceLineNo">196</span> }<a name="line.196"></a>
<span class="sourceLineNo">197</span> if (args.isEmpty() &amp;&amp; !(isLast &amp;&amp; type == String[].class)) {<a name="line.197"></a>
<span class="sourceLineNo">198</span> Default def = parameter.getAnnotation(Default.class);<a name="line.198"></a>
<span class="sourceLineNo">199</span> Optional opt = parameter.getAnnotation(Optional.class);<a name="line.199"></a>
<span class="sourceLineNo">200</span> if (allowOptional &amp;&amp; def != null) {<a name="line.200"></a>
<span class="sourceLineNo">201</span> args.add(scope.manager.getCommandReplacements().replace(def.value()));<a name="line.201"></a>
<span class="sourceLineNo">202</span> } else if (allowOptional &amp;&amp; opt != null) {<a name="line.202"></a>
<span class="sourceLineNo">203</span> passedArgs.put(parameterName, isOptionalResolver(resolver) ? resolver.getContext(context) : null);<a name="line.203"></a>
<span class="sourceLineNo">204</span> //noinspection UnnecessaryContinue<a name="line.204"></a>
<span class="sourceLineNo">205</span> continue;<a name="line.205"></a>
<span class="sourceLineNo">206</span> } else if (!isOptionalResolver) {<a name="line.206"></a>
<span class="sourceLineNo">207</span> scope.showSyntax(sender, this);<a name="line.207"></a>
<span class="sourceLineNo">208</span> return null;<a name="line.208"></a>
<span class="sourceLineNo">209</span> }<a name="line.209"></a>
<span class="sourceLineNo">210</span> }<a name="line.210"></a>
<span class="sourceLineNo">211</span> final Values values = parameter.getAnnotation(Values.class);<a name="line.211"></a>
<span class="sourceLineNo">212</span> if (values != null) {<a name="line.212"></a>
<span class="sourceLineNo">213</span> String arg = !args.isEmpty() ? args.get(0) : "";<a name="line.213"></a>
<span class="sourceLineNo">214</span><a name="line.214"></a>
<span class="sourceLineNo">215</span> final String[] split = ACFPatterns.PIPE.split(scope.manager.getCommandReplacements().replace(values.value()));<a name="line.215"></a>
<span class="sourceLineNo">216</span> Set&lt;String&gt; possible = Sets.newHashSet();<a name="line.216"></a>
<span class="sourceLineNo">217</span> for (String s : split) {<a name="line.217"></a>
<span class="sourceLineNo">218</span> List&lt;String&gt; check = this.scope.manager.getCommandCompletions().getCompletionValues(this, sender, s, origArgs);<a name="line.218"></a>
<span class="sourceLineNo">219</span> if (!check.isEmpty()) {<a name="line.219"></a>
<span class="sourceLineNo">220</span> possible.addAll(check.stream().map(String::toLowerCase).collect(Collectors.toList()));<a name="line.220"></a>
<span class="sourceLineNo">221</span> } else {<a name="line.221"></a>
<span class="sourceLineNo">222</span> possible.add(s.toLowerCase());<a name="line.222"></a>
<span class="sourceLineNo">223</span> }<a name="line.223"></a>
<span class="sourceLineNo">224</span> }<a name="line.224"></a>
<span class="sourceLineNo">225</span><a name="line.225"></a>
<span class="sourceLineNo">226</span> if (!possible.contains(arg.toLowerCase())) {<a name="line.226"></a>
<span class="sourceLineNo">227</span> throw new InvalidCommandArgument(MessageKeys.PLEASE_SPECIFY_ONE_OF,<a name="line.227"></a>
<span class="sourceLineNo">228</span> "{valid}", ACFUtil.join(possible, ", "));<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> passedArgs.put(parameterName, resolver.getContext(context));<a name="line.231"></a>
<span class="sourceLineNo">232</span> }<a name="line.232"></a>
<span class="sourceLineNo">233</span> return passedArgs;<a name="line.233"></a>
<span class="sourceLineNo">234</span> }<a name="line.234"></a>
<span class="sourceLineNo">235</span><a name="line.235"></a>
<span class="sourceLineNo">236</span> boolean hasPermission(CommandIssuer issuer) {<a name="line.236"></a>
<span class="sourceLineNo">237</span> return (permission == null || permission.isEmpty() || scope.manager.hasPermission(issuer, permission)) &amp;&amp; scope.hasPermission(issuer);<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 getPermission() {<a name="line.240"></a>
<span class="sourceLineNo">241</span> return permission;<a name="line.241"></a>
<span class="sourceLineNo">242</span> }<a name="line.242"></a>
<span class="sourceLineNo">243</span><a name="line.243"></a>
<span class="sourceLineNo">244</span> public String getPrefSubCommand() {<a name="line.244"></a>
<span class="sourceLineNo">245</span> return prefSubCommand;<a name="line.245"></a>
<span class="sourceLineNo">246</span> }<a name="line.246"></a>
<span class="sourceLineNo">247</span><a name="line.247"></a>
<span class="sourceLineNo">248</span> public String getSyntaxText() {<a name="line.248"></a>
<span class="sourceLineNo">249</span> return syntaxText;<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> public String getCommand() {<a name="line.252"></a>
<span class="sourceLineNo">253</span> return command;<a name="line.253"></a>
<span class="sourceLineNo">254</span> }<a name="line.254"></a>
<span class="sourceLineNo">255</span><a name="line.255"></a>
<span class="sourceLineNo">256</span> public void addSubcommand(String cmd) {<a name="line.256"></a>
<span class="sourceLineNo">257</span> this.registeredSubcommands.add(cmd);<a name="line.257"></a>
<span class="sourceLineNo">258</span> }<a name="line.258"></a>
<span class="sourceLineNo">259</span> public void addSubcommands(Collection&lt;String&gt; cmd) {<a name="line.259"></a>
<span class="sourceLineNo">260</span> this.registeredSubcommands.addAll(cmd);<a name="line.260"></a>
<span class="sourceLineNo">261</span> }<a name="line.261"></a>
<span class="sourceLineNo">262</span>}<a name="line.262"></a>
<span class="sourceLineNo">031</span>import com.google.common.collect.ImmutableSet;<a name="line.31"></a>
<span class="sourceLineNo">032</span>import com.google.common.collect.Lists;<a name="line.32"></a>
<span class="sourceLineNo">033</span>import com.google.common.collect.Maps;<a name="line.33"></a>
<span class="sourceLineNo">034</span>import com.google.common.collect.Sets;<a name="line.34"></a>
<span class="sourceLineNo">035</span>import org.jetbrains.annotations.Nullable;<a name="line.35"></a>
<span class="sourceLineNo">036</span><a name="line.36"></a>
<span class="sourceLineNo">037</span>import java.lang.reflect.InvocationTargetException;<a name="line.37"></a>
<span class="sourceLineNo">038</span>import java.lang.reflect.Method;<a name="line.38"></a>
<span class="sourceLineNo">039</span>import java.lang.reflect.Parameter;<a name="line.39"></a>
<span class="sourceLineNo">040</span>import java.util.ArrayList;<a name="line.40"></a>
<span class="sourceLineNo">041</span>import java.util.Collection;<a name="line.41"></a>
<span class="sourceLineNo">042</span>import java.util.List;<a name="line.42"></a>
<span class="sourceLineNo">043</span>import java.util.Map;<a name="line.43"></a>
<span class="sourceLineNo">044</span>import java.util.Set;<a name="line.44"></a>
<span class="sourceLineNo">045</span>import java.util.stream.Collectors;<a name="line.45"></a>
<span class="sourceLineNo">046</span><a name="line.46"></a>
<span class="sourceLineNo">047</span>@SuppressWarnings("WeakerAccess")<a name="line.47"></a>
<span class="sourceLineNo">048</span>public class RegisteredCommand &lt;R extends CommandExecutionContext&lt;? extends CommandExecutionContext, ? extends CommandIssuer&gt;&gt; {<a name="line.48"></a>
<span class="sourceLineNo">049</span> final BaseCommand scope;<a name="line.49"></a>
<span class="sourceLineNo">050</span> final String command;<a name="line.50"></a>
<span class="sourceLineNo">051</span> final Method method;<a name="line.51"></a>
<span class="sourceLineNo">052</span> final String prefSubCommand;<a name="line.52"></a>
<span class="sourceLineNo">053</span> final Parameter[] parameters;<a name="line.53"></a>
<span class="sourceLineNo">054</span> final ContextResolver&lt;?, R&gt;[] resolvers;<a name="line.54"></a>
<span class="sourceLineNo">055</span> final String syntaxText;<a name="line.55"></a>
<span class="sourceLineNo">056</span> final String helpText;<a name="line.56"></a>
<span class="sourceLineNo">057</span><a name="line.57"></a>
<span class="sourceLineNo">058</span> private final String permission;<a name="line.58"></a>
<span class="sourceLineNo">059</span> final String complete;<a name="line.59"></a>
<span class="sourceLineNo">060</span> final int requiredResolvers;<a name="line.60"></a>
<span class="sourceLineNo">061</span> final int optionalResolvers;<a name="line.61"></a>
<span class="sourceLineNo">062</span> final List&lt;String&gt; registeredSubcommands = new ArrayList&lt;&gt;();<a name="line.62"></a>
<span class="sourceLineNo">063</span><a name="line.63"></a>
<span class="sourceLineNo">064</span> RegisteredCommand(BaseCommand scope, String command, Method method, String prefSubCommand) {<a name="line.64"></a>
<span class="sourceLineNo">065</span> this.scope = scope;<a name="line.65"></a>
<span class="sourceLineNo">066</span> if ("__unknown".equals(prefSubCommand) || "__default".equals(prefSubCommand)) {<a name="line.66"></a>
<span class="sourceLineNo">067</span> prefSubCommand = "";<a name="line.67"></a>
<span class="sourceLineNo">068</span> }<a name="line.68"></a>
<span class="sourceLineNo">069</span> this.command = command + (method.getAnnotation(CommandAlias.class) == null &amp;&amp; !prefSubCommand.isEmpty() ? prefSubCommand : "");<a name="line.69"></a>
<span class="sourceLineNo">070</span> this.method = method;<a name="line.70"></a>
<span class="sourceLineNo">071</span> this.prefSubCommand = prefSubCommand;<a name="line.71"></a>
<span class="sourceLineNo">072</span> CommandPermission permissionAnno = method.getAnnotation(CommandPermission.class);<a name="line.72"></a>
<span class="sourceLineNo">073</span> this.permission = permissionAnno != null ? scope.manager.getCommandReplacements().replace(permissionAnno.value()) : null;<a name="line.73"></a>
<span class="sourceLineNo">074</span> CommandCompletion completionAnno = method.getAnnotation(CommandCompletion.class);<a name="line.74"></a>
<span class="sourceLineNo">075</span> this.complete = completionAnno != null ? scope.manager.getCommandReplacements().replace(completionAnno.value()) : null;<a name="line.75"></a>
<span class="sourceLineNo">076</span> this.parameters = method.getParameters();<a name="line.76"></a>
<span class="sourceLineNo">077</span><a name="line.77"></a>
<span class="sourceLineNo">078</span> Description descriptionAnno = method.getAnnotation(Description.class);<a name="line.78"></a>
<span class="sourceLineNo">079</span> this.helpText = descriptionAnno != null ? descriptionAnno.value() : "";<a name="line.79"></a>
<span class="sourceLineNo">080</span> //noinspection unchecked<a name="line.80"></a>
<span class="sourceLineNo">081</span> this.resolvers = new ContextResolver[this.parameters.length];<a name="line.81"></a>
<span class="sourceLineNo">082</span> final Syntax syntaxStr = method.getAnnotation(Syntax.class);<a name="line.82"></a>
<span class="sourceLineNo">083</span> final CommandManager manager = scope.manager;<a name="line.83"></a>
<span class="sourceLineNo">084</span> final CommandContexts commandContexts = manager.getCommandContexts();<a name="line.84"></a>
<span class="sourceLineNo">085</span><a name="line.85"></a>
<span class="sourceLineNo">086</span> int requiredResolvers = 0;<a name="line.86"></a>
<span class="sourceLineNo">087</span> int optionalResolvers = 0;<a name="line.87"></a>
<span class="sourceLineNo">088</span> StringBuilder syntaxB = new StringBuilder(64);<a name="line.88"></a>
<span class="sourceLineNo">089</span><a name="line.89"></a>
<span class="sourceLineNo">090</span> for (int i = 0; i &lt; parameters.length; i++) {<a name="line.90"></a>
<span class="sourceLineNo">091</span> final Parameter parameter = parameters[i];<a name="line.91"></a>
<span class="sourceLineNo">092</span> final Class&lt;?&gt; type = parameter.getType();<a name="line.92"></a>
<span class="sourceLineNo">093</span><a name="line.93"></a>
<span class="sourceLineNo">094</span> //noinspection unchecked<a name="line.94"></a>
<span class="sourceLineNo">095</span> final ContextResolver&lt;?, R&gt; resolver = commandContexts.getResolver(type);<a name="line.95"></a>
<span class="sourceLineNo">096</span> if (resolver != null) {<a name="line.96"></a>
<span class="sourceLineNo">097</span> resolvers[i] = resolver;<a name="line.97"></a>
<span class="sourceLineNo">098</span><a name="line.98"></a>
<span class="sourceLineNo">099</span> if (!scope.manager.isCommandIssuer(type)) {<a name="line.99"></a>
<span class="sourceLineNo">100</span> String name = parameter.getName();<a name="line.100"></a>
<span class="sourceLineNo">101</span> if (isOptionalResolver(resolver, parameter)) {<a name="line.101"></a>
<span class="sourceLineNo">102</span> optionalResolvers++;<a name="line.102"></a>
<span class="sourceLineNo">103</span> if (!(resolver instanceof IssuerOnlyContextResolver)) {<a name="line.103"></a>
<span class="sourceLineNo">104</span> syntaxB.append('[').append(name).append("] ");<a name="line.104"></a>
<span class="sourceLineNo">105</span> }<a name="line.105"></a>
<span class="sourceLineNo">106</span> } else {<a name="line.106"></a>
<span class="sourceLineNo">107</span> requiredResolvers++;<a name="line.107"></a>
<span class="sourceLineNo">108</span> syntaxB.append('&lt;').append(name).append("&gt; ");<a name="line.108"></a>
<span class="sourceLineNo">109</span> }<a name="line.109"></a>
<span class="sourceLineNo">110</span> }<a name="line.110"></a>
<span class="sourceLineNo">111</span> } else {<a name="line.111"></a>
<span class="sourceLineNo">112</span> ACFUtil.sneaky(new InvalidCommandContextException(<a name="line.112"></a>
<span class="sourceLineNo">113</span> "Parameter " + type.getSimpleName() + " of " + this.command + " has no applicable context resolver"<a name="line.113"></a>
<span class="sourceLineNo">114</span> ));<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> String syntaxText = syntaxB.toString();<a name="line.117"></a>
<span class="sourceLineNo">118</span> this.syntaxText = manager.getCommandReplacements().replace(syntaxStr != null ?<a name="line.118"></a>
<span class="sourceLineNo">119</span> ACFUtil.replace(syntaxStr.value(), "@syntax", syntaxText) : syntaxText);<a name="line.119"></a>
<span class="sourceLineNo">120</span> this.requiredResolvers = requiredResolvers;<a name="line.120"></a>
<span class="sourceLineNo">121</span> this.optionalResolvers = optionalResolvers;<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> private boolean isOptionalResolver(ContextResolver&lt;?, R&gt; resolver, Parameter parameter) {<a name="line.124"></a>
<span class="sourceLineNo">125</span> return isOptionalResolver(resolver)<a name="line.125"></a>
<span class="sourceLineNo">126</span> || parameter.getAnnotation(Optional.class) != null<a name="line.126"></a>
<span class="sourceLineNo">127</span> || parameter.getAnnotation(Default.class) != null;<a name="line.127"></a>
<span class="sourceLineNo">128</span> }<a name="line.128"></a>
<span class="sourceLineNo">129</span><a name="line.129"></a>
<span class="sourceLineNo">130</span> private boolean isOptionalResolver(ContextResolver&lt;?, R&gt; resolver) {<a name="line.130"></a>
<span class="sourceLineNo">131</span> return resolver instanceof IssuerAwareContextResolver || resolver instanceof IssuerOnlyContextResolver<a name="line.131"></a>
<span class="sourceLineNo">132</span> || resolver instanceof OptionalContextResolver;<a name="line.132"></a>
<span class="sourceLineNo">133</span> }<a name="line.133"></a>
<span class="sourceLineNo">134</span><a name="line.134"></a>
<span class="sourceLineNo">135</span> void invoke(CommandIssuer sender, List&lt;String&gt; args) {<a name="line.135"></a>
<span class="sourceLineNo">136</span> if (!scope.canExecute(sender, this)) {<a name="line.136"></a>
<span class="sourceLineNo">137</span> return;<a name="line.137"></a>
<span class="sourceLineNo">138</span> }<a name="line.138"></a>
<span class="sourceLineNo">139</span> preCommand();<a name="line.139"></a>
<span class="sourceLineNo">140</span> try {<a name="line.140"></a>
<span class="sourceLineNo">141</span> Map&lt;String, Object&gt; passedArgs = resolveContexts(sender, args);<a name="line.141"></a>
<span class="sourceLineNo">142</span> if (passedArgs == null) return;<a name="line.142"></a>
<span class="sourceLineNo">143</span><a name="line.143"></a>
<span class="sourceLineNo">144</span> method.invoke(scope, passedArgs.values().toArray());<a name="line.144"></a>
<span class="sourceLineNo">145</span> } catch (Exception e) {<a name="line.145"></a>
<span class="sourceLineNo">146</span> handleException(sender, args, e);<a name="line.146"></a>
<span class="sourceLineNo">147</span> }<a name="line.147"></a>
<span class="sourceLineNo">148</span> postCommand();<a name="line.148"></a>
<span class="sourceLineNo">149</span> }<a name="line.149"></a>
<span class="sourceLineNo">150</span> public void preCommand() {}<a name="line.150"></a>
<span class="sourceLineNo">151</span> public void postCommand() {}<a name="line.151"></a>
<span class="sourceLineNo">152</span><a name="line.152"></a>
<span class="sourceLineNo">153</span> void handleException(CommandIssuer sender, List&lt;String&gt; args, Exception e) {<a name="line.153"></a>
<span class="sourceLineNo">154</span> if (e instanceof InvocationTargetException &amp;&amp; e.getCause() instanceof InvalidCommandArgument) {<a name="line.154"></a>
<span class="sourceLineNo">155</span> e = (Exception) e.getCause();<a name="line.155"></a>
<span class="sourceLineNo">156</span> }<a name="line.156"></a>
<span class="sourceLineNo">157</span> if (e instanceof InvalidCommandArgument) {<a name="line.157"></a>
<span class="sourceLineNo">158</span> InvalidCommandArgument ica = (InvalidCommandArgument) e;<a name="line.158"></a>
<span class="sourceLineNo">159</span> if (ica.key != null) {<a name="line.159"></a>
<span class="sourceLineNo">160</span> sender.sendMessage(MessageType.ERROR, ica.key, ica.replacements);<a name="line.160"></a>
<span class="sourceLineNo">161</span> } else if (e.getMessage() != null &amp;&amp; !e.getMessage().isEmpty()) {<a name="line.161"></a>
<span class="sourceLineNo">162</span> sender.sendMessage(MessageType.ERROR, MessageKeys.ERROR_PREFIX, "{message}", e.getMessage());<a name="line.162"></a>
<span class="sourceLineNo">163</span> }<a name="line.163"></a>
<span class="sourceLineNo">164</span> if (ica.showSyntax) {<a name="line.164"></a>
<span class="sourceLineNo">165</span> scope.showSyntax(sender, this);<a name="line.165"></a>
<span class="sourceLineNo">166</span> }<a name="line.166"></a>
<span class="sourceLineNo">167</span> } else {<a name="line.167"></a>
<span class="sourceLineNo">168</span> boolean handeled = this.scope.manager.handleUncaughtException(scope, this, sender, args, e);<a name="line.168"></a>
<span class="sourceLineNo">169</span> if(!handeled){<a name="line.169"></a>
<span class="sourceLineNo">170</span> sender.sendMessage(MessageType.ERROR, MessageKeys.ERROR_PERFORMING_COMMAND);<a name="line.170"></a>
<span class="sourceLineNo">171</span> }<a name="line.171"></a>
<span class="sourceLineNo">172</span> this.scope.manager.log(LogLevel.ERROR, "Exception in command: " + command + " " + ACFUtil.join(args), e);<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> @Nullable<a name="line.176"></a>
<span class="sourceLineNo">177</span> Map&lt;String, Object&gt; resolveContexts(CommandIssuer sender, List&lt;String&gt; args) throws InvalidCommandArgument {<a name="line.177"></a>
<span class="sourceLineNo">178</span> return resolveContexts(sender, args, parameters.length);<a name="line.178"></a>
<span class="sourceLineNo">179</span> }<a name="line.179"></a>
<span class="sourceLineNo">180</span> @Nullable<a name="line.180"></a>
<span class="sourceLineNo">181</span> Map&lt;String, Object&gt; resolveContexts(CommandIssuer sender, List&lt;String&gt; args, int argLimit) throws InvalidCommandArgument {<a name="line.181"></a>
<span class="sourceLineNo">182</span> args = Lists.newArrayList(args);<a name="line.182"></a>
<span class="sourceLineNo">183</span> String[] origArgs = args.toArray(new String[args.size()]);<a name="line.183"></a>
<span class="sourceLineNo">184</span> Map&lt;String, Object&gt; passedArgs = Maps.newLinkedHashMap();<a name="line.184"></a>
<span class="sourceLineNo">185</span> int remainingRequired = requiredResolvers;<a name="line.185"></a>
<span class="sourceLineNo">186</span> for (int i = 0; i &lt; parameters.length &amp;&amp; i &lt; argLimit; i++) {<a name="line.186"></a>
<span class="sourceLineNo">187</span> boolean isLast = i == parameters.length - 1;<a name="line.187"></a>
<span class="sourceLineNo">188</span> boolean allowOptional = remainingRequired == 0;<a name="line.188"></a>
<span class="sourceLineNo">189</span> final Parameter parameter = parameters[i];<a name="line.189"></a>
<span class="sourceLineNo">190</span> final String parameterName = parameter.getName();<a name="line.190"></a>
<span class="sourceLineNo">191</span> final Class&lt;?&gt; type = parameter.getType();<a name="line.191"></a>
<span class="sourceLineNo">192</span> //noinspection unchecked<a name="line.192"></a>
<span class="sourceLineNo">193</span> final ContextResolver&lt;?, R&gt; resolver = resolvers[i];<a name="line.193"></a>
<span class="sourceLineNo">194</span> R context = this.scope.manager.createCommandContext(this, parameter, sender, args, i, passedArgs);<a name="line.194"></a>
<span class="sourceLineNo">195</span> boolean isOptionalResolver = isOptionalResolver(resolver, parameter);<a name="line.195"></a>
<span class="sourceLineNo">196</span> if (!isOptionalResolver) {<a name="line.196"></a>
<span class="sourceLineNo">197</span> remainingRequired--;<a name="line.197"></a>
<span class="sourceLineNo">198</span> }<a name="line.198"></a>
<span class="sourceLineNo">199</span> if (args.isEmpty() &amp;&amp; !(isLast &amp;&amp; type == String[].class)) {<a name="line.199"></a>
<span class="sourceLineNo">200</span> Default def = parameter.getAnnotation(Default.class);<a name="line.200"></a>
<span class="sourceLineNo">201</span> Optional opt = parameter.getAnnotation(Optional.class);<a name="line.201"></a>
<span class="sourceLineNo">202</span> if (allowOptional &amp;&amp; def != null) {<a name="line.202"></a>
<span class="sourceLineNo">203</span> args.add(scope.manager.getCommandReplacements().replace(def.value()));<a name="line.203"></a>
<span class="sourceLineNo">204</span> } else if (allowOptional &amp;&amp; opt != null) {<a name="line.204"></a>
<span class="sourceLineNo">205</span> passedArgs.put(parameterName, isOptionalResolver(resolver) ? resolver.getContext(context) : null);<a name="line.205"></a>
<span class="sourceLineNo">206</span> //noinspection UnnecessaryContinue<a name="line.206"></a>
<span class="sourceLineNo">207</span> continue;<a name="line.207"></a>
<span class="sourceLineNo">208</span> } else if (!isOptionalResolver) {<a name="line.208"></a>
<span class="sourceLineNo">209</span> scope.showSyntax(sender, this);<a name="line.209"></a>
<span class="sourceLineNo">210</span> return null;<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> final Values values = parameter.getAnnotation(Values.class);<a name="line.213"></a>
<span class="sourceLineNo">214</span> if (values != null) {<a name="line.214"></a>
<span class="sourceLineNo">215</span> String arg = !args.isEmpty() ? args.get(0) : "";<a name="line.215"></a>
<span class="sourceLineNo">216</span><a name="line.216"></a>
<span class="sourceLineNo">217</span> final String[] split = ACFPatterns.PIPE.split(scope.manager.getCommandReplacements().replace(values.value()));<a name="line.217"></a>
<span class="sourceLineNo">218</span> Set&lt;String&gt; possible = Sets.newHashSet();<a name="line.218"></a>
<span class="sourceLineNo">219</span> for (String s : split) {<a name="line.219"></a>
<span class="sourceLineNo">220</span> List&lt;String&gt; check = this.scope.manager.getCommandCompletions().getCompletionValues(this, sender, s, origArgs);<a name="line.220"></a>
<span class="sourceLineNo">221</span> if (!check.isEmpty()) {<a name="line.221"></a>
<span class="sourceLineNo">222</span> possible.addAll(check.stream().map(String::toLowerCase).collect(Collectors.toList()));<a name="line.222"></a>
<span class="sourceLineNo">223</span> } else {<a name="line.223"></a>
<span class="sourceLineNo">224</span> possible.add(s.toLowerCase());<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><a name="line.227"></a>
<span class="sourceLineNo">228</span> if (!possible.contains(arg.toLowerCase())) {<a name="line.228"></a>
<span class="sourceLineNo">229</span> throw new InvalidCommandArgument(MessageKeys.PLEASE_SPECIFY_ONE_OF,<a name="line.229"></a>
<span class="sourceLineNo">230</span> "{valid}", ACFUtil.join(possible, ", "));<a name="line.230"></a>
<span class="sourceLineNo">231</span> }<a name="line.231"></a>
<span class="sourceLineNo">232</span> }<a name="line.232"></a>
<span class="sourceLineNo">233</span> passedArgs.put(parameterName, resolver.getContext(context));<a name="line.233"></a>
<span class="sourceLineNo">234</span> }<a name="line.234"></a>
<span class="sourceLineNo">235</span> return passedArgs;<a name="line.235"></a>
<span class="sourceLineNo">236</span> }<a name="line.236"></a>
<span class="sourceLineNo">237</span><a name="line.237"></a>
<span class="sourceLineNo">238</span> boolean hasPermission(CommandIssuer issuer) {<a name="line.238"></a>
<span class="sourceLineNo">239</span> return (permission == null || permission.isEmpty() || scope.manager.hasPermission(issuer, permission)) &amp;&amp; scope.hasPermission(issuer);<a name="line.239"></a>
<span class="sourceLineNo">240</span> }<a name="line.240"></a>
<span class="sourceLineNo">241</span><a name="line.241"></a>
<span class="sourceLineNo">242</span><a name="line.242"></a>
<span class="sourceLineNo">243</span> /**<a name="line.243"></a>
<span class="sourceLineNo">244</span> * @see #getPermissions()<a name="line.244"></a>
<span class="sourceLineNo">245</span> * @deprecated<a name="line.245"></a>
<span class="sourceLineNo">246</span> */<a name="line.246"></a>
<span class="sourceLineNo">247</span> @Deprecated<a name="line.247"></a>
<span class="sourceLineNo">248</span> public String getPermission() {<a name="line.248"></a>
<span class="sourceLineNo">249</span> if (this.permission == null || this.permission.isEmpty()) {<a name="line.249"></a>
<span class="sourceLineNo">250</span> return null;<a name="line.250"></a>
<span class="sourceLineNo">251</span> }<a name="line.251"></a>
<span class="sourceLineNo">252</span> return ACFPatterns.COMMA.split(this.permission)[0];<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 Set&lt;String&gt; getPermissions() {<a name="line.255"></a>
<span class="sourceLineNo">256</span> if (this.permission == null || this.permission.isEmpty()) {<a name="line.256"></a>
<span class="sourceLineNo">257</span> return ImmutableSet.of();<a name="line.257"></a>
<span class="sourceLineNo">258</span> }<a name="line.258"></a>
<span class="sourceLineNo">259</span> return Sets.newHashSet(ACFPatterns.COMMA.split(this.permission));<a name="line.259"></a>
<span class="sourceLineNo">260</span> }<a name="line.260"></a>
<span class="sourceLineNo">261</span><a name="line.261"></a>
<span class="sourceLineNo">262</span> public boolean requiresPermission(String permission) {<a name="line.262"></a>
<span class="sourceLineNo">263</span> return getPermissions().contains(permission);<a name="line.263"></a>
<span class="sourceLineNo">264</span> }<a name="line.264"></a>
<span class="sourceLineNo">265</span><a name="line.265"></a>
<span class="sourceLineNo">266</span> public String getPrefSubCommand() {<a name="line.266"></a>
<span class="sourceLineNo">267</span> return prefSubCommand;<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> public String getSyntaxText() {<a name="line.270"></a>
<span class="sourceLineNo">271</span> return syntaxText;<a name="line.271"></a>
<span class="sourceLineNo">272</span> }<a name="line.272"></a>
<span class="sourceLineNo">273</span><a name="line.273"></a>
<span class="sourceLineNo">274</span> public String getCommand() {<a name="line.274"></a>
<span class="sourceLineNo">275</span> return command;<a name="line.275"></a>
<span class="sourceLineNo">276</span> }<a name="line.276"></a>
<span class="sourceLineNo">277</span><a name="line.277"></a>
<span class="sourceLineNo">278</span> public void addSubcommand(String cmd) {<a name="line.278"></a>
<span class="sourceLineNo">279</span> this.registeredSubcommands.add(cmd);<a name="line.279"></a>
<span class="sourceLineNo">280</span> }<a name="line.280"></a>
<span class="sourceLineNo">281</span> public void addSubcommands(Collection&lt;String&gt; cmd) {<a name="line.281"></a>
<span class="sourceLineNo">282</span> this.registeredSubcommands.addAll(cmd);<a name="line.282"></a>
<span class="sourceLineNo">283</span> }<a name="line.283"></a>
<span class="sourceLineNo">284</span>}<a name="line.284"></a>
@@ -148,7 +148,7 @@ extends co.aikar.commands.RegisteredCommand&lt;<a href="../../../co/aikar/comman
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;co.aikar.commands.RegisteredCommand</h3>
<code>addSubcommand, addSubcommands, getCommand, getPermission, getPrefSubCommand, getSyntaxText</code></li>
<code>addSubcommand, addSubcommands, getCommand, getPermission, getPermissions, getPrefSubCommand, getSyntaxText, requiresPermission</code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">