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 Chapter 8 of Oracle8i Migration for further details.

Cartridge Service -- 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. See Appendix A, "Java Demo Script" for an example of the use of the Context Manager in a domain index case.

For additional detail on Java functionality, see the Oracle8i 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)