使用iServer JAVA API访问iServer空间分析服务进行叠加分析示例，apiiserver

使用iServer JAVA API访问iServer空间分析服务进行叠加分析示例，apiiserver

作者：MR

    之前一篇博客（SuperMap iServer JAVA API介绍）介绍了SuperMap iServer Java API（以下简称Java API）用处、用法，本篇介绍JAVA API访问iServer空间分析服务进行叠加分析的具体应用，并提供工程源码下载。作为示例，这里使用eclipse创建一个控制台应用。

一、创建JAVA工程&主类

    创建一个Java工程，工程下新建lib文件夹，复制%iServerROOT%\WEB-INF\lib\iserver-all-8.1.1-14511.jar到lib文件夹里，并将lib文件夹下的iserver-all-8.1.1-14511.jar右键添加到Build Path里。
    本文新建一个包，命名spatialAnalystSample，其下创建一个类，命名SpatialAnalystSample，添加main方法。工程结构如图（JDK1.8）：

二、获取空间服务提供者

    本文访问的空间分析服务REST资源根目录如下：

http://support.supermap.com.cn:8090/iserver/services/spatialanalyst-changchun/restjsr

    创建/释放RestSpatialAnalystProvider方法如下：

    /**
     * @param RootURL
     *            空间分许服务REST资源根目录
     * @return RestSpatialAnalystProvider
     */
    private static RestSpatialAnalystProvider getAnalystProvider( String rootURL )
    {
        // 服务提供者设置
        RestSpatialAnalystProviderSetting setting = new RestSpatialAnalystProviderSetting( );
        setting.restServiceRootURL = rootURL;
        // 创建服务提供者
        return new RestSpatialAnalystProvider( setting );
    }

    /**
     * @param provider
     *            待释放资源的服务提供者对象
     */
    private static void dispose( RestSpatialAnalystProvider provider )
    {
        if ( provider != null )
        {
            provider.clearCache( );
            provider.dispose( );
        }
    }

     RestSpatialAnalystProvider类参考最新在线地址如下（建议使用CHM格式）：

http://support.supermap.com.cn:8090/iserver/help/html/mergedProjects/iServerJavadoc/com/supermap/services/providers/RestSpatialAnalystProvider.html

三、业务逻辑实现

    接下来就可以使用服务提供者对象提供的方法实现各种业务逻辑了，本文实现对两个数据集里满足指定条件的要素求交集。main方法如下：

    private static final String SPASURL = "http://support.supermap.com.cn:8090/iserver/services/spatialanalyst-changchun/restjsr";

    /**
     * @param args
     */
    public static void main( String[ ] args )
    {
        long start = System.currentTimeMillis( );
        RestSpatialAnalystProvider spatialProvider = getAnalystProvider( SPASURL );
        // 设置分析的结果
        DataReturnOption option = new DataReturnOption( );
        option.dataReturnMode = DataReturnMode.DATASET_AND_RECORDSET;// 设置数据返回模式：l另存数据集和返回记录集对象
        option.dataset = "analystTemp"; // 结果保存到的数据集名称
        option.deleteExistResultDataset = true;// 如果analystTemp与已有的数据集重名，删除已有的数据集
        option.expectCount = 0; // 返回所有记录

        DatasetOverlayResultSetting setting = new DatasetOverlayResultSetting( ); // 数据集叠加分析结果设置类
        setting.dataReturnOption = option;
        // 指定返回结果的保留字段
        setting.sourceDatasetFields = new String[ ] { "name", "x", "y" };
        setting.operateDatasetFields = new String[ ] { "ClassID" };

        // 查询条件
        QueryParameter sourceQueryParameter = new QueryParameter( );// 数据集的查询参数
        sourceQueryParameter.name = "Park"; // 指定要查询的数据集
        sourceQueryParameter.attributeFilter = "SmID>0"; // 指定数据集的查询条件

        QueryParameter operateQueryParameter = new QueryParameter( );// 数据集的查询参数
        operateQueryParameter.name = "Frame_R";// 指定要叠加的数据集
        operateQueryParameter.attributeFilter = "SmID>0"; // 指定数据集的查询条件

        // 获取和处理结果
        // 数据集空间分析结果类 取得2数据集相交的结果
        DatasetSpatialAnalystResult intersectResult = spatialProvider.intersect( "Park@Changchun", sourceQueryParameter,
                "Frame_R@Changchun", operateQueryParameter, setting );// 获取叠加分析结果
        if ( intersectResult.succeed )
        {
            System.out.println( "叠加分析成功，返回结果数为：" + intersectResult.recordset.features.length );

            System.out.println( "返回的结果数据集字段如下：" );
            for ( String field : intersectResult.recordset.fields )
            {
                System.out.println( field );
            }
        } else
        {
            System.out.println( "叠加分析失败！" );
        }

        System.out.println( "done,cost:" + ( System.currentTimeMillis( ) - start ) );
        dispose( spatialProvider );
    }

    运行时会有报错java.lang.NoClassdeFoundError，这是因为我们虽然都只使用了iserver-all-8.1.1-14511.jar包里的方法，但是该包还会import别的包，所以编译没错，运行时就会报错了，目前暂无便捷的依赖管理工具去自动列出需要的依赖项，只能手动和根据报错添加依赖的包；反编译查看import也不是很好用，需要反编译你使用的类，找到它的依赖、依赖的依赖…，所以本文建议排除法，JAVA API所有的依赖都在%iServerROOT%\WEB-INF\lib目录下，把这些jar包都加到Build Path就行了，并且，已知本文使用的方法不涉及SuperMap iObjects Java，所以可以去掉com.supermap开头的(即Java组件的)的jar包，也不需要配置Java组件环境，剩下的jar先通过文件名排除一部分，然后一个一个去掉看运行结果来排除剩下的。

结果

其他&下载

    可以输出工程为jar，使用java命令运行（可以写成批处理脚本或shell脚本）即可，本文不再介绍。
    排除无用jar包后的工程如下，使用eclipse打开工程即可运行查看结果。

使用iServer JAVA API访问iServer空间分析服务进行叠加分析示例工程
http://download.csdn.net/detail/supermapsupport/9833942