(rontolisp) docs
← Functions

java Package Functions

The java package drives arbitrary Java APIs. It is JVM-only — it works on the interpreter (java -jar rontolisp.jar) and in JVM-compiled classes (a call resolved at compile time becomes a direct call, a java:reify, java:proxy or java:subclass a class generated for it, and the others go through a reflection bridge the compiler writes beside the generated .class), but not on the WASM backend, and the GraalVM native binary carries no reflection metadata to interpret it — and not part of Common Lisp; reference its functions with the java: qualifier. Each name below links to its own page; the Java interop guide covers marshalling, overload resolution and limitations.

FunctionExampleResult
java:new(java:new "java.lang.StringBuilder" "ab")a host object (#<java ...>)
java:call(java:call obj "size")the marshalled instance-method result
java:static(java:static "java.lang.Math" "max" 3 7)the marshalled static-method result
java:field(java:field "java.lang.Integer" "MAX_VALUE")the marshalled field value
java:proxy(java:proxy "java.lang.Runnable" (lambda (m) ...))an interface instance backed by the callable
java:subclass(java:subclass "java.io.File" '() '("lastModified") "x" (lambda (this m) ...))a class instance backed by the callable
java:reify(java:reify "java.lang.Runnable" "run" (lambda () ...))an interface instance with one function per method
java:handle(java:handle 'apple "apple")a host object Java sees as apple, answered back as APPLE
java:view(java:view v v :list)a read-only java.util.List of v's elements, answered back as v
java:java-exception-cause(java:java-exception-cause e)the exception a java:java-exception carries

A member that throws signals the condition type java:java-exception, a simple-error carrying the exception (the guide's Errors and non-local exits). Two more symbols serve resolution before a call runs: the type specifier (java:object "fqcn"), for the and declare, and the variable java:*warn-on-reflection*, which reports the calls left to run time (the guide's Resolving calls before they run).