script-utils-java/com.pambrose.common.script/JavaScript

JavaScript

class JavaScript : AbstractScript, Closeable

A script engine wrapper for dynamically compiling and evaluating Java source code.

Supports adding named variables with type parameters, import declarations, and configurable isolation levels. Note that Java cannot have a null global context.

Common literal JVM-termination calls (System.exit, Runtime.getRuntime().exit/halt) are rejected on a best-effort basis via ScriptGuards. This is a convenience against accidental termination, not a security sandbox (see ScriptGuards) — run untrusted scripts in an isolated process or JVM.

Constructors

JavaScript

constructor()

Types

Companion

object Companion

Properties

engine

val engine: ScriptEngine

importDecls

val importDecls: String

Generates Java import statements for all registered import classes.

varDecls

val varDecls: String

Generates Java-style public field declarations for all registered variables.

Functions

add

open fun add(name: String, value: Any, vararg types: KType)

assignIsolation

fun assignIsolation(isolation: Isolation)

Sets the isolation level for the underlying JavaScriptEngine.

open override fun close()

eval

@Synchronized

fun eval(expr: String, action: String = "", verbose: Boolean = false): Any?

Evaluates a Java expr (optionally preceded by an action statement block) inside a generated Main.getValue() method, prepending any registered imports and variable declarations.

evalScript

@Synchronized

fun evalScript(script: String, verbose: Boolean = false): Any?

Evaluates a raw Java script string, prepending any registered import declarations.

import

@Synchronized

fun <T> import(clazz: Class<T>)

Registers a Java class to be imported in generated scripts.

params