Skip to main content

Introduction to XEP

XEP is a lightweight Java SDK that provides high-performance Java technology for persisting simple to moderately complex object hierarchies. XEP projects the data in Java objects as persistent events (database objects that store a persistent copy of the data fields) in an InterSystems IRIS® database. XEP is optimized for applications that must acquire and persist data at the highest possible speed.

InterSystems IRIS provides Java SDKs for easy relational and object database access. This book discusses XEP object access. See Using Java with InterSystems Software for JDBC relational access.

Requirements and Configuration

This section specifies requirements and provides instructions for configuring your environment to use XEP.

  • A 64–bit Java JDK supported by this release of InterSystems IRIS (see “Supported Java Technologies” in the InterSystems Supported Platforms document for this release).

  • InterSystems IRIS.

Computers that run your Java client applications do not require InterSystems IRIS, but they must have a connection to the InterSystems IRIS Server and must be running a supported version of the Java JDK.

The main InterSystems Java class packages are contained in the following files (where <version> is a three-part package version number such as 3.3.0):

  • intersystems-jdbc-<version>.jar — the core JDBC jar file. All of the other files in this list are dependent on this file. In addition to the core JDBC API, this file also includes the classes that implement the Native SDK (see Using the Native SDK for Java).

  • intersystems-xep-<version>.jar — required for XEP Java persistence applications (see Persisting Java Objects with InterSystems XEP). Depends on the JDBC jar.

You can download the latest versions of the JDBC and XEP class packages from the InterSystems IRIS Driver PackagesOpens in a new tab page.

In local installations, there are also versions of these files in subdirectories of <install-dir>/dev/java/lib (for example, <install-dir>/dev/java/lib/JDK18 contains the files for Java 1.8). You can determine the location of <install-dir> (the InterSystems IRIS root directory) for an instance of InterSystems IRIS by opening the InterSystems terminal in that instance and issuing the following ObjectScript command:

   write $system.Util.InstallDirectory()
Note:
Additional Configuration for Windows

The default stack size of the Java Virtual Machine on Windows is too small for running XEP applications (running them with the default stack size causes Java to report EXCEPTION_STACK_OVERFLOW). To optimize performance, heap size should also be increased. To temporarily modify the stack size and heap size when running an XEP application, add the following command line arguments:

   -Xss1024k
   -Xms2500m -Xmx2500m

Local Installation

  • When installing InterSystems IRIS, select the Development environment:

    • In Windows, select the Setup Type: Development option during installation.

    • In UNIX® and related operating systems, select the 1) Development - Install InterSystems IRIS server and all language bindings option during installation (see “Standard InterSystems IRIS Installation Procedure” in the UNIX® and Linux section of the Installation Guide).

  • If InterSystems IRIS has been installed with security level 2, open the Management Portal and go to System Administration > Security > Services, select %Service_CallIn, and make sure the Service Enabled box is checked.

    If you installed InterSystems IRIS with security level 1 (minimal) it should already be checked.

FeedbackOpens in a new tab