uTools-Manuals/docs/java/javax/script/ScriptContext.html

596 lines
23 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
compact1, compact2, compact3
</div>
<div class="subTitle">
javax.script
</div>
<h2 class="title" title="Interface ScriptContext">Interface ScriptContext</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
所有已知实现类:
</dt>
<dd>
<span><a href="../../javax/script/SimpleScriptContext.html" title="javax.script中的类">SimpleScriptContext</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">ScriptContext</span></pre>
<div class="block">
<span>该接口的实现类用于将脚本引擎与对象(如作用域绑定)连接在托管应用程序中。</span>
<span>每个范围是一组命名属性,其值可以使用<code>ScriptContext</code>方法进行设置和检索。</span>
<span>ScriptContexts还暴露了ScriptEngines可以用于输入和输出的读者和作者。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.6
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
<caption>
<span>Fields</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#ENGINE_SCOPE">ENGINE_SCOPE</a></span></code>
<div class="block">
EngineScope属性在单个
<code>ScriptEngine</code>的生存期内可见,并为每个引擎
<code>ScriptEngine</code>一组属性。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#GLOBAL_SCOPE">GLOBAL_SCOPE</a></span></code>
<div class="block">
由相同ScriptEngineFactory创建的所有引擎都可以看到GlobalScope属性。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#getAttribute-java.lang.String-">getAttribute</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
在搜索顺序中最早出现的范围内检索具有给定名称的属性的值。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#getAttribute-java.lang.String-int-">getAttribute</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> name, int scope)</code>
<div class="block">
获取给定范围内的属性值。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#getAttributesScope-java.lang.String-">getAttributesScope</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
获取定义属性的最低范围。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../javax/script/Bindings.html" title="interface in javax.script">Bindings</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#getBindings-int-">getBindings</a></span>(int scope)</code>
<div class="block">
获得与
<code>Bindings</code> ScriptContext中给定范围相关
<code>ScriptContext</code>
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../java/io/Writer.html" title="class in java.io">Writer</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#getErrorWriter--">getErrorWriter</a></span>()</code>
<div class="block">
返回
<code>Writer</code>用于显示错误输出。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../java/io/Reader.html" title="class in java.io">Reader</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#getReader--">getReader</a></span>()</code>
<div class="block">
返回一个
<code>Reader</code> ,由脚本用来读取输入。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../java/lang/Integer.html" title="class in java.lang">Integer</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#getScopes--">getScopes</a></span>()</code>
<div class="block">
返回不可
<code>List</code>的List
<code>List</code>中范围的所有有效值。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code><a href="../../java/io/Writer.html" title="class in java.io">Writer</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#getWriter--">getWriter</a></span>()</code>
<div class="block">
返回
<code>Writer</code>脚本的显示输出时使用。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#removeAttribute-java.lang.String-int-">removeAttribute</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> name, int scope)</code>
<div class="block">
删除给定范围内的属性。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#setAttribute-java.lang.String-java.lang.Object-int-">setAttribute</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> value, int scope)</code>
<div class="block">
设置给定范围内的属性值。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#setBindings-javax.script.Bindings-int-">setBindings</a></span>(<a href="../../javax/script/Bindings.html" title="interface in javax.script">Bindings</a> bindings, int scope)</code>
<div class="block">
<code>Bindings</code>实例与此
<code>ScriptContext</code>的特定范围相关
<code>ScriptContext</code>
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#setErrorWriter-java.io.Writer-">setErrorWriter</a></span>(<a href="../../java/io/Writer.html" title="class in java.io">Writer</a> writer)</code>
<div class="block">
设置
<code>Writer</code>用于显示错误输出。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#setReader-java.io.Reader-">setReader</a></span>(<a href="../../java/io/Reader.html" title="class in java.io">Reader</a> reader)</code>
<div class="block">
设置
<code>Reader</code>脚本以读取输入。
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptContext.html#setWriter-java.io.Writer-">setWriter</a></span>(<a href="../../java/io/Writer.html" title="class in java.io">Writer</a> writer)</code>
<div class="block">
设置
<code>Writer</code>用于显示输出时使用的脚本。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- --> </a> <h3>字段详细信息</h3> <a name="ENGINE_SCOPE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ENGINE_SCOPE</h4> <pre>static final int ENGINE_SCOPE</pre>
<div class="block">
EngineScope属性在单个
<code>ScriptEngine</code>的生存期内可见,并为每个引擎
<code>ScriptEngine</code>一组属性。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.script.ScriptContext.ENGINE_SCOPE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="GLOBAL_SCOPE">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>GLOBAL_SCOPE</h4> <pre>static final int GLOBAL_SCOPE</pre>
<div class="block">
由相同ScriptEngineFactory创建的所有引擎都可以看到GlobalScope属性。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.script.ScriptContext.GLOBAL_SCOPE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="setBindings-javax.script.Bindings-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setBindings</h4> <pre>void setBindings(<a href="../../javax/script/Bindings.html" title="interface in javax.script">Bindings</a> bindings,
int scope)</pre>
<div class="block">
<span><code>Bindings</code>实例与此<code>ScriptContext</code>的特定范围相关<code>ScriptContext</code></span>
<span>呼叫到<code>getAttribute</code><code>setAttribute</code>方法必须映射到<code>get</code><code>put</code>的方法<code>Bindings</code>指定的范围。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>bindings</code> - 与给定范围
<code>Bindings</code>的Bindings
</dd>
<dd>
<code>scope</code> - 范围
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> -如果没有
<code>Bindings</code>一种用于在这种类型的ScriptContexts在规定范围值来定义。
</dd>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果范围值为
<code>ENGINE_SCOPE</code> ,指定的
<code>Bindings</code>为空。
</dd>
</dl> </li>
</ul> <a name="getBindings-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getBindings</h4> <pre><a href="../../javax/script/Bindings.html" title="interface in javax.script">Bindings</a> getBindings(int scope)</pre>
<div class="block">
获取与
<code>Bindings</code> ScriptContext中给定范围
<code>ScriptContext</code>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>scope</code> - 范围
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>相关联的<code>Bindings</code></span>
<span>如果尚未设置,则返回<code>null</code></span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> -如果没有
<code>Bindings</code>被用于在指定的范围值定义
<code>ScriptContext</code>这种类型。
</dd>
</dl> </li>
</ul> <a name="setAttribute-java.lang.String-java.lang.Object-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setAttribute</h4> <pre>void setAttribute(<a href="../../java/lang/String.html" title="class in java.lang">String</a> name,
<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> value,
int scope)</pre>
<div class="block">
设置给定范围内的属性值。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要设置的属性的名称
</dd>
<dd>
<code>value</code> - 属性的值
</dd>
<dd>
<code>scope</code> - 设置属性的范围
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果名称为空或范围无效。
</dd>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果名称为空。
</dd>
</dl> </li>
</ul> <a name="getAttribute-java.lang.String-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttribute</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> getAttribute(<a href="../../java/lang/String.html" title="class in java.lang">String</a> name,
int scope)</pre>
<div class="block">
获取给定范围内的属性值。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要检索的属性的名称。
</dd>
<dd>
<code>scope</code> - 检索属性的范围。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>属性的值。</span>
<span>返回<code>null</code>是给定范围内不存在的名称。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果名称为空或范围值无效。
</dd>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果名称为空。
</dd>
</dl> </li>
</ul> <a name="removeAttribute-java.lang.String-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeAttribute</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> removeAttribute(<a href="../../java/lang/String.html" title="class in java.lang">String</a> name,
int scope)</pre>
<div class="block">
删除给定范围内的属性。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要删除的属性的名称
</dd>
<dd>
<code>scope</code> - 删除属性的范围
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
删除的值。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果名称为空或范围无效。
</dd>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果名称为空。
</dd>
</dl> </li>
</ul> <a name="getAttribute-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttribute</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> getAttribute(<a href="../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
<div class="block">
<span>在搜索顺序中最早出现的范围内检索具有给定名称的属性的值。</span>
<span>顺序由作用域参数的数值确定(最低范围值首先)</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要检索的属性的名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>定义具有给定名称的属性的最低范围内的属性值。</span>
<span>如果在任何范围内都不存在名称的属性则返回null。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果名称为空。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果名称为空。
</dd>
</dl> </li>
</ul> <a name="getAttributesScope-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributesScope</h4> <pre>int getAttributesScope(<a href="../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
<div class="block">
获取定义属性的最低范围。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> -
<code>name</code>名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>最低的范围。</span>
<span>如果在任何范围内未定义具有给定名称的属性,则返回-1。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果name为null。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果名称为空。
</dd>
</dl> </li>
</ul> <a name="getWriter--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getWriter</h4> <pre><a href="../../java/io/Writer.html" title="class in java.io">Writer</a> getWriter()</pre>
<div class="block">
返回
<code>Writer</code>用于显示输出时使用的脚本。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>Writer</code>
</dd>
</dl> </li>
</ul> <a name="getErrorWriter--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getErrorWriter</h4> <pre><a href="../../java/io/Writer.html" title="class in java.io">Writer</a> getErrorWriter()</pre>
<div class="block">
返回
<code>Writer</code>用于显示错误输出。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>Writer</code>
</dd>
</dl> </li>
</ul> <a name="setWriter-java.io.Writer-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setWriter</h4> <pre>void setWriter(<a href="../../java/io/Writer.html" title="class in java.io">Writer</a> writer)</pre>
<div class="block">
设置
<code>Writer</code>用于显示输出时使用的脚本。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>writer</code> - 全新
<code>Writer</code>
</dd>
</dl> </li>
</ul> <a name="setErrorWriter-java.io.Writer-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setErrorWriter</h4> <pre>void setErrorWriter(<a href="../../java/io/Writer.html" title="class in java.io">Writer</a> writer)</pre>
<div class="block">
设置用于显示错误输出的
<code>Writer</code>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>writer</code> -
<code>Writer</code>
</dd>
</dl> </li>
</ul> <a name="getReader--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getReader</h4> <pre><a href="../../java/io/Reader.html" title="class in java.io">Reader</a> getReader()</pre>
<div class="block">
返回一个
<code>Reader</code>以供脚本使用以读取输入。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>Reader</code>
</dd>
</dl> </li>
</ul> <a name="setReader-java.io.Reader-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setReader</h4> <pre>void setReader(<a href="../../java/io/Reader.html" title="class in java.io">Reader</a> reader)</pre>
<div class="block">
为脚本设置
<code>Reader</code>以读取输入。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>reader</code> - 全新
<code>Reader</code>
</dd>
</dl> </li>
</ul> <a name="getScopes--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getScopes</h4> <pre><a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../java/lang/Integer.html" title="class in java.lang">Integer</a>&gt; getScopes()</pre>
<div class="block">
<code>List</code>中为范围的所有有效值返回不变的List。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
范围值列表
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>