Home    |    Concepts   |   API   |   Samples
API
Java API


The ArcSDE Java API provides an open, high level Programmer's Interface to process and analyze spatial information. The Java API mirrors functionality provided by the ArcSDE C API.

The Java API contains three packages:

  • com.esri.sde.sdk.client provides classes that expose ESRI's ArcSDE server functionality. Applications created with this package can establish a connection to an ArcSDE instance, query a layer, and otherwise communicate with an ArcSDE server.
     
  • com.esri.sde.sdk.geom contains classes that implement the OGC (Open GIS Consortium) Geometry interfaces.
     
  • com.esri.sde.sdk.pe provides classes to define coordinate systems and to transform data between different coordinate systems.

Click here for the ArcSDE Java API Specification
 

Setting up the Java API

During ArcSDE client installation, the following files are installed:

File Description
jsde_sdk.jar Contains the ArcSDE Client, and Geometry Java API class files.
jpe_sdk.jar Contains the ArcSDE Projection Engine Java API class files.
concurrent.jar Provides standardized, efficient versions of utility classes commonly encountered in concurrent Java programming.
icu4j_3_2.jar ICU4J libraries required for globalization.

To build applications with the ArcSDE Java API, users must have Java Development Kit version 6 or higher installed on your system. You must also add the jsde_sdk.jar, jpe_sdk.jar, concurrent.jar, and icu4j_3_2.jar files to your CLASSPATH.
 

Setting up the Java API for Direct Connect Using JNI Implementation

In ArcSDE 9.2 and higher, direct connect is supported through a JNI implementation. For a direct connection to work, additional files are required, and the environment variables need to be set accordingly. In this release, the Java API direct connect is only supported in the Windows, Solaris, and Linux platforms.
 

Set the library path to include the SDEHOME/lib. Also set the LD_LIBRARY_PATH environment variable for all operating systems except IBM and HP. Set SHLIB_PATH for HP operating systems and LIBPATH for IBM operating systems. If using an Oracle DBMS, also set ORACLE_HOME.

The following libraries are required for direct connect support.

File Description
libsdejavautil This modules contains the ArcSDE direct connect library functions.
libgsrvr*93 This modules contains the ArcSDE direct connect library functions.
libsde*gsrvr93 This modules contains the ArcSDE direct connect library functions.
libsde* This modules contains the ArcSDE client library functions.
libsg* This modules contains the ArcSDE shape library functions.
libpe* This modules contains the ArcSDE PE library functions.
libxerces* This modules contains the XML parser library functions.
libicu* This modules contains the Unicode support library functions.
Set the SDEHOME environment variable to the ArcSDE home directory, and include the %SDEHOME%/bin in the PATH environment variable. Also set the ORACLE_HOME environment variable.

The following DLLs are required for direct connect support.

File Description
sdejavautil.dll This modules contains the ArcSDE direct connect library functions.
gsrvr*93.dll This modules contains the ArcSDE direct connect library functions.
sde*gsrvr93.dll This modules contains the ArcSDE direct connect library functions.
sde.dll This modules contains the ArcSDE client library functions.
sg.dll This modules contains the ArcSDE shape library functions.
pe.dll This modules contains the ArcSDE pe library functions.
xerces*.dll This modules contains the XML parser library functions.
icu*.dll This modules contains the Unicode support library functions.
feedback | privacy | legal