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

826 lines
36 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 ScriptEngine">Interface ScriptEngine</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
所有已知实现类:
</dt>
<dd>
<span><a href="../../javax/script/AbstractScriptEngine.html" title="javax.script中的类">AbstractScriptEngine</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">ScriptEngine</span></pre>
<div class="block">
<span><code>ScriptEngine</code>是基本接口,其方法必须在本规范的每个实现中都具有完全的功能。</span>
<br/>
<br/>
<span>这些方法提供基本的脚本功能。</span>
<span>写入这个简单界面的应用程序预计将在每个实现中进行最少的修改。</span>
<span>它包括执行脚本的方法,以及设置和获取值的方法。</span>
<br/>
<br/>
<span>这些值是两种类型的键/值对。</span>
<span>第一种类型的对由在本说明书中保留和定义其密钥的单个实现组成。</span>
<span>与保留键对中的值具有指定的含义。</span>
<br/>
<br/>
<span>另一种类型的对由创建Java语言绑定的对组成这些值通常由脚本中的相应键或其装饰形式表示。</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 <a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptEngine.html#ARGV">ARGV</a></span></code>
<div class="block">
用于将位置参数数组传递给脚本的命名值的保留键。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static <a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptEngine.html#ENGINE">ENGINE</a></span></code>
<div class="block">
作为
<code>ScriptEngine</code>实现的名称的命名值的保留键。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptEngine.html#ENGINE_VERSION">ENGINE_VERSION</a></span></code>
<div class="block">
保留键指定值标识的版本
<code>ScriptEngine</code>实施。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static <a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptEngine.html#FILENAME">FILENAME</a></span></code>
<div class="block">
作为正在执行的文件的名称的命名值的保留键。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptEngine.html#LANGUAGE">LANGUAGE</a></span></code>
<div class="block">
作为实现支持的脚本语言的全名的命名值的保留键。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static <a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptEngine.html#LANGUAGE_VERSION">LANGUAGE_VERSION</a></span></code>
<div class="block">
用于标识实现支持的脚本语言版本的命名值的保留键。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptEngine.html#NAME">NAME</a></span></code>
<div class="block">
用于标识脚本语言的短名称的命名值的保留键。
</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="../../javax/script/Bindings.html" title="interface in javax.script">Bindings</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptEngine.html#createBindings--">createBindings</a></span>()</code>
<div class="block">
返回未初始化的
<code>Bindings</code>
</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/ScriptEngine.html#eval-java.io.Reader-">eval</a></span>(<a href="../../java/io/Reader.html" title="class in java.io">Reader</a> reader)</code>
<div class="block">
<code>eval(String)</code>相同,只是脚本的来源以
<code>Reader</code>形式提供
</div> </td>
</tr>
<tr class="altColor" id="i2">
<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/ScriptEngine.html#eval-java.io.Reader-javax.script.Bindings-">eval</a></span>(<a href="../../java/io/Reader.html" title="class in java.io">Reader</a> reader, <a href="../../javax/script/Bindings.html" title="interface in javax.script">Bindings</a> n)</code>
<div class="block">
<code>eval(String, Bindings)</code>相同,只是脚本的来源以
<code>Reader</code>形式提供。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<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/ScriptEngine.html#eval-java.io.Reader-javax.script.ScriptContext-">eval</a></span>(<a href="../../java/io/Reader.html" title="class in java.io">Reader</a> reader, <a href="../../javax/script/ScriptContext.html" title="interface in javax.script">ScriptContext</a> context)</code>
<div class="block">
<code>eval(String, ScriptContext)</code>相同,其中脚本的来源是从
<code>Reader</code>读取的。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<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/ScriptEngine.html#eval-java.lang.String-">eval</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> script)</code>
<div class="block">
执行指定的脚本。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<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/ScriptEngine.html#eval-java.lang.String-javax.script.Bindings-">eval</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> script, <a href="../../javax/script/Bindings.html" title="interface in javax.script">Bindings</a> n)</code>
<div class="block">
执行使用该脚本
<code>Bindings</code>参数为
<code>ENGINE_SCOPE</code>
<code>Bindings</code>的的
<code>ScriptEngine</code>脚本执行期间。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<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/ScriptEngine.html#eval-java.lang.String-javax.script.ScriptContext-">eval</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> script, <a href="../../javax/script/ScriptContext.html" title="interface in javax.script">ScriptContext</a> context)</code>
<div class="block">
导致立即执行脚本其脚本是作为第一个参数传递的String。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<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/ScriptEngine.html#get-java.lang.String-">get</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> key)</code>
<div class="block">
检索在此引擎状态下设置的值。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<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/ScriptEngine.html#getBindings-int-">getBindings</a></span>(int scope)</code>
<div class="block">
返回命名值的范围。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code><a href="../../javax/script/ScriptContext.html" title="interface in javax.script">ScriptContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptEngine.html#getContext--">getContext</a></span>()</code>
<div class="block">
返回默认
<code>ScriptContext</code>的的
<code>ScriptEngine</code>的BindingsReader和Writer被用于脚本执行时没有
<code>ScriptContext</code>指定。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code><a href="../../javax/script/ScriptEngineFactory.html" title="interface in javax.script">ScriptEngineFactory</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/script/ScriptEngine.html#getFactory--">getFactory</a></span>()</code>
<div class="block">
为这个
<code>ScriptEngine</code>所属的课程返回一个
<code>ScriptEngineFactory</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/ScriptEngine.html#put-java.lang.String-java.lang.Object-">put</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> key, <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> value)</code>
<div class="block">
在ScriptEngine的状态下设置一个键/值对可以创建一个Java语言绑定以便在执行脚本时使用或者以某种其他方式使用具体取决于该键是否被保留。
</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/ScriptEngine.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">
设置脚本使用的命名值的范围。
</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/ScriptEngine.html#setContext-javax.script.ScriptContext-">setContext</a></span>(<a href="../../javax/script/ScriptContext.html" title="interface in javax.script">ScriptContext</a> context)</code>
<div class="block">
设置默认
<code>ScriptContext</code>的的
<code>ScriptEngine</code>的BindingsReader和Writer被用于脚本执行时没有
<code>ScriptContext</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="ARGV">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ARGV</h4> <pre>static final <a href="../../java/lang/String.html" title="class in java.lang">String</a> ARGV</pre>
<div class="block">
用于将位置参数数组传递给脚本的命名值的保留键。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.script.ScriptEngine.ARGV">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="FILENAME">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>FILENAME</h4> <pre>static final <a href="../../java/lang/String.html" title="class in java.lang">String</a> FILENAME</pre>
<div class="block">
作为正在执行的文件的名称的命名值的保留键。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.script.ScriptEngine.FILENAME">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="ENGINE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ENGINE</h4> <pre>static final <a href="../../java/lang/String.html" title="class in java.lang">String</a> ENGINE</pre>
<div class="block">
作为
<code>ScriptEngine</code>实现的名称的命名值的保留键。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.script.ScriptEngine.ENGINE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="ENGINE_VERSION">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ENGINE_VERSION</h4> <pre>static final <a href="../../java/lang/String.html" title="class in java.lang">String</a> ENGINE_VERSION</pre>
<div class="block">
保留键指定值标识的版本
<code>ScriptEngine</code>实施。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.script.ScriptEngine.ENGINE_VERSION">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="NAME">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>NAME</h4> <pre>static final <a href="../../java/lang/String.html" title="class in java.lang">String</a> NAME</pre>
<div class="block">
<span>用于标识脚本语言的短名称的命名值的保留键。</span>
<span>该名称用于由<code>ScriptEngineManager</code>来定位<code>ScriptEngine</code>与在一个给定的名称<code>getEngineByName</code>方法。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.script.ScriptEngine.NAME">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="LANGUAGE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>LANGUAGE</h4> <pre>static final <a href="../../java/lang/String.html" title="class in java.lang">String</a> LANGUAGE</pre>
<div class="block">
作为实现支持的脚本语言的全名的命名值的保留键。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.script.ScriptEngine.LANGUAGE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="LANGUAGE_VERSION">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>LANGUAGE_VERSION</h4> <pre>static final <a href="../../java/lang/String.html" title="class in java.lang">String</a> LANGUAGE_VERSION</pre>
<div class="block">
用于标识实现支持的脚本语言版本的命名值的保留键。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.script.ScriptEngine.LANGUAGE_VERSION">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="eval-java.lang.String-javax.script.ScriptContext-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>eval</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> eval(<a href="../../java/lang/String.html" title="class in java.lang">String</a> script,
<a href="../../javax/script/ScriptContext.html" title="interface in javax.script">ScriptContext</a> context)
throws <a href="../../javax/script/ScriptException.html" title="class in javax.script">ScriptException</a></pre>
<div class="block">
<span>导致立即执行脚本其脚本是作为第一个参数传递的String。</span>
<span>脚本可能在执行之前被重新编译或重新编译。</span>
<span>在执行过程中,包括变量值和编译过程在内的引擎中留下的状态可能在以前的执行过程中可见。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>script</code> - 由脚本引擎执行的脚本。
</dd>
<dd>
<span><code>context</code> - A <code>ScriptContext</code>在不同范围<code>ScriptContext</code>公开属性集。</span>
<span>在本说明书中定义了示波器<code>ScriptContext.GLOBAL_SCOPE</code><code>ScriptContext.ENGINE_SCOPE</code>的含义。</span>
<br/>
<br/>
<span><code>ENGINE_SCOPE</code> <code>Bindings</code> <code>ScriptContext</code>包含脚本变量与此脚本执行期间要使用的应用程序对象的绑定。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
从执行脚本返回的值。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../javax/script/ScriptException.html" title="class in javax.script">ScriptException</a></code> - 脚本中是否发生错误。</span>
<span>ScriptEngines应该创建并抛出<code>ScriptException</code>包装器,以检查基础脚本实现抛出的检查异常。</span>
</dd>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果任一参数为空。
</dd>
</dl> </li>
</ul> <a name="eval-java.io.Reader-javax.script.ScriptContext-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>eval</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> eval(<a href="../../java/io/Reader.html" title="class in java.io">Reader</a> reader,
<a href="../../javax/script/ScriptContext.html" title="interface in javax.script">ScriptContext</a> context)
throws <a href="../../javax/script/ScriptException.html" title="class in javax.script">ScriptException</a></pre>
<div class="block">
<code>eval(String, ScriptContext)</code>相同,其中脚本的来源是从
<code>Reader</code>读取的。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>reader</code> - 由脚本引擎执行的脚本的源。
</dd>
<dd>
<code>context</code> -
<code>ScriptContext</code>传递给脚本引擎。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
从执行脚本返回的值。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/script/ScriptException.html" title="class in javax.script">ScriptException</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="eval-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>eval</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> eval(<a href="../../java/lang/String.html" title="class in java.lang">String</a> script)
throws <a href="../../javax/script/ScriptException.html" title="class in javax.script">ScriptException</a></pre>
<div class="block">
<span>执行指定的脚本。</span>
<span>使用默认<code>ScriptContext</code><code>ScriptEngine</code></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>script</code> - 要执行的脚本语言源。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
从执行脚本返回的值。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/script/ScriptException.html" title="class in javax.script">ScriptException</a></code> - 如果脚本中发生错误。
</dd>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果参数为null。
</dd>
</dl> </li>
</ul> <a name="eval-java.io.Reader-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>eval</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> eval(<a href="../../java/io/Reader.html" title="class in java.io">Reader</a> reader)
throws <a href="../../javax/script/ScriptException.html" title="class in javax.script">ScriptException</a></pre>
<div class="block">
<code>eval(String)</code>相同,只是脚本的来源以
<code>Reader</code>形式提供
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>reader</code> - 脚本的来源。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
脚本返回的值。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/script/ScriptException.html" title="class in javax.script">ScriptException</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="eval-java.lang.String-javax.script.Bindings-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>eval</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> eval(<a href="../../java/lang/String.html" title="class in java.lang">String</a> script,
<a href="../../javax/script/Bindings.html" title="interface in javax.script">Bindings</a> n)
throws <a href="../../javax/script/ScriptException.html" title="class in javax.script">ScriptException</a></pre>
<div class="block">
<span>执行使用该脚本<code>Bindings</code>参数为<code>ENGINE_SCOPE</code> <code>Bindings</code>的的<code>ScriptEngine</code>脚本执行期间。</span>
<span><code>Reader</code> <code>Writer</code>和非<code>ENGINE_SCOPE</code> <code>Bindings</code>默认的<code>ScriptContext</code>被使用。</span>
<span><code>ENGINE_SCOPE</code> <code>Bindings</code><code>ScriptEngine</code>没有改变,其映射不受脚本执行的影响。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>script</code> - 脚本的来源。
</dd>
<dd>
<code>n</code> -该
<code>Bindings</code>属性用于脚本执行。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
脚本返回的值。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/script/ScriptException.html" title="class in javax.script">ScriptException</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="eval-java.io.Reader-javax.script.Bindings-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>eval</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> eval(<a href="../../java/io/Reader.html" title="class in java.io">Reader</a> reader,
<a href="../../javax/script/Bindings.html" title="interface in javax.script">Bindings</a> n)
throws <a href="../../javax/script/ScriptException.html" title="class in javax.script">ScriptException</a></pre>
<div class="block">
<code>eval(String, Bindings)</code>相同,只是该脚本的来源以
<code>Reader</code>形式提供。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>reader</code> - 脚本的来源。
</dd>
<dd>
<code>n</code> -
<code>Bindings</code>的Bindings。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
脚本返回的值。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/script/ScriptException.html" title="class in javax.script">ScriptException</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="put-java.lang.String-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>put</h4> <pre>void put(<a href="../../java/lang/String.html" title="class in java.lang">String</a> key,
<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> value)</pre>
<div class="block">
<span>在ScriptEngine的状态下设置一个键/值对可以创建一个Java语言绑定以便在执行脚本时使用或者以某种其他方式使用具体取决于该键是否被保留。</span>
<span>必须具有与<code>getBindings(ScriptContext.ENGINE_SCOPE).put</code>相同的效果。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>key</code> - 要添加的命名值的名称
</dd>
<dd>
<code>value</code> - 要添加的命名值的值。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果key为null。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果键为空。
</dd>
</dl> </li>
</ul> <a name="get-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>get</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> get(<a href="../../java/lang/String.html" title="class in java.lang">String</a> key)</pre>
<div class="block">
<span>检索在此引擎状态下设置的值。</span>
<span>该值可能是其中之一是使用设置<code>setValue</code>或状态的其他值<code>ScriptEngine</code> ,这取决于实现。</span>
<span>必须具有与<code>getBindings(ScriptContext.ENGINE_SCOPE).get</code>相同的效果</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>key</code> - 要返回其值的键
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
给定键的值
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果key为空。
</dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></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">
<span>返回命名值的范围。</span>
<span>可能的范围是:</span>
<br/>
<br/>
<ul>
<li> <span><code>ScriptContext.GLOBAL_SCOPE</code> - 表示全局范围的一组命名值。</span> <span>如果这<code>ScriptEngine</code>通过创建<code>ScriptEngineManager</code> ,那么管理者将全球范围内绑定。</span> <span>如果没有全局范围与此<code>ScriptEngine</code> <code>null</code>则可能是<code>ScriptEngine</code></span> </li>
<li> <span><code>ScriptContext.ENGINE_SCOPE</code> -集表示此状态的指定值的<code>ScriptEngine</code></span> <span>这些值通常在使用相关键作为变量名称的脚本中可见。</span> </li>
<li> <span>的范围内的任何其它值在默认定义<code>ScriptContext</code>所述的<code>ScriptEngine</code></span> </li>
</ul>
<br/>
<br/>
<span><code>Bindings</code>返回的情况下必须与那些由返回<code>getBindings</code>的方法<code>ScriptContext</code>打来电话为默认相应参数<code>ScriptContext</code>所述的<code>ScriptEngine</code></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>scope</code> - <code>ScriptContext.ENGINE_SCOPE</code><code>ScriptContext.GLOBAL_SCOPE</code> <code>Bindings</code>要返回的<code>Bindings</code></span>
<span>ScriptContext的<code>ScriptContext</code>可能会定义其他范围。</span>
<span>如果<code>ScriptContext</code>默认的<code>ScriptEngine</code>定义了其他示波器,则可以将其中的任一个传递给相应的<code>Bindings</code></span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>Bindings</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>
</dl> </li>
</ul> <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>设置脚本使用的命名值的范围。</span>
<span>可能的范围是:</span>
<br/>
<br/>
<ul>
<li> <span><code>ScriptContext.ENGINE_SCOPE</code> -指定的<code>Bindings</code>替换的引擎范围<code>ScriptEngine</code></span> </li>
<li> <span><code>ScriptContext.GLOBAL_SCOPE</code> - 指定的<code>Bindings</code>必须作为<code>GLOBAL_SCOPE</code>可见。</span> </li>
<li> <span>的范围内的任何其它值在默认定义<code>ScriptContext</code>所述的<code>ScriptEngine</code></span> </li>
</ul>
<br/>
<br/>
<span>该方法必须具有作为调用相同的效果<code>setBindings</code>的方法<code>ScriptContext</code>用的相应值<code>scope</code>上的默认<code>ScriptContext</code>所述的<code>ScriptEngine</code></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>bindings</code> -该
<code>Bindings</code>指定的范围。
</dd>
<dd>
<span><code>scope</code> - 指定的范围。</span>
<span>无论是<code>ScriptContext.ENGINE_SCOPE</code> <code>ScriptContext.GLOBAL_SCOPE</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> - 如果绑定为空,范围为
<code>ScriptContext.ENGINE_SCOPE</code>
</dd>
</dl> </li>
</ul> <a name="createBindings--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createBindings</h4> <pre><a href="../../javax/script/Bindings.html" title="interface in javax.script">Bindings</a> createBindings()</pre>
<div class="block">
返回未初始化的
<code>Bindings</code>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
A
<code>Bindings</code>可以用来替换这个
<code>ScriptEngine</code>的状态。
</dd>
</dl> </li>
</ul> <a name="getContext--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getContext</h4> <pre><a href="../../javax/script/ScriptContext.html" title="interface in javax.script">ScriptContext</a> getContext()</pre>
<div class="block">
返回默认
<code>ScriptContext</code>的的
<code>ScriptEngine</code>的BindingsReader和Writer被用于脚本执行时没有
<code>ScriptContext</code>指定。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
默认
<code>ScriptContext</code>
<code>ScriptEngine</code>
</dd>
</dl> </li>
</ul> <a name="setContext-javax.script.ScriptContext-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setContext</h4> <pre>void setContext(<a href="../../javax/script/ScriptContext.html" title="interface in javax.script">ScriptContext</a> context)</pre>
<div class="block">
设置默认
<code>ScriptContext</code>的的
<code>ScriptEngine</code>的BindingsReader和Writer被用于脚本执行时没有
<code>ScriptContext</code>指定。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>context</code> - A
<code>ScriptContext</code>将替换
<code>ScriptContext</code>中的默认
<code>ScriptEngine</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果上下文为空。
</dd>
</dl> </li>
</ul> <a name="getFactory--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getFactory</h4> <pre><a href="../../javax/script/ScriptEngineFactory.html" title="interface in javax.script">ScriptEngineFactory</a> getFactory()</pre>
<div class="block">
返回
<code>ScriptEngineFactory</code>让全班这里面
<code>ScriptEngine</code>所属。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>ScriptEngineFactory</code>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>