Spec-Zone .ru
спецификации, руководства, описания, API
|
public interface ScriptEngineFactory
ScriptEngineFactory
используется, чтобы описать и инстанцировать ScriptEngines
. ScriptEngine
имеет соответствующую фабрику, которая представляет метаданные, описывающие механизм class. ScriptEngineManager
использует механизм поставщика услуг, описанный в Спецификации Файла Фляги, чтобы получить экземпляры всех ScriptEngineFactories
доступный в текущем ClassLoder.Модификатор и Тип | Метод и Описание |
---|---|
Строка |
getEngineName()
Возвращает полное имя
ScriptEngine . |
Строка |
getEngineVersion()
Возвращает версию
ScriptEngine . |
List<String> |
getExtensions()
Возвращает неизменный список расширений файла, которые обычно идентифицируют сценарии, записанные на языке, поддерживаемом этим
ScriptEngine . |
Строка |
getLanguageName()
Возвращает имя сценариев langauge поддерживаемый этим
ScriptEngine . |
Строка |
getLanguageVersion()
Возвращает версию языка сценариев, поддерживаемого этим
ScriptEngine . |
Строка |
getMethodCallSyntax(String obj, String m, String... args)
Возвращает Строку, которая может использоваться, чтобы вызвать метод объекта Java использование синтаксиса поддерживаемого языка сценариев.
|
List<String> |
getMimeTypes()
Возвращает неизменный список mimetypes, связанного со сценариями, которые могут быть выполнены механизмом.
|
List<String> |
getNames()
Возвращает неизменный список кратких названий для
ScriptEngine , который может использоваться, чтобы идентифицировать ScriptEngine ScriptEngineManager . |
Строка |
getOutputStatement(String toDisplay)
Возвращает Строку, которая может использоваться в качестве оператора, чтобы вывести на экран указанную Строку, используя синтаксис поддерживаемого языка сценариев.
|
Объект |
getParameter(String key)
Возвращает значение атрибута, значение которого может быть специфичным для реализации.
|
Строка |
getProgram(String... statements)
Возвращает допустимую исполнимую проножку языка сценариев с данными операторами.
|
ScriptEngine |
getScriptEngine()
Возвращает экземпляр
ScriptEngine связанный с этим ScriptEngineFactory . |
String getEngineName()
ScriptEngine
. Например реализация, основанная на механизме Mozilla Rhino Javascript, могла бы возвратить Mozilla Rhino Механизм Javascript.String getEngineVersion()
ScriptEngine
.ScriptEngine
версия реализации.List<String> getExtensions()
ScriptEngine
. Массив используется ScriptEngineManager
реализовывать getEngineByExtension
метод.List<String> getMimeTypes()
ScriptEngineManager
class, чтобы реализовать getEngineByMimetype
метод.List<String> getNames()
ScriptEngine
, который может использоваться, чтобы идентифицировать ScriptEngine
ScriptEngineManager
. Например, реализация, основанная на механизме Mozilla Rhino Javascript, могла бы возвратить список, содержащий {"javascript", "носорог"}.String getLanguageName()
ScriptEngine
.String getLanguageVersion()
ScriptEngine
.Object getParameter(String key)
Значениями для этих ключей являются Строки, возвращенные getEngineName
, getEngineVersion
, getName
, getLanguageName
и getLanguageVersion
соответственно.
Зарезервированный ключ, THREADING
, чье значение описывает поведение механизма относительно параллельного выполнения сценариев, и обслуживание состояния также определяется. Эти значения для THREADING
ключ:
null
- Реализация механизма не ориентирована на многопотоковое исполнение, и не может использоваться, чтобы выполнить сценарии одновременно на многократных потоках. "MULTITHREADED"
- Реализация механизма внутренне ориентирована на многопотоковое исполнение, и сценарии могут выполниться одновременно, хотя эффекты выполнения сценария на одном потоке могут быть видимыми к сценариям на других потоках. "THREAD-ISOLATED"
- Реализация удовлетворяет требования "МНОГОПОТОЧНЫХ", и также, механизм поддерживает независимые значения для символов в сценариях, выполняющихся на различных потоках. "STATELESS"
- Реализация удовлетворяет требования "THREAD-ISOLATED"
. Кроме того, выполнение сценария не изменяет отображения в Bindings
который является контекстом механизма ScriptEngine
. В частности ключи Bindings
и их присваиваемые значения являются тем же самым прежде и после выполнения сценария. key
- Имя параметраnull
если никакое значение не присваивается ключу.String getMethodCallSyntax(String obj, String m, String... args)
public String getMethodCallSyntax(String obj,
String m, String... args) {
String ret = obj;
ret += "." + m + "(";
for (int i = 0; i < args.length; i++) {
ret += args[i];
if (i < args.length - 1) {
ret += ",";
}
}
ret += ")";
return ret;
}
obj
- The name representing the object whose method is to be invoked. The name is the one used to create bindings using the put
method of ScriptEngine
, the put
method of an ENGINE_SCOPE
Bindings
,or the setAttribute
method of ScriptContext
. The identifier used in scripts may be a decorated form of the specified one.m
- The name of the method to invoke.args
- names of the arguments in the method call.String getOutputStatement(String toDisplay)
public String getOutputStatement(String toDisplay) {
return "print(" + toDisplay + ")";
}
toDisplay
- The String to be displayed by the returned statement.String getProgram(String... statements)
public String getProgram(String... statements) {
$retval = "<?\n";
int len = statements.length;
for (int i = 0; i < len; i++) {
$retval += statements[i] + ";\n";
}
$retval += "?>";
}
statements
- The statements to be executed. May be return values of calls to the getMethodCallSyntax
and getOutputStatement
methods.ScriptEngine getScriptEngine()
ScriptEngine
associated with this ScriptEngineFactory
. A new ScriptEngine is generally returned, but implementations may pool, share or reuse engines.ScriptEngine
instance.
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b92