使用iServer JAVA API访问iServer数据服务进行数据操作示例

作者：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文件夹里，并将iserver-all-8.1.1-14511.jar右键添加到Build Path里。
    本文新建一个包，命名dataSample，其下创建一个类，命名DataSample，添加main方法。工程结构如图（JDK1.8）：

###二、获取数据服务提供者
    本文访问的数据服务REST资源根目录如下：

http://support.supermap.com.cn:8090/iserver/services/data-world/rest

    创建/释放RestDataProvider方法如下：

	/**
	 * @param RootURL
	 *            数据服务REST资源根目录
	 * @return
	 */
	private static RestDataProvider getDataProvider( String rootURL )
	{
		// 服务提供者设置
		RestDataProviderSetting ProviderSetting = new RestDataProviderSetting( );
		ProviderSetting.restServiceRootURL = rootURL;
		// 创建服务提供者
		return new RestDataProvider( ProviderSetting );
	}

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

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

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

###三、业务逻辑实现

    接下来就可以使用服务提供者对象提供的方法实现各种业务逻辑了，本文实现创建一个点数据集并添加点。main方法如下：

private static final String DATAURL = "http://support.supermap.com.cn:8090/iserver/services/data-world/rest";

	/**
	 * @param args
	 */
	public static void main( String[ ] args )
	{
		long start = System.currentTimeMillis( );
		RestDataProvider dataProvider = getDataProvider( DATAURL );
		final String datasourceName = "World";
		final String copyDSName = "Capitals";
		final String newDSName = "TESTPoints";
		// 新建数据集(这里就不new完挨着赋值了，复制一个,目前通过REST API创建数据集不支持设置字段)
		Boolean flag = true;
		try
		{
			if ( dataProvider.copyDataset( datasourceName, copyDSName, datasourceName, newDSName ) )
			{
				System.out.println( copyDSName + " 数据集已复制，新数据集为 " + newDSName );
			} else
			{
				flag = false;
			}
		} catch ( Exception e )
		{
			System.out.println( newDSName + " 数据集已存在" );
		}
		if ( flag && dataProvider.clearFeatures( datasourceName, newDSName ) )
		{
			System.out.println( newDSName + "数据集已清空" );
			int[ ] ids = new int[ ] { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 };
			List< Feature > targetFeatures = dataProvider.getFeature( datasourceName, copyDSName, ids, null );
			// 未指定全部字段及对应字段值
			Feature pt1 = new Feature( );
			pt1.fieldNames = new String[ ] { "CAPITAL" };
			pt1.fieldValues = new String[ ] { "零零" };
			pt1.geometry = new Geometry( );
			pt1.geometry.parts = new int[ ] { 1 };
			pt1.geometry.points = new Point2D[ ] { new Point2D( 0.0, 0.0 ) };
			targetFeatures.add( pt1 );
			EditResult result = dataProvider.addFeatures( datasourceName, newDSName, targetFeatures );
			System.out.println( newDSName + "数据集增加要素是否成功：" + result.succeed );
			System.out.println( newDSName + "数据集增加要素数量：" + result.ids.length );
		}
		// // 数据集信息
		// DatasetInfo tempif = dataProvider.getDatasetInfo( datasourceName,
		// copyDSName );
		// DatasetVectorInfo dsvctif = new DatasetVectorInfo(
		// (DatasetVectorInfo) tempif );
		// dsvctif.name = newDSName;
		//
		// // 创建点数据集
		// if ( dataProvider.createDataset( datasourceName, dsvctif ) )
		// {
		// System.out.println( "创建数据集 " + newDSName + "成功！所有数据集如下：" );
		// List< String > dtnms = dataProvider.getDatasetNames( datasourceName
		// );
		// for ( String s : dtnms )
		// {
		// System.out.println( s );
		// }
		// System.out.println( "-------------------" );
		// // 创建成功添加点
		// int[ ] ids = new int[ ] { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 };
		// List< Feature > targetFeatures = dataProvider.getFeature(
		// datasourceName, copyDSName, ids, null );
		// EditResult result = dataProvider.addFeatures( datasourceName,
		// newDSName, targetFeatures );
		// System.out.println( newDSName + "数据集添加要素是否成功？" + result.succeed );
		// System.out.println( newDSName + "数据集添加要素数量" + result.ids.length );
		// System.out.println( newDSName + "数据集删除结果： " +
		// dataProvider.deleteDataset( datasourceName, newDSName ) );
		// }
		dispose( dataProvider );
		System.out.println( "done,cost:" + ( System.currentTimeMillis( ) - start ) );
	}

    运行时会有报错**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/9833944