Getting Started with the Java API

The Java API will allow access to some of the Understand database from within your Java program. The Java API was written as part of creating the Understand Eclipse Plugin. For that reason it is more light weight it does not have the full capabilities of the other APIs.

To get the API working in your Java environment you will need to:

  1. Add Understand to the PATH (e.g. C:\Program Files\SciTools\bin\pc-win64)
  2. Add the Understand plugin jar file to the CLASSPATH (e.g. set CLASSPATH=c:\sti\bin\pc-win64\Java\com.scitools.understand.plugin_1.1.3.jar:$CLASSPATH)
  3. Import the understand classes into your file (import com.scitools.understand.*;)

Do not move any files outside of the Understand installation folder or api will not work.

Documentation on the Java API is installed with Understand in the “doc” folder and is also available on our website.

While the API Tutorials do not cover the Java API directly, they can be very useful for understand the concepts and commands.

Here is a sample file that exercises the Understand Java API