javax.script

Интерфейсный ScriptEngineFactory

public interface ScriptEngineFactory

ScriptEngineFactory используется, чтобы описать и инстанцировать ScriptEngines.

Каждая реализация класса ScriptEngine имеет соответствующую фабрику, которая представляет метаданные, описывающие класс механизма.

ScriptEngineManager использует механизм поставщика услуг, описанный в Спецификации Файла Фляги, чтобы получить экземпляры всех ScriptEngineFactories доступный в текущем ClassLoder.

С тех пор:

1.6

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Строка	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.

Деталь метода

getEngineName

String getEngineName()

Возвращает полное имя ScriptEngine. Например реализация, основанная на механизме Mozilla Rhino Javascript, могла бы возвратить Mozilla Rhino Механизм Javascript.

Возвраты:

Имя реализации механизма.

getEngineVersion

String getEngineVersion()

Возвращает версию ScriptEngine.

Возвраты:

ScriptEngine версия реализации.

getExtensions

List<String> getExtensions()

Возвращает неизменный список расширений файла, которые обычно идентифицируют сценарии, записанные на языке, поддерживаемом этим ScriptEngine. Массив используется ScriptEngineManager реализовывать getEngineByExtension метод.

Возвраты:

Список расширений.

getMimeTypes

List<String> getMimeTypes()

Возвращает неизменный список mimetypes, связанного со сценариями, которые могут быть выполнены механизмом. Список используется ScriptEngineManager класс реализации getEngineByMimetype метод.

Возвраты:

Список типов пантомимы.

getNames

List<String> getNames()

Возвращает неизменный список кратких названий для ScriptEngine, который может использоваться, чтобы идентифицировать ScriptEngine ScriptEngineManager. Например, реализация, основанная на механизме Mozilla Rhino Javascript, могла бы возвратить список, содержащий {"javascript", "носорог"}.

getLanguageName

String getLanguageName()

Возвращает имя сценариев langauge поддерживаемый этим ScriptEngine.

Возвраты:

Имя поддерживаемого языка.

getLanguageVersion

String getLanguageVersion()

Возвращает версию языка сценариев, поддерживаемого этим ScriptEngine.

Возвраты:

Версия поддерживаемого языка.

getParameter

Object getParameter(String key)

Возвращает значение атрибута, значение которого может быть специфичным для реализации. Ключи, для которых значение определяется во всех реализациях:

• ScriptEngine. МЕХАНИЗМ
• ScriptEngine. ENGINE_VERSION
• ScriptEngine. ИМЯ
• ScriptEngine. ЯЗЫК
• ScriptEngine. LANGUAGE_VERSION

Значениями для этих ключей являются Строки, возвращенные getEngineName, getEngineVersion, getName, getLanguageName и getLanguageVersion соответственно.

Зарезервированный ключ, THREADING, чье значение описывает поведение механизма относительно параллельного выполнения сценариев, и обслуживание состояния также определяется. Эти значения для THREADING ключ:

• null - Реализация механизма не ориентирована на многопотоковое исполнение, и не может использоваться, чтобы выполнить сценарии одновременно на многократных потоках.
• "MULTITHREADED" - Реализация механизма внутренне ориентирована на многопотоковое исполнение, и сценарии могут выполниться одновременно, хотя эффекты выполнения сценария на одном потоке могут быть видимыми к сценариям на других потоках.
• "THREAD-ISOLATED" - Реализация удовлетворяет требования "МНОГОПОТОЧНЫХ", и также, механизм поддерживает независимые значения для символов в сценариях, выполняющихся на различных потоках.
• "STATELESS" - Реализация удовлетворяет требования
• "THREAD-ISOLATED". Кроме того, выполнение сценария не изменяет отображения в Bindings который является контекстом механизма ScriptEngine. В частности ключи Bindings и их присваиваемые значения являются тем же самым прежде и после выполнения сценария.

Реализации могут определить специфичные для реализации ключи.

Параметры:

key - Имя параметра

Возвраты:

Значение для данного параметра. Возвраты null если никакое значение не присваивается ключу.

getMethodCallSyntax

String getMethodCallSyntax(String obj,
                         String m,
                         String... args)

Возвращает Строку, которая может использоваться, чтобы вызвать метод объекта Java использование синтаксиса поддерживаемого языка сценариев. Например, implementaton для механизма Javascript мог бы быть;

 
 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;
 }

Parameters:

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.

Returns:

The String used to invoke the method in the syntax of the scripting language.

getOutputStatement

String getOutputStatement(String toDisplay)

Returns a String that can be used as a statement to display the specified String using the syntax of the supported scripting language. For instance, the implementaton for a Perl engine might be;

 public String getOutputStatement(String toDisplay) {
      return "print(" + toDisplay + ")";
 }
 

Parameters:

toDisplay - The String to be displayed by the returned statement.

Returns:

The string used to display the String in the syntax of the scripting language.

getProgram

String getProgram(String... statements)

Returns A valid scripting language executable progam with given statements. For instance an implementation for a PHP engine might be:

 public String getProgram(String... statements) {
      $retval = "<?\n";
      int len = statements.length;
      for (int i = 0; i < len; i++) {
          $retval += statements[i] + ";\n";
      }
      $retval += "?>";

 }
 

Parameters:

statements - The statements to be executed. May be return values of calls to the getMethodCallSyntax and getOutputStatement methods.

Returns:

The Program

getScriptEngine

ScriptEngine getScriptEngine()

Returns an instance of the ScriptEngine associated with this ScriptEngineFactory. A new ScriptEngine is generally returned, but implementations may pool, share or reuse engines.

Returns:

A new ScriptEngine instance.