Package javax.script
See: Description
-
Interface Summary Interface Description Bindings A mapping of key/value pairs, all of whose keys areStrings.Compilable The optional interface implemented by ScriptEngines whose methods compile scripts to a form that can be executed repeatedly without recompilation.Invocable The optional interface implemented by ScriptEngines whose methods allow the invocation of procedures in scripts that have previously been executed.ScriptContext The interface whose implementing classes are used to connect Script Engines with objects, such as scoped Bindings, in hosting applications.ScriptEngine ScriptEngineis the fundamental interface whose methods must be fully functional in every implementation of this specification.ScriptEngineFactory ScriptEngineFactoryis used to describe and instantiateScriptEngines. -
Class Summary Class Description AbstractScriptEngine Provides a standard implementation for several of the variants of theevalmethod.CompiledScript Extended by classes that store results of compilations.ScriptEngineManager TheScriptEngineManagerimplements a discovery and instantiation mechanism forScriptEngineclasses and also maintains a collection of key/value pairs storing state shared by all engines created by the Manager.SimpleBindings A simple implementation of Bindings backed by aHashMapor some other specifiedMap.SimpleScriptContext Simple implementation of ScriptContext. -
Exception Summary Exception Description ScriptException The genericExceptionclass for the Scripting APIs.
Package javax.script Description
The scripting API consists of interfaces and classes that define Java TM Scripting Engines and provides a framework for their use in Java applications. This API is intended for use by application programmers who wish to execute programs written in scripting languages in their Java applications. The scripting language programs are usually provided by the end-users of the applications.
The main areas of functionality of javax.script
package include
Script execution: Scripts are streams of characters used as sources for programs executed by script engines. Script execution uses
evalmethods ofScriptEngineand methods of theInvocableinterface.Binding: This facility allows Java objects to be exposed to script programs as named variables.
BindingsandScriptContextclasses are used for this purpose.Compilation: This functionality allows the intermediate code generated by the front-end of a script engine to be stored and executed repeatedly. This benefits applications that execute the same script multiple times. These applications can gain efficiency since the engines' front-ends only need to execute once per script rather than once per script execution. Note that this functionality is optional and script engines may choose not to implement it. Callers need to check for availability of the
Compilableinterface using an instanceof check.Invocation: This functionality allows the reuse of intermediate code generated by a script engine's front-end. Whereas Compilation allows entire scripts represented by intermediate code to be re-executed, Invocation functionality allows individual procedures/methods in the scripts to be re-executed. As in the case with compilation, not all script engines are required to provide this facility. Caller has to check for
Invocableavailability.Script engine discovery and Metadata: Applications written to the Scripting API might have specific requirements on script engines. Some may require a specific scripting language and/or version while others may require a specific implementation engine and/or version. Script engines are packaged in a specified way so that engines can be discovered at runtime and queried for attributes. The Engine discovery mechanism is based on the Service discovery mechanism described in the Jar File Specification. Script engine implementing classes are packaged in jar files that include a text resource named META-INF/services/javax.script.ScriptEngineFactory. This resource must include a line for each
ScriptEngineFactorythat is packaged in the jar file.ScriptEngineManagerincludesgetEngineFactoriesmethod to get allScriptEngineFactoryinstances discovered using this mechanism.ScriptEngineFactoryhas methods to query attributes about script engine.
- Since:
- 1.6
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/script/package-summary.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.
