RunMat
  • Pricing
RunMat
GitHub
GitHub
Sign inTry in browser
DesktopRuntimePhysicsCADAdministrationAgent

Get RunMat updates

New releases, guides and examples.

Product+
  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download
Math+
  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting
Physics+
  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA
Industries+
  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance
Learn+
  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students
Compare+
  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons
Company+
  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms

Product

  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download

Math

  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting

Physics

  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA

Industries

  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance

Learn

  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students

Compare

  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons

Company

  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms
GitHubXLinkedIn

© Dystr, Inc. · RunMat v0.7.1, Nov 17, 2026

RunMat® is a registered trademark of Dystr, Inc. MATLAB® is a registered trademark of The MathWorks, Inc. RunMat is not affiliated with, endorsed by, or sponsored by The MathWorks, Inc.

/
    • Python
    • C, C++ & MEX
    • Java
    • Native Libraries
    • TypeScript/JavaScript & WASM
Docs>Runtime>Interoperability

Java Interoperability

RunMat can call Java classes from MATLAB-syntax source on native hosts. Java objects retain their JVM identity and remain owned by the RunMat session that created them.

Configure Java

RunMat discovers Java from [runtime.foreign.java].home, JAVA_HOME, and supported platform locations, in that order. Version bounds and JVM options are checked before the process JVM starts:

[runtime.foreign.java]
minimum_version = 17
maximum_version = 21
classpath = ["lib/analysis.jar"]
options = ["-Xmx1g"]

The JVM starts on the first operation that needs it. Its installation and startup options cannot change afterward. jenv reports the selected installation and load state, while usejava("jvm") reports whether Java is available.

Construct objects and call methods

Use javaObject and javaMethod with the same class and method spelling used by MATLAB code:

builder = javaObject("java.lang.StringBuilder");
javaMethod("append", builder, "RunMat");
text = javaMethod("toString", builder);

largest = javaMethod("max", "java.lang.Math", 4, 9);

Fully qualified dotted calls are also resolved at the Java boundary after RunMat source functions and packages:

value = java.lang.Integer.parseInt("42");

RunMat resolves constructors and overloads from Java reflection. Exact matches take precedence over widening conversions, assignable interfaces and base classes are supported, and unresolved ambiguities return an error instead of depending on reflection order.

Values and objects

Boolean, numeric, character, string, and null scalars have reviewed Java mappings. Numeric vectors use matching primitive arrays where Java has the same signed type. Unsigned vectors widen to a signed primitive that can retain every value; uint64 values use java.math.BigInteger when necessary. No fixed-width integer is routed through double solely to cross the Java boundary.

Java primitive arrays return typed RunMat row vectors. Java string arrays return RunMat string arrays, while reference arrays and collections preserve contained Java objects through session-owned foreign references. Multidimensional arrays created with javaArray remain Java objects so mutation and identity are not lost.

Java exceptions become RunMat errors with the Java class, message, cause chain, and Java stack frames.

Classpaths

The configured classpath is the stable project layer. Use javaaddpath, javarmpath, and javaclasspath for the current session's dynamic layer:

javaaddpath("lib/plugin.jar");
dynamicEntries = javaclasspath("-dynamic");

Classpath changes replace the session class loader without changing the process JVM's bootstrap path. Existing objects continue to use the loader that defined their classes. The session loader is also installed as the calling thread's context loader so libraries that use ServiceLoader, JDBC drivers, and similar discovery mechanisms can find project and dynamic artifacts.

For a JAR that must travel with a package, standalone executable, or remote job, declare it in runmat.toml instead of relying only on a machine-local classpath:

[java-artifacts.analysis]
path = "lib/analysis.jar"

RunMat includes declared Java artifacts in the frozen package revision, verifies their content digests again before compilation or submission, and records their exact identities in the program's interoperability manifest. Artifact names must be unique across the resolved package graph and determine classpath order, which keeps class selection consistent in local, standalone, and remote execution. Standalone executables embed the JAR bytes; remote workers receive them through the same verified artifact bundle used by other foreign runtimes. A browser or worker without the jvm host capability rejects the package during resolution.

Callbacks and listeners

Pass a RunMat function handle where a Java method expects a functional interface or listener:

operator = @(x) x + 2;
stream = javaMethod("iterate", "java.util.stream.IntStream", int32(1), operator);

Synchronous callbacks re-enter the originating RunMat session. The function retains its code and captured values, while cancellation and the caller workspace follow the active Java operation. Java event objects remain Java objects and can be passed back to later Java calls. Reusing the same function handle for listener removal reuses the same Java proxy identity.

RunMat session values are thread-affine. A callback initiated on an unrelated Java worker thread returns an affinity error rather than accessing the session from that thread. Libraries that schedule callbacks on their own executors must marshal them to the RunMat host's supported callback thread.

Event Dispatch Thread

javaObjectEDT and javaMethodEDT synchronously run their Java constructor or method on the AWT Event Dispatch Thread:

label = javaObjectEDT("javax.swing.JLabel", "Ready");
javaMethodEDT("setText", label, "Running");

These functions require a Desktop host that advertises Java UI support. CLI, server, and browser sessions return RunMat:Java:EdtUnavailable instead of starting a Java UI thread implicitly. Calls made from the EDT execute directly; other Desktop calls use synchronous event-thread dispatch.

Browser boundary

Browser and WebAssembly sessions do not embed a JVM. Java builtins remain present for source compatibility and return the stable RunMat:Foreign:UnsupportedOnWasm error when invoked. Projects that require Java artifacts must run on a native host with the matching capability.

On this page
  • Configure Java
  • Construct objects and call methods
  • Values and objects
  • Classpaths
  • Callbacks and listeners
  • Event Dispatch Thread
  • Browser boundary