15
Reference: Cartridge Services Using Java

This reference chapter describes a Java language cartridge service. For more complete details on Java functionality, refer to the Oracle9i Supplied Java Packages Reference, and the Oracle9i Java Stored Procedures Developer's Guide.

• File Installation
• Cartridge Services--Maintaining Context

File Installation

The ODCI.jar and CartridgeServices.jar files must be installed into the SYS schema in order to use the Java classes described in this chapter.

If you installed the Java option, then you must install the ODCI.jar and CartridgeServices.jar files. You do not need to perform this task if you did not install the Java option.

To install ODCI.jar and CartridgeServices.jar files, run the following commands from the command line:

loadjava -user sys/PASSWORD -resolve -synonym -grant public 
-verbose ORACLE_HOME/vobs/jlib/CartridgeServices.jar

loadjava -user sys/PASSWORD -resolve -synonym -grant public
-verbose ORACLE_HOME/vobs/jlib/ODCI.jar

Substitute the SYS password for PASSWORD, and substitute the Oracle home directory for ORACLE_HOME. These commands install the classes and create the synonyms in the SYS schema. See the chapter on what to do after migrating or updating the database, in Oracle9i Database Migration, for further details on installing the jar files.

---

Cartridge Services--Maintaining Context

The Java cartridge service is used for maintaining context. It is similar to the OCI context management service. This class should be used when switching context between the server and the cartridge code.

For additional detail on Java functionality, see the Oracle9i Java Stored Procedures Developer's Guide.

ContextManager

ContextManager is a Constructor in class Oracle that extends Object.

Class Interface

public static Hashtable ctx

extends Object

Variable

ctx

 public static Hashtable ctx

Constructors

ContextManager

 public ContextManager()

Methods

The following methods are available:

setContext (static method in class oracle)
getContext (static method in class oracle)
clearContext (static method in class oracle)

---

CountException()

CountException is a Constructor for class Oracle that extends Exception.

Class oracle.CartridgeServices.CountException 

---

CountException(String)

CountException is a Constructor for class Oracle that extends Exception.

public CountException(String s)

---

InvalidKeyException()

InvalidKeyException() is a Constructor for class Oracle that extends Exception.

public InvalidKeyException(String s)

---

InvalidKeyException(String)

InvalidKeyException(String) is a Constructor for class Oracle that extends 
Exception.

public InvalidKeyException(String s)