API:http://edndoc.esri.com/arcsde/9.2/api/japi/docs/index.html
介绍
ArcSDE Java API提供了一个开放的、高层次的编程接口，以处理与分析空间信息。它包含了三个java包：Client包、Geometry包、以及Projection包。
Client包提供了实现ArcSDE服务器相关的功能的类。利用这个包建立的应用程序，能建立一个到ArcSDE实例的连接，查询一个层，或者与ArcSDE服务器进行通讯。
Geometry包提供了实现OGC（开源GIS）几何学功能接口的类。
Projection包提供了定义一个坐标系统与在不同坐标系统中转换的功能的类。
下面的主题对ArcSDE Java API的功能进行了大体的介绍。
设置API
在ArcSDE客户端安装的时候安装了下列文件：
1. jsde90_sdk.jar- 包含了ArcSDE客户端, 几何学功能以及SG Java API的类文件。
2. jpe90_sdk.jar – 包含了ArcSDE Projection Engine Java API的类文件。
3. concurrent.jar – 这个文件在使用PeCSTransformationX()时必须要用到, PeCSTransformationX()的功能是转换坐标系统。
4. sdejavautil.dll (Windows平台下) - contains the native code portion of the com.esri.sde.sdk.client.SeInstance start function.
5. libsdejavautil.so (Unix platforms only, libsdejavautil.sl on HP-UX) - contains the native code portion of the com.esri.sde.sdk.client.SeInstance start function.
Java Doc(HTML格式的API功能参考文档)可以在ArcSDE Developer Help中链接到，这个文档可以在ArcSDE客户端安装的CD上以及ESRI的技术支持网站中找到。
要建立一个使用ArcSDE java API的应用程序，你必须要在系统中安装Java 2 Standard Edition SDK，1.4.0版本以上。你还必须在你的CLASSPATH环境变量中加上jsde90_sdk.jar, jpe90_sdk.jar and concurrent.jar的文件路径。如果你还要使用到com.esri.sde.sdk.client.SeInstance的Start 函数，你还要往你的系统路径（Windows平台 system path；所有的Unix平台system library path）中添加sdejavautil library。
连接到ArcSDE
使用ArcSDE软件的第一步是建立一个ArcSDE服务器连接。SeConnection类就是用来建立一个连接的。下面是一个建立连接的例子：
public static void main (String args[])throws Exception {
SeConnection conn = null;
String server = “sdeserver”;
int instance = 5151;
String database = “sdedb”;
String user = “user”;
String password = “passwd”;
try {
conn = new SeConnection(server, instance, database, user, password);
}catch (SeException e) {
e.printStackTrace();
}
}
注意：instance参数是ArcSDE服务器的端口号。例如：5151，而不是esri_sde。
连接与数据库信息
SeConnection类还提供了取得ArcSDE服务器信息的方法，这些信息包括：服务器的版本以及连接的信息。使用SeConnection类还可以取得存储在RDBMS上的数据的相关信息。下面的例子展示了如何取得存储与ArcSDE数据库内的的图层列表信息（假设连接已经建立）。
Vector layerList = conn.getLayers();
for( int index = 0 ; index < layerList.size() ; index++ ) {
SeLayer layer = (SeLayer)layerList.elementAt(index);
// Displays the layer’s name
System.out.println( layer.getName() );
// Displays the layer’s ID
System.out.println( layer.getID().longValue() );
// Displays the layer’s spatial column name
System.out.println( layer.getSpatialColumn() );
}
SeLayer对象包含了图层的所有相关信息ArcSDE Java API函数参考中还列出了其他的取得ArcSDE layer的属性的方法.
Fetching data
数据从一张表或者一个layer中查询得出。SeQuery对象则是用于准备并执行一个查询操作，建立并执行一个查询的步骤如下：
1.建立一个SeSqlConstruct对象，这个对象中有想要查询的table/layer的名字。你也可以在SeSqlConstruct的构造函数中指定一个where查询语句。
SeLayer layer = new SeLayer( conn, layerName, spatialColumn );
SeSqlConstruct sqlConstruct = new SeSqlConstruct( layer.getName() );
2.创建一个String数组以存储要查询的表的列名。
String[] cols = new String[2];
cols[0] = new String("ColumnOneName");
cols[1] = layer.getSpatialColumn();
3.定义，准备并执行查询。
// Create a query stream between the client and server
SeQuery query = new SeQuery( conn, cols, sqlConstruct );
query.prepareQuery();
query.execute();
4.取查询结果的第一行存入SeRow对象中。
SeRow row = query.fetch();
5.取得SeRow的列结构。
// Get the definitions of all the columns retrieved
SeColumnDefinition[] colDefs = SeRow.getColumns();
6.先获取第一列的数据类型，然后获取该单元上的数据。
//获取第一列的数据类型。
int colNum = 0;
int dataType = colDefs[colNum].getType;
//假定数据类型只有String和Shape两种。
//可以自己添加一些语句以支持ArcSDE列的所有数据类型。
// ( See Working with Layers Example )
switch( dataType ) {
case SeColumnDefinition.TYPE_STRING:
System.out.println(colDef.getName()+ row.getString(colNum));
break;
case SeColumnDefinition.TYPE_SHAPE:
System.out.println(colDef.getName() );
SeShape shape = row.getShape(colNum);
//调用一个函数以获取Shape的属性。
break;
}
7.关闭查询。
query.close();
注意:为了取出查询结果所有的行，可以反复的调用query.fetch直至SeRow对象返回为空值为止。
插入数据
可以使用SeInsert类来往一张表或者图层中插入数据。插入数据的步骤如下：
1. 建立一个String对象，以存储要添加数据的表的列名。注意数组索引值；这些索引值将在SeRow.set*中使用到。String类型的列的索引值是0，而Shape类型的列的索引值是1.
String[] cols = new String[2];
cols[0] = new String("ColumnOneName");
cols[1] = layer.getSpatialColumn();
2.使用当前的连接句柄Connection conn,创建一个SeInsert对象.这将建立一个从客户端到服务器的Insert数据流(Stream)。然后根据表或图层的列名来插入数据，设置SeInsert对象为可写模式(setWriteMode)。
SeInsert insert = new SeInsert(conn);
insert.intoTable(layer.getName(),cols);
insert.setWriteMode(true);
3.获取SeInsert对象中将要添加的SeRow对象。然后设置要插入的数据，这一步用到SeRow.set*方法。利用第一步中确定的索引值来作为set*方法中的columnPosition参数。
SeRow row = insert.getRowToSet();
row.setString(0, "Shape Number One");
row.setShape(1,shape);
4.调用SeInsert对象的execute()方法，将前面设置好的SeRow对象插入到图层中。最后关闭Insert数据流(Stream)结束这次插入的操作。如果不再使用到连接句柄Connection conn，也顺便把连接关闭。
insert.execute();
insert.close();
注意：数据只能插入到由用户创建并维护的列中，如果某个列被注册为
SE_REGISTRATION_ROW_ID_COLUMN_TYPE_SDE
则这个列的值将有ArcSDE自动生成并插入，另外object id在ArcCatalog建立一张表或者Feature class的时候就生成了，由ArcSDE维护，用户不能插入，删除或者修改这一列中的值。