posts - 309, comments - 6940, trackbacks - 0, articles - 3
  BlogJava :: 首页 :: 新随笔 :: 联系 :: 聚合  :: 管理

ArcSDE Java API

Posted on 2009-05-07 11:39 诗特林 阅读(2008) 评论(0)  编辑  收藏 所属分类: GIS

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 SDK1.4.0版本以上。你还必须在你的CLASSPATH环境变量中加上jsde90_sdk.jar, jpe90_sdk.jar and concurrent.jar的文件路径。如果你还要使用到com.esri.sde.sdk.client.SeInstanceStart 函数,你还要往你的系统路径(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;

            //假定数据类型只有StringShape两种。

            //可以自己添加一些语句以支持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 idArcCatalog建立一张表或者Feature class的时候就生成了,由ArcSDE维护,用户不能插入,删除或者修改这一列中的值。


只有注册用户登录后才能发表评论。


网站导航: