Caché Java Binding and JDBC QuickStart Tutorial
Preface
[Home]  
InterSystems: The power behind what matters   
Class Reference   
Search:    

Important:
Jalapeño and the Caché Java Binding are Deprecated
Java Persistence Architecture (JPA) is the recommended persistence technology for complex object hierarchies in Java projects. Caché and Ensemble currently support JPA 1.0 and 2.0 via the Hibernate implementations of the JPA specifications. See Using the Caché Hibernate Dialect in Using Caché with JDBC.
Extreme Event Persistence (XEP) is the recommended persistence technology for high-performance simple to medium complexity object hierarchies in Java projects. See Using eXTreme Event Persistence in Using Java with Caché eXTreme.
Welcome to the Caché Java Binding and JDBC QuickStart Tutorial! This tutorial provides a quick, hands-on introduction to using the fast, efficient, and flexible Caché database with your Java applications.

Caché provides you with several different options for connecting your Java applications to Caché:
  1. The Java Binding Mechanism: Connects your application's objects directly to object representations of your data (Caché Objects). Removes the need for SQL and cumbersome object-relational mappings.
  2. The Caché JDBC Driver: Provides a standard relational interface to your Caché data. Use the driver together with SQL and the java.sql API.
  3. Caché Jalapeño: A lightweight tool for generating Caché database schemas based on your existing Java classes and then managing the persistence of your Java objects to Caché without any mapping or middleware.
  4. Caché eXtreme: A set of APIs that allow Java applications to communicate with Caché using an in-memory connection rather than TCP/IP.
The first two options are appropriate for situations in which you have existing Caché database schemas and perhaps data and you wish to connect them to Java applications. The third option is most appropriate for situations in which you have an existing Java application, but no Caché database schema or data. The fourth option is appropriate for high performance XTP (Extreme Transaction Processing) applications. This tutorial covers the first two of these options. The Jalapeño Tutorial covers the third option. See Using Java with Caché eXtreme for information on the fourth option.
The tutorial is divided into two independent parts, one part for each mechanism. Since the parts are independent, they can be completed in any order.
Note:
Click here for general Java-related system requirements for using Caché with Java applications.
The tutorial examples and exercises involve a Caché application, the Contact Management application as well as several Java source files. Click here for instructions for installing the Contact Management application, as well as descriptions of the Java files.
Read the Caché QuickStart tutorial for a fast-paced introduction to Caché and rapid application development using Caché. Read Using Caché Objects for more information on Caché Objects.
The Caché installation includes several code samples that demonstrate the Java Binding Mechanism and the Caché JDBC driver. The source files and class files containing this code can be found in <cachesys>\Dev\java\samples. In a standard Windows installation <cachesys> is in C:\InterSystems\Cache. In standard UNIX® or Linux installations, <cachesys> is /usr/cachesys.