Интерфейс ScriptEngineFactory

Методы

getEngineName

String getEngineName()

Возвращает полное имя ScriptEngine . Например, реализация, основанная на движке Javascript Mozilla Rhino, может вернуть Rhino Mozilla Javascript Engine.

Возвращает:

Имя реализации движка.

getEngineVersion

String getEngineVersion()

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

Возвращает:

Версию реализации ScriptEngine.

getExtensions

List<String> getExtensions()

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

Возвращает:

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

getMimeTypes

List<String> getMimeTypes()

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

Возвращает:

Список MIME-типов.

getNames

List<String> getNames()

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

Возвращает:

неизменяемый список коротких имен

getLanguageName

String getLanguageName()

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

Возвращает:

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

getLanguageVersion

String getLanguageVersion()

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

Возвращает:

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

getParameter

Object getParameter(String key)

Параметры:

key — имя параметра

Возвращает:

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

getMethodCallSyntax

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 — имя, представляющее объект, метод которого должен быть вызван. Имя используется для создания привязок с помощью метода put ScriptEngine, метода put ENGINE_SCOPE Bindings, или метода setAttribute ScriptContext . Идентификатор, используемый в скриптах, может быть декоративной формой указанного.

m — имя вызываемого метода.

args — имена аргументов в вызове метода.

Возвращает:

Строка, используемая для вызова метода в синтаксисе языка сценариев.

getOutputStatement

String getOutputStatement(String toDisplay)

Возвращает строку, которая может использоваться как оператор для отображения указанной строки с помощью синтаксиса поддерживаемого языка сценариев. Например, реализация для движка Perl может быть;

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

Параметры:

toDisplay — строка, которая должна отображаться возвращаемым оператором.

Возвращает:

Строка, используемая для отображения строки в синтаксисе языка сценариев.

getProgram

String getProgram(String... statements)

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

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

Параметры:

statements — операторы, которые должны быть выполнены. Может быть результатом вызова методов getMethodCallSyntax и getOutputStatement.

Возвращает:

Программа

getScriptEngine

ScriptEngine getScriptEngine()

Возвращает экземпляр ScriptEngine , связанный с этим ScriptEngineFactory. Обычно возвращается новый ScriptEngine, но реализации могут пулить, разделять или повторно использовать движки.

Возвращает:

Новый экземпляр ScriptEngine.