Java Interface
JLINK OVERVIEW

J/Link User Guide

Introduction to J/LinkIntroduction to J/Link

J/Link and MathLink

Calling Java from MathematicaCalling Java from Mathematica

J/Link BasicsJ/Link Basics

Preamble

Loading the J/Link Package

Launching the Java RuntimeLaunching the Java Runtime

InstallJava
Controlling the Command Used to Launch Java
Overriding the Class Path

Loading ClassesLoading Classes

LoadJavaClass
When to Call LoadJavaClass
Contexts and Visibility of Static Members
Inner Classes

Conversion of Types between Java and Mathematica

Creating Objects

Calling Methods and Accessing FieldsCalling Methods and Accessing Fields

Syntax
Underscores in Java Names

Getting Information about Classes and Objects

Quitting or Restarting Java

Version Information

Advanced Topics in J/LinkAdvanced Topics in J/Link

Controlling the Class Path: How J/Link Finds ClassesControlling the Class Path: How J/Link Finds Classes

The Java Class Path
Overriding the Startup Class Path
Dynamically Modifying the Class Path
Examining the Class Path
Using J/Link's Class Loader Directly

Performance IssuesPerformance Issues

Overhead of Calls to Java
Speeding Up Sending Large Arrays
An Optimization Example

Reference Counts and Memory ManagementReference Counts and Memory Management

Object References in Mathematica
ReleaseJavaObject
JavaBlock
PeekObjects and PeekClasses

ExceptionsExceptions

How Exceptions Are Handled
The JavaThrow Function

Returning Objects "by Value" and "by Reference"Returning Objects "by Value" and "by Reference"

References and Values
ReturnAsJavaObject
JavaObjectToExpression

MakeJavaObject and MakeJavaExprMakeJavaObject and MakeJavaExpr

Preamble
MakeJavaObject
MakeJavaExpr

Creating Windows and Other User Interface ElementsCreating Windows and Other User Interface Elements

Preamble
Interactive and Non-Interactive Interfaces
Modal versus Modeless Operation
Handling Events with Mathematica Code: The "MathListener" Classes
Bringing Java Windows to the Foreground
Modal Windows
MathFrame and MathJFrame
Modeless Windows: Sharing the Kernel with Java
Sharing the Front End
Summary of Modal and Modeless Operation
"Manual" Interfaces: The ServiceJava Function
Using a GUI Builder

Drawing and Displaying Mathematica Images in Java WindowsDrawing and Displaying Mathematica Images in Java Windows

The MathCanvas and MathGraphicsJPanel Classes
Showing Mathematica Graphics and Typeset Expressions
Drawing Using Java's Graphics Functions
Bitmaps

The Java Console Window

Using JavaBeans

Hosting Applets

Periodical Tasks

Some Special Number ClassesSome Special Number Classes

Preamble
The "Wrapper" Classes: Integer, Float, Boolean, and Others
Complex Numbers
BigInteger and BigDecimal

Ragged Arrays

Implementing a Java Interface with Mathematica Code

Writing Your Own Installable Java ClassesWriting Your Own Installable Java Classes

Preamble
Installable Functions—The Old Way
Installable Functions in Java
Setting Up Definitions in Mathematica When Your Class Is Loaded
Manually Returning a Result to Mathematica
Requesting Evaluations by Mathematica
Throwing Exceptions
Making a Method Interruptible
Writing Your Own Event Handler Code
Debugging Your Java Classes

Deploying Applications That Use J/LinkDeploying Applications That Use J/Link

Coding Tips

Example ProgramsExample Programs

Introduction

A Beep Function

Formatting Dates

A Progress Bar

A Simple Modal Input Dialog

A File Chooser Dialog Box

Sharing the Front End: Palette-Type Buttons

Real-Time Algebra: A Mini-Application

GraphicsDlg: Graphics and Typeset Output in a Window

BouncingBalls: Drawing in a Window

Spirograph

A Piano Keyboard

Writing Java Programs That Use MathematicaWriting Java Programs That Use Mathematica

Introduction

What Is MathLink?

Overview of the Main J/Link Interfaces and ClassesOverview of the Main J/Link Interfaces and Classes

Preamble

MathLink and KernelLink

MathLinkFactory

MathLinkException

Expr

PacketListener

High-Level User Interface Classes

Sample Program

Creating Links with MathLinkFactoryCreating Links with MathLinkFactory

Using Listen and Connect Modes

Using a Remote Kernel

The MathLink InterfaceThe MathLink Interface

Managing Links

Packet Functions

Error Handling

Link State

Putting

Getting

Messages

Marks

Complex Class

Yield and Message Handlers

Constants

The KernelLink InterfaceThe KernelLink Interface

Evaluate

Waiting for the Result

The "evaluateTo" Methods

Sending Java Object References

Interrupting, Aborting, and Abandoning Evaluations

Support for PacketListeners

The handlePacket() Method (Advanced Users Only)

Methods Valid Only for "StdLinks"

Sending Computations and Reading ResultsSending Computations and Reading Results

MathLink Packets

The MathLink "Packet Loop"

Sending an Evaluation

Reading the Result

The "evaluateTo" Methods

Using the PacketListener Interface

The PacketPrinter Class for Debugging

Using EnterTextPacket

Handling MathLinkExceptions

Graphics and Typeset OutputGraphics and Typeset Output

Preamble

MathCanvas and MathGraphicsJPanel

A Sample Program That Displays Graphics and Typeset Results

evaluateToImage() and evaluateToTypeset()

Aborting and Interrupting Computations

Using Marks

Using Loopback Links

Using Expr ObjectsUsing Expr Objects

Motivation for the Expr Class

Methods in the MathLink Interface for Reading and Writing Exprs

Exprs as Replacements for Loopback Links

Exprs as a Means to Get String Representations of Expressions

Exprs as Arguments to KernelLink Methods

Examining and Manipulating Exprs

Disposing of Exprs

Threads, Blocking, and Yielding

Sending Object References to Mathematica

Some Special User Interface ClassesSome Special User Interface Classes

Introduction

ConsoleWindow

MathSessionPane

BracketMatcher and SyntaxTokenizer

InterruptDialog

Writing Applets

Send Feedback
Mathematica 9 is now available!

400+ new features, including the new Wolfram Predictive Interface, social network analysis, enterprise CDF deployment, and more »

Try Now
Buy/Upgrade
New to Mathematica? Find your learning path »
Have a question? Ask support »