转ArcGIS Server Java ADF 案例教程

第一章 有关Web Service

在 IDE的菜单中，你会看到有个很长的【ArcGIS Web Services Project】，别高兴，这不是给你自定义Web Service的，运行完向导你会发现生成的是一个Java桌面程序——有着一如既往丑陋的界面和很不友好的GIS功能。原来我一直当它是废物，不过前段 时间它还真的帮了我大忙。我们有个测试需要测ArcGIS Server对Web Service的支持，要求必须抓取到浏览器与服务器交互的可读的SOAP消息；但是你要知道，考虑到效率ArcGIS Server内部都是用二进制的SOAP进行交互；要抓到可读的SOAP消息，ArcGIS的Web Service包必须被部署到浏览器端——最后，就是靠这个丑陋的“ArcGIS Web Services Project”，做了很多修改封装成了Applet才达到了这个要求。

扯远了，说了这么多其实只为了说明这样一点：“ArcGIS Web Services Project”是一个使用ArcGIS的Web Service类库实现一些GIS功能的Java桌面程序，演示意义大于应用意义。下面我们首先来讨论一下如何使用SOAP SDK来访问ArcGIS Server原生的Web Service；然后再谈谈怎么自定义Web Service，以便其它业务系统调用或出于其它目的的SOAP访问。

一 通过SOAP SDK访问ArcGIS Web Service

这 里我们通过一个简单的功能来演示如何使用SOAP SDK来访问ArcGIS Server，调用一个Map Service的功能。不管你是在Java桌面、Applet、ADF还是自定义的servlet中，如果你需要直接使用SOAP和ArcGIS交互，那 么下面的这段内容对你可能会有帮助。

这个简单的功能是“计算当前范围内的要素个数“，这个功能是如此的简单以至于我觉得看一下代码就可以明白了：

MapServerBindingStub mapserver = new MapServerBindingStub(url);

SpatialFilter filter = new SpatialFilter();

filter.setFilterGeometry(mapDescription.getMapArea().getExtent());

filter.setSpatialRel(EsriSpatialRelEnum.esriSpatialRelIntersects);

filter.setGeometryFieldName("SHAPE");

filter.setSubFields("*");

filter.setSearchOrder(EsriSearchOrder.esriSearchOrderSpatial);

filter.setWhereClause("");

filter.setSpatialReferenceFieldName("");

filter.setSpatialRelDescription("");

int count = mapserver.queryFeatureCount(“Layers”, 0, (QueryFilter) filter);

JOptionPane.showMessageDialog(this, "Feature count = " + count);

上 面涉及到的各个ArcGIS的功能类都在com.esri.arcgisws包下，从命名上就可以看出这是专门为Web Service准备的。代码里用到的url是地图服务的地址，比如“http://host:8399/arcgis/services/name /MapServer“。在整个环节中你可能会对MapServerBindingStub的queryFeatureCount方法有一点兴趣，其实你 打开ArcGIS帮助里的SOAP SDK，找到Map Services下面的QueryFeatureCount方法就可以看到，QueryFeatureCount需要3个参数，分别对应 DataFrame名称、图层序号和QueryFilter，正与上面的代码相符。换句话说，com.esri.arcgisws包里的功能类就是 SOAP SDK的Java实现。

可是，不管是ADF还是REST SDK都提供了比SOAP SDK好用多的调用ArcGIS Server功能的方法，所以想来你会和我一样，对上面的这些内容兴趣寥寥——我觉得ESRI对SOAP SDK也是兴趣寥寥，以至于在SOAP SDK的文档里几乎都没有Java的示例代码。

二 两种方式自定义Web Service

在IDE里创建一个Web Service工程是很容易的，只要找到【File】-【New】-【Web Service】菜单就可以了，点击这个菜单将会弹出下面的对话框：

这 里的Web service type有两种选择：一种是Bottom up、另外一种是Top down。这两种方式分别对应了自下而上和自上而下两种新建Web Service的模式。如果你已经有了实现的功能类，现在想要把它封装成Web Service，那么你应当选择Bottom up模式；如果你首先定义了Web Service的描述文件（wsdl），现在想要实现这个wsdl的功能，那么你应当选择Top down模式。

三 实现Web Service的功能

不 管通过Bottom up还是Top down方式，当你把Web Service的框架搭起来以后，剩下的工作就是如何去实现Web Service的功能了。下面让我们通过讲解一个网络分析Web Service的实现，来了解自定义Web Service的运作。

这个网络分析的Web Service需要的功能是预先定义好的，其中有比如上下游追溯、连通性分析等等，这里只挑连通性分析这个小功能进行说明。

首先，我们通过给定的wsdl新建了一个Web Service工程，然后找到实现类，在这个类中已经根据wsdl自动生成了对应各个功能的方法，这里就连通性分析功能进行讲解，对应的方法是connectivity，下面是这个方法的实现：

public class TestGISAnalysisSoapBindingImpl implements TestGISAnalysisPortType

{

private GeoNetworkAnalysis geoNetAnalysis;

public TestGISAnalysisSoapBindingImpl()

{

geoNetAnalysis = new GeoNetworkAnalysis();

}

public java.lang.String connectivity(String sourceDeviceType

, String sourceDeviceID

, String targetDeviceType

, String targetDeviceID,

String type) throws java.rmi.RemoteException

{

String result = "";

try

{

result = geoNetAnalysis.findPath(Integer.parseInt(sourceDeviceType)

, Integer.parseInt(sourceDeviceID)

, Integer.parseInt(targetDeviceType)

, Integer.parseInt(targetDeviceID)

, type);

}

catch (Exception ex)

{

ex.printStackTrace();

}

return result;

}

}

怎么这么简单？当然，因为这里对功能做了封装，真正的分析功能在geoNetAnalysis这个对象中，在这个对象中进行的都是直接对AO的操作，我们通过一些代码片段来看一下这个功能的实现：

public class GeoNetworkAnalysis

{

public GeoNetworkAnalysis()

{

try {

EngineInitializer.initializeEngine();

new AoInitialize().initialize(esriLicenseProductCode.esriLicenseProductCodeArcInfo);

ResourceBundle bundle = ResourceBundle.getBundle("geometrynetwork");

traceFlowSolver = new TraceFlowSolver();

INetSolver netSolver = (INetSolver) traceFlowSolver;

geometricNetwork = openNetwork(bundle.getString("workspacePath"),

bundle.getString("datasetName"),bundle.getString("networkName"));

pNetElements = new INetElementsProxy(geometricNetwork.getNetwork());

netSolver.setSourceNetworkByRef(geometricNetwork.getNetwork());

...

}

catch (Exception e)

{

e.printStackTrace();

}

}

/**

* 连通性分析

*

* @param sourceLyrID

* 起点的图层ID

* @param sourceFeatID

* 起点的要素ID

* @param targetLyrID

* 终点的图层ID

* @param targetFeatID

* 终点的要素ID

* @param type

* @return

*/

public String findPath(int sourceLyrID

, int sourceFeatID

, int targetLyrID

, int targetFeatID

, String type) throws Exception

{

this.putTraceOrigins(getOriginPoints(sourceLyrID

,sourceFeatID

,targetLyrID

,targetFeatID));

IEnumNetEID[] junctionEIDS = new IEnumNetEID[1];

IEnumNetEID[] edgeEIDs = new IEnumNetEID[1];

Object[][] costArray = new Object[1][1];

traceFlowSolver.findPath(esriFlowMethod.esriFMConnected,

esriShortestPathObjFn.esriSPObjFnMinSum

, junctionEIDS

, edgeEIDs

, 1

, costArray);

...

Set<IFeature> junctions = this.getSolverResultFeature(junctionEIDS[0]);

Set<IFeature> edges = this.getSolverResultFeature(edgeEIDs[0]);

return FeatureUtil.networkResultToJSON(junctions, edges);

}

}

注意，上面只是代码片段，整个功能的实现代码太长了，和我们要了解的Web Service其实又没有什么关系，所以，就看个大概吧。

做完这些，在很多场合都可以调用这个自定义的Web Service了，比如上面这个功能我们是在Flex中调用的：

<mx:Script>

<![CDATA[

private function analysisConnectivity():void

{

opt = wsAnalysis.getOperation("connectivity");

args = new Object();

args.sourceDeviceType = g1.attributes.layerId;

args.sourceDeviceID = g1.attributes.OBJECTID;

args.targetDeviceType = g2.attributes.layerId;

args.targetDeviceID = g2.attributes.OBJECTID;

args.type = "connectivity";

opt.arguments = args;

opt.send();

}

]]>

</mx:Script>

<mx:WebService id="wsAnalysis" wsdl="http://localhost:8080/WebServiceProject/wsdl/TestGISAnalysisHttpSoapEndpoint.wsdl"

showBusyCursor="true"

concurrency="last"

result="onWsAnalysisResult(event)"

fault="onWsAnalysisFault(event)"/>

试想一下，是不是不同的业务系统之间交互也可以做了呢？