Class CompiledScript

java.lang.Object
javax.script.CompiledScript
public abstract classCompiledScriptextendsObject
Extended by classes that store results of compilations. State might be stored in the form of Java classes, Java class files or scripting language opcodes. The script may be executed repeatedly without reparsing.

EachCompiledScript is associated with aScriptEngine -- A call to aneval method of theCompiledScript causes the execution of the script by theScriptEngine. Changes in the state of theScriptEngine caused by execution of theCompiledScript may visible during subsequent executions of scripts by the engine.
Since:
1.6

  • Constructor Details

    • CompiledScript

      public CompiledScript()
      Constructor for subclasses to call.

  • Method Details

    • eval

      public abstract Object eval(ScriptContext context) throwsScriptException
      Executes the program stored in thisCompiledScript object.
      Parameters:
      context - AScriptContext that is used in the same way as theScriptContext passed to theeval methods ofScriptEngine.
      Returns:
      The value returned by the script execution, if any. Should returnnull if no value is returned by the script execution.
      Throws:
      ScriptException - if an error occurs.
      NullPointerException - if context is null.

    • eval

      public Object eval(Bindings bindings) throwsScriptException
      Executes the program stored in theCompiledScript object using the suppliedBindings of attributes as theENGINE_SCOPE of the associatedScriptEngine during script execution. If bindings is null, then the effect of calling this method is same as that of eval(getEngine().getContext()).

      . TheGLOBAL_SCOPEBindings,Reader andWriter associated with the defaultScriptContext of the associatedScriptEngine are used.

      Parameters:
      bindings - The bindings of attributes used for theENGINE_SCOPE.
      Returns:
      The return value from the script execution
      Throws:
      ScriptException - if an error occurs.

    • eval

      public Object eval() throwsScriptException
      Executes the program stored in theCompiledScript object. The defaultScriptContext of the associatedScriptEngine is used. The effect of calling this method is same as that of eval(getEngine().getContext()).
      Returns:
      The return value from the script execution
      Throws:
      ScriptException - if an error occurs.

    • getEngine

      public abstract ScriptEngine getEngine()
      Returns theScriptEngine whosecompile method created thisCompiledScript. TheCompiledScript will execute in this engine.
      Returns:
      TheScriptEngine that created thisCompiledScript