arcgis SDE for Java

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维护，用户不能插入，删除或者修改这一列中的值