博客园_一沙一世界，一花一天堂。

ArcGIS Server .NET ADF中的AJAX之深入浅出/CallbackResult详解

2011-03-12T07:28:00Z

ArcGIS Server .NET ADF中的AJAX之深入浅出/CallbackResult详解

原文：http://bbs.esrichina-bj.cn/ESRI/thread-61303-1-5.html

论坛中已有不少关于.NET ADF中AJAX的精彩讲解，但切入点有些抽象。本文试图从一个初学者的角度着眼，从AJAX讲起，由浅入深，去掉不必要的技术细节，使大家对.NET ADF中AJAX有清晰的理解。再辅以前人的教程，由此能更充分地掌握.NET ADF中AJAX的工作原理。
   经常在论坛上看到很多朋友问：为什么我已经创建了一个callbackresult，但是浏览器中却没有任何反应？或者我已经把ADF控件放到了 UpdatePanel里，但为什么还是达不到我想要的效果？9.3版本的.NET Web ADF发布近2年的时间里，ESRI从来没有说过：“很抱歉，我们ADF中的AJAX工作流程有时候可能会出现一点问题”，这证明.NET Web ADF中的AJAX还是足够可靠的，事实是问题只可能出现在我们的代码里。甚至在你根本还没有弄清如何来正确使用ADF中的AJAX时，就模仿别人的代码，寄希望于你也不知道为什么要创建的一个callbackresult就能够好好的为你工作，这不应该是经常和只知道循规蹈矩的机器打交道的人所做的事情。
   既然你已经选择了.NET ADF，并想利用好其中的AJAX能力，那么弄清楚它的原理应该是必要的，可以从本文第二部分开始阅读；但也许你是一个ArcGIS Server的新手，甚至是ASP.NET的新手，不得不在短时间内完成你手上的GIS任务，并不关心它的原理，那你可以阅读本文的前两部分或者只是第二部分。（如果你是一个网页开发的新手，那么请自行学习HTML+CSS+Javascript）
第一部分：1分钟AJAX时间
   典型的，ASP.NET 2.0之前的网页，当客户端发送请求的时候，比如点击“开始处理”按钮，会将整个页面信息提交到服务器上这个页面对应的类进行处理（发送的请求叫做 postback），这个页面类处理完成后将结果（包括页面原有的信息）输出成浏览器能够识别的HTML+CSS+Javascript返回客户端，你才会看到结果页面。提交请求后到结果页面呈现前，你的鼠标会呈沙漏状，无法操作页面；结果页面呈现的一瞬间，你会看到整个页面完全刷新一次。AJAX的出现就是为了解决这个糟糕的过程，有了AJAX本领的页面，当你点击“开始处理”按钮后，你依然能够对页面其他部分进行操作，结果呈现的时候也不会刷新全部页面，而只是悄悄修改需要改变的部分。目前互联网上大多数页面都有AJAX能力，但不要迷恋AJAX，它只是个效果的名称而已，你需要感谢的是 ASP.NET中实现AJAX的两个功臣：ASP.NET 2.0时候出现的Client Callback和ASP.NET 2.0的一个扩展ASP.NET AJAX。但也不要迷恋ASP.NET，因为在最下面真正干苦力活的是Javascript里的XMLHttpRequest对象，前两者是对其不同程度的封装。
   最后重复一下，Client Callback和ASP.NET AJAX是并列关系，根据你的需要取其一作为你实现AJAX的手段即可。
第二部分：如何正确使用CallbackResult
   任何想正确使用CallbackResult的人应该都不会拒绝我先解释一下究竟什么是CallbackResult，那就先来看看它是什么。
   在只有一个Map Control和Toolbar Control页面中，无论你如何操作地图，或者使用Toolbar上的按钮和工具与地图交互，都不会刷新整个页面，这证明所有Web ADF的控件具有AJAX能力，因为其他控件也是如此。Web ADF中的Server Control是如何实现这一点呢？无疑是利用了Client Callback（9.2版本和以上可用）或者ASP.NET AJAX（9.3版本和以上可用）。究竟怎么利用？这个问题先别急，让我们深入一点点。
   针对Web ADF控件，先来看一个普通的操作：鼠标拉框放大地图。它的整个完成过程是这样的：用户在客户端的地图上（其实是ESRI自己封装的名为Map的Javascript对象，属于Web ADF Javascript中的内容）用鼠标拉一个框，松开鼠标的时候地图对象会将一些信息，比如这个框框的范围等，发送到服务器端，服务器端对应的Map控件会根据服务器端当前Map的范围和框框的范围做计算，保留新的范围在服务器的Map控件上。服务器端的过程容易完成，但这些服务器端控件还需要负责任地将这些结果同步到客户端去，否则客户端看不到任何变化。在这个例子中服务器端将结果同步到客户端的过程是，由地图服务输出新的地图图像（如果是缓存地图服务，则给出新范围的切片）传送给客户端。如下图所示：

   如果不细心可以直接看下一段。如果细心，你可能会问为什么一个放大操作，上图会出现那么多回合的请求和响应？事实是，放大地图这个操作里会有两次请求/响应过程。请求1：传输框框范围到服务器；响应1：返回放大后的新地图范围给客户端；（客户端的地图控件收到响应1后立即再次发出）请求2：根据新范围问服务器端地图控件所要结果地图图片；响应2：传输地图图片给客户端。一个放大过程才算完成。结论：对Web ADF控件做的一个操作，很可能会引起不只一次请求和响应，但我们只关心且只需要关心最初的请求和最终的结果，因为其他过程Web ADF控件会自动替我们完成。
   任何对Web ADF控件的操作都是和上面的过程一样，客户端的Web ADF Javascript对象发送请求，服务器端相应的控件处理结果并通过“响应”（伴随着一系列对我们透明的后续请求和响应）来将结果同步到客户端去，这个 “响应”就是我们的主角：ADF中的CallbackResult对象（实际上是JSON字符串）。它是由服务器端的Web ADF控件生成，客户端的特定Web ADF Javascript函数负责解析的。不管生成的CallbackResult长什么样，客户端的负责解析的函数名字都叫做：processCallbackResult()。如下图所示：

   为了逻辑上的需要，比如一个动作对应一个CallbackResult，于是就有了上图的CallbackResultCollection。在服务器端，每个Web ADF Control都有一个Callbackresults属性（CallbackResultCollection），为什么需要这样呢？必须记住一点：“谁请求，谁管理”，即（客户端）发起请求的那个控件（在服务器端所对应的控件）负责传回CallbackResults。CallbackResults传回到客户端后，Web ADF Javascript中的processCallbackResult()函数就会自动对其进行解析。所以开发人员所需要做的工作就是，将服务器端所有产生的CallbackResults交付给负责带回CallbackResults的那个控件——加入控件的CallbackResults属性中。你并不需要关心CallbackResults到了客户端是如何解析的，因为这一切都由processCallbackResult()自动完成。因为请求可能由任何一个控件触发，所以每个Web ADF控件都有一个CallbackResults属性。
   比如，运行时动态给Map控件添加了新的地图服务。在这个过程中，Map控件会发送请求，那么自然是服务器端的Map控件负责将CallbackResults带回客户端。而页面中的TOC控件为了反映出这个变化，在服务器端就要对其进行刷新，刷新这个动作就会使TOC控件自身产生CallbackResults。记住“谁请求，谁管理”，Map请求，Map管理。如果不将TOC刷新的结果通过Map的CallbackResults带回客户端，那么页面上的TOC是不会有任何变化的。正确的做法是：

... <new map resource item added>
Toc1.Refresh();
Map1.CallbackResults.CopyFrom(Toc1.CallbackResults);

复制代码

整个过程如下图所示：

不是所有的Web ADF变化都需要我们手动处理，下面列出了一些Web ADF控件之间的内在关系：

已经绑定到Map的Toolbar控件上，任何command或tool执行过程中，会自动将Map的CallbackResults拷贝到Toolbar的CallbackResults中。所以如果在自定义command或tool里对Map做了修改，则不需要将其产生的CallbackResults拷贝给负责带回响应的Toolbar控件；
已经绑定到Map的TOC控件，NodeChecked事件会自动将Map产生CallbackResults拷贝给TOC控件；当Map和TOC中包含有可见性依赖比例尺变化而变化的图层时，ScaleChanged事件会将Toc的CallbackResults拷贝给Map控件；
ScaleBar绑定到Map后，ScaleBar的PreRender事件会将ScaleBar的CallbackResults拷贝给Map控件；
MapCopyrightText控件绑定到Map后，添加或移除map resource item会将MapCopyrightText的CallbackResults拷贝给Map控件；
Magnifier绑定到Map后，改变Map的显示范围或初始化tiling scheme时，会将Magnifier的CallbackResults拷贝给Map控件；
FloatingPanel的Refresh()方法会将其中所有子控件CallbackResults拷贝到自身的CallbackResults中；
TaskResults绑定到Map后，执行一个task会将Map的CallbackResults拷贝给TaskResults控件，TaskResults的CallbackResults随后会自动拷贝给这个执行的task。所以如果你手动将Map的CallbackResults拷贝给这个task的CallbackResults的话，将会产生重复的结果；
TaskResults控件有预定义的ContextMenus。这些右键菜单项的ItemClicked事件会将TaskResults和Map的CallbackResults自动拷贝给ContextMenu。

   这些内在关系在下面的Web ADF控件一览图中可见一斑。除了以上事件，其他情况下的CallbackResults都需要你自己将其添加到负责带回响应的控件中。

   另外，还可以在服务器端自定义CallbackResult，来达到修改客户端非Web ADF控件或者执行一段Javascript代码的目的。自定义CallbackResult可已通过其构造函数或静态方法来实现，这里不再赘述：

   当然，别忘了将自己创建的CallbackResults拷贝到正确的控件中。
   至此，如何正确使用CallbackResult的问题已经讲完了，这一切叫做Web ADF中callback result框架。它给我们提供了统一的编程体验，而你则可以根据自己的需要和编程经验来选择使用Client Callback还是ASP.NET AJAX。最后郑重提醒一点：如果使用了ASP.NET AJAX方式，在页面中强烈建议让所有Web ADF控件远离UpdatePanel。因为它们本身就能够注册到ScriptManager中，在完全刷新自己的情况下即可完成必要的内容更新。如果你将Web ADF控件放在UpdatePanel中，虽然能够正常工作，但刷新整个Web ADF控件。
第三部分：深入理解Web ADF中的AJAX
   现在来看看前面提出的问题：Web ADF究竟是如何利用ASP.NET中的Client Callback或是ASP.NET AJAX的？首先明确一点，Web ADF控件只能使用一种异步通信方式，要么是Client Callback，要么是ASP.NET AJAX。如果页面中有ScriptManager控件，就意味着你选择了ASP.NET AJAX方式进行异步通信，那么Web ADF控件的实际运行中也会采用这种方式；反之如果页面中没有ScriptManager控件，那么Web ADF实质上会采用Client Callback方式来进行异步通信。下面分别通过几个场景来看看两种方式的实际操作区别：
   如果采用了Client Callback方式：

场景一：Web ADF控件来产生请求和响应，客户端processCallbackResult()来处理响应

这个过程就是第二部分中假设的几个场景，请求由一个Web ADF控件产生，服务器端进行处理，也可在此时创建自定义CallbackResult来对页面中其他控件进行修改，最后将这些CallbackResults赋给正确的控件即可；响应带回客户端后，由Web ADF Javascript的processCallbackResult()函数进行解析。如图所示：

场景二：非Web ADF控件来产生请求和响应，客户端processCallbackResult()来处理响应

比如页面实现了ICallbackEventHandler接口，请求由页面中的一个HTML Button发出，在RaiseCallbackEvent()方法中将所有响应，也包括非Web ADF控件的，都构建成CallbackResult的结构，并集中到CallbackResultCollection中，然后在GetCallbackResult()方法中返回CallbackResultCollection.ToString()，客户端处理callback响应的js函数指定为Web ADF Javascript中的processCallbackResult()函数，则省去了自己解析callback响应的麻烦。如图所示：

场景三：非Web ADF控件来产生请求和响应，客户端自己处理响应

除了在客户端使用自定义的函数来解析包括CallbackResult结构在内的服务器响应外，其余和场景二是相同的。这种情况下你需要知道CallbackResult的JSON字符串中，使用“:::”分隔符来分隔参数，使用“^^^”分隔符来分隔多个CallbackResult，此外processCallbackResult()的定义可在X:\Inetpub\wwwroot\aspnet_client\ESRI\WebADF\JavaScript\ESRI.ADF.System.debug.js中找到。除非你已经有一套处理callback响应的js框架，否则还是推荐在客户端使用processCallbackResult()来进行响应处理。如图所示：

如果采用了ASP.NET AJAX方式：

场景一：Web ADF控件触发partial postback

此情形和Client Callback方式场景一类似，发送请求的Web ADF控件是ASP.NET AJAX中的trigger，它的CallbackResults注册为ScriptManager的一个data item返回客户端。如下图所示：

场景二：非Web ADF控件触发partial postback

trigger是非Web ADF控件时，更新Web ADF控件内容的方法有三种：UpdatePanels，data items或dynamic script blocks。如果将Web ADF控件放入UpdatePanel，则根据UpdatePanel的特性，会刷新里面整个Web ADF控件，这是不必要的，Web ADF控件所需要更新的内容仅仅是服务器端产生的CallbackResults，由客户端的processCallbackResult()即可完成，而不需要从头到尾的洗心革面。所以CallbackResults可以当做data items或dynamic script blocks来插入到partial postback的响应中。
作为dynamic script blocks时：首先要使用dynamic script blocks，页面中至少要有一个UpdatePanel（空的也可）。只需要在客户端调用ESRI.ADF.System.processCallbackResult() 来处理服务器端产生的CallbackResults（作为该函数的参数），如下：

. . .
string jsProcessCallbackResult = string.Format("ESRI.ADF.System.processCallbackResult('{0}');",
Map1.CallbackResults.ToString().Replace("\\", "\\\\"));
ScriptManager.RegisterClientScriptBlock(Page, sender.GetType(), "changeextent",
string.Format(jsProcessCallbackResult, Map1.CallbackResults), true);

复制代码

此方式的优点：Web ADF控件不需要完全刷新，客户端响应解析也不需要自己来写；缺点：注册的dynamic script blocks会保存在客户端内存中，最终可能会导致浏览器内存超出限制。
作为data items时：ScriptManager中注册的data items可以在服务器上以（JSON）字符串形式打包传到客户端进行处理。客户端接收到服务器端的异步postback响应后，但在进行任何局部内容的修改前，会触发客户端的pageLoading事件。这样就可以利用PageRequestManager捕捉到这个事件，从而将注册成data items的CallbackResults交给processCallbackResult() 来处理。过程如下图所示：

在服务器端将CallbackResult注册成data item：

ScriptManager1.RegisterDataItem(Page, Map1.CallbackResults.ToString(), false);

复制代码

监听pageLoading事件：

<script>
Sys.Application.add_init(onInitFunction);
// Called once during application initialization
function onInitFunction()
{
Sys.WebForms.PageRequestManager.getInstance().add_pageLoading(AsyncResponseHandler);
}
// Called whenever a response to a partial postback is processed on the client
function AsyncResponseHandler(sender, args)
{
var dataItems = args.get_dataItems();
if (dataItems['__Page'] != null)
ESRI.ADF.System.processCallbackResult(dataItems['__Page']);
}
</script>

复制代码

现在你对.NET ADF中的AJAX还有疑问吗？如果有不要犹豫，请继续阅读以下学习资源，之后欢迎进行交流。
论坛中S-H-G朋友的系列教程：
ArcGIS Server9.3 AJAX系列(一)之CallbackResults
ArcGIS Server9.3 AJAX系列(二)之Client CallBack解决方案
ArcGIS Server9.3 AJAX系列(三)之ASP.NET AJAX解决方案
ArcGIS Server9.3 AJAX系列(四)之总结
论坛中Jueery版主的系列教程：
ArcGIS Server .Net ADF中的AJAX(一)（帖子丢失，可在社区3周年精华文集中找到）
ArcGIS Server .Net ADF中的AJAX(二)
ArcGIS Server .Net ADF中的AJAX(二)续
ArcGIS Server .Net ADF中的AJAX(三)
关于Client Callback的详解：
carlbiao朋友的新手讲解.net的callback机制
ASP.NET 2.0's Client Callback Feature
关于ASP.NET AJAX：
AJAX : The Official Microsoft ASP.NET Site
关于XMLHttpRequest：
http://www.w3school.com.cn/php/php_ajax_xmlhttprequest.asp
最后不能少的就是帮AGS助中的文章，一切细节都在其中：
AJAX and ASP.NET
AJAX Capabilities of Web ADF Controls Overview
Working with CallbackResults
ASP.NET Callback Solutions
ASP.NET AJAX partial postback solutions

本文链接

地图缓存与瓦片切割步骤

2011-03-12T07:12:00Z

地图缓存与瓦片切割步骤

原文：http://bbs.esrichina-bj.cn/ESRI/thread-58288-1-2.html

第一部分主要来源于网络，后部分个人总结，操作上可能有些鄙陋。

本文链接

柱状专题图实现例子

2011-03-12T06:39:00Z

柱状专题图实现例子

原文：http://bbs.esrichina-bj.cn/esri/viewthread.php?tid=7613
//得到制作专题图的图层ID
  。。。。。。。。。。
  int  layerID=3;

//得到专题图分析元素的属性名称列表
String[]  fieldName=new String[2];
fieldName[0]="POP1990";
fieldName[1]="POP1999";

//得到专题图分析的图层对象（FeatureLayer）
AGSLocalMapResource res = (AGSLocalMapResource) this.webContext
   .getResources().get("ags0");
MapServer mapServer = res.getLocalMapServer();
ILayer fiLayer = mapServer.getLayer(mapServer.getMapName(0),  layerID);
FeatureLayer fLayer = (FeatureLayer) fiLayer;

//创建ChartRenderer对象  注意：在web adf中创建AO对象用AGSLocalMapResource对象的createArcObject（String）方法
ChartRenderer chartRender = (ChartRenderer) res
   .createArcObject(ChartRenderer.getClsid());

//在IRendererFileds中指定柱状图各列显示字段值
IRendererFields rendererFields = chartRender;
rendererFields.addField(fieldName[0], null);
rendererFields.setFieldAlias(0, rendererFields.getField(0));
rendererFields.addFieldfieldName[1], null);
rendererFields.setFieldAlias(1, rendererFields.getField(1));

//查出各元素指定属性最大值  必须的
QueryFilter queryFilter = (QueryFilter) res
   .createArcObject(QueryFilter.getClsid());
queryFilter.addField(fieldName[0]);
queryFilter.addField(fieldName[1]);
ICursor cursor = fLayer.ITable_search(queryFilter, true);
int numFields = 2; //柱状图列的个数
int[] fieldIndecies = new int[numFields];
fieldIndecies[0] = fLayer.findField(fieldName[0]);
fieldIndecies[1] = fLayer.findField(fieldName[1]);
double maxValue = 0;
   boolean firstValue = true;
IRowBuffer row = cursor.nextRow();
while (row != null) {
String fieldvalue = "";
for (int fieldIndex = 0; fieldIndex < numFields; fieldIndex++) {
   double fieldValue = Double.parseDouble(row.getValue(
   fieldIndecies[fieldIndex]).toString());
   if (firstValue) {
   maxValue = fieldValue;
         firstValue = false;
   }
   if (fieldValue > maxValue)
   maxValue = fieldValue;
      }
row = cursor.nextRow();
}

//实例化图表对象
  BarChartSymbol barChartSymbol = (BarChartSymbol) res.createArcObject(BarChartSymbol.getClsid());

IChartSymbol chartSymbol = barChartSymbol;
barChartSymbol.setWidth(10);
  IMarkerSymbol markerSymbol =  barChartSymbol;
chartSymbol.setMaxValue(maxValue);
markerSymbol.setSize(60);

//设置柱状图每列填充颜色及线颜色

ISymbolArray symbolArray = barChartSymbol;
SimpleFillSymbol fillSymbol1 = (SimpleFillSymbol) res.createArcObject(SimpleFillSymbol.getClsid());
IRgbColor rgbColor1 = (RgbColor) res.createArcObject(RgbColor .getClsid());

rgbColor1.setRed(255);
rgbColor1.setGreen(0);
rgbColor1.setBlue(0);
rgbColor1.setUseWindowsDithering(true);

ILineSymbol ilinesym1 = (ILineSymbol) res.createArcObject(SimpleLineSymbol.getClsid());
ilinesym1.setColor(rgbColor1);
ilinesym1.setWidth(1);
fillSymbol1.setOutline(ilinesym1);

fillSymbol1.setColor(rgbColor1);
barChartSymbol.addSymbol(fillSymbol1);

SimpleFillSymbol fillSymbol2 = (SimpleFillSymbol) res .createArcObject(SimpleFillSymbol.getClsid());

IRgbColor rgbColor2 = (RgbColor) res.createArcObject(RgbColor .getClsid());

rgbColor2.setRed(238);
rgbColor2.setGreen(195);
rgbColor2.setBlue(235);
rgbColor2.setUseWindowsDithering(true);

ILineSymbol ilinesym2 = (ILineSymbol) res.createArcObject(SimpleLineSymbol.getClsid());
ilinesym2.setColor(rgbColor2);
ilinesym2.setWidth(1);
fillSymbol2.setOutline(ilinesym2);
fillSymbol2.setColor(rgbColor2);
barChartSymbol.addSymbol(fillSymbol2);

chartRender.setChartSymbolByRef(chartSymbol);
chartRender.setUseOverposter(false);
  //设置FeatureRenderer ChartRenderer对象
  fLayer.setRendererByRef(chartRender);

  //刷新地图显示图表
map1.refresh();
this.webContext.refresh();

本文链接

控制图层是否显示的方法

2011-03-12T06:36:00Z

控制图层是否显示的方法

原文：http://bbs.esrichina-bj.cn/ESRI/viewthread.php?tid=22681&pid=211013&page=1&extra=page%3D1#pid211013
/// <summary>
/// 控制图层是否显示
/// </summary>
/// <param name="strLayerName">图层名</param>
/// <param name="blChecked">是否显示图层</param>
/// <param name="Map1">Map控件</param>
public void LayerCheck(String strLayerName, bool blChecked, Map Map1)
{

      IMapFunctionality mf = Map1.GetFunctionality("NorthAmerica") as IMapFunctionality;
      IGISResource gisresource = mf.Resource;


      IQueryFunctionality qfunc = null;
      qfunc = (IQueryFunctionality)gisresource.CreateFunctionality(typeof(IQueryFunctionality), null);

      string[] lids;
      string[] lnames;
      // 获取所有图层的id和name
      qfunc.GetQueryableLayers(null, out lids, out lnames);

      int layer_index = 0;
      for (int i = 0; i < lnames.Length; i++)
      {
         // 找到符合要求的图层编号
         if (lnames == strLayerName)
         {
            layer_index = i;
            break;
         }
      }
      if (strLayerName != string.Empty)
      {
         mf.SetLayerVisibility(layer_index.ToString(), blChecked);
      }
      Map1.Refresh();
}

本文链接

ArcGIS Server 开发初步 -- 自定义工具

2011-03-12T06:34:00Z

ArcGIS Server 开发初步 -- 自定义工具

原文：http://bbs.esrichina-bj.cn/ESRI/viewthread.php?tid=5590&extra=page%3D1

ArcGIS 9.2 Server Enterprise for Windows自定义工具

在Server生成的Web App中，页面的工具按钮可以分为两类：

l命令（Command）：A command is an element on a JSP page that triggers a server side action without any further interaction on the client. An example of a command in the sample application is the "zoom to full extent" button. Once the user clicks the button, a method is called on the server。不与用户通过界面交互。
l工具（Tool）：A tool has further client side interaction before calling a method on the server. An example of a tool in this application is "zoom to rectangle". Once the user clicks the button, drags a rectangle over the map indicating the area they want to zoom to, and then a method is called on the server。与用户通过界面交互。

自定义工具

一、继承接口
public Interface com.esri.adf.web.faces.event.MapToolAction{
void execute(MapEvent event);
}
lMapToolAction 接口代表由MapControl控件事件所激活的服务器端工具，系统已预设继承此接口的类：
PanToolAction（平移）,
ZoomInToolAction（放大）,
ZoomOutToolAction（缩小）
lMapControl 创建MapEvent 事件并将其传给继承接口的工具类的 execute(MapEvent) 函数，The business logic for the tool should be implemented in this method according to the event。

二、工具在JSP页面上的tag表达如下：

<ags:tool

serverAction="com.esri.adf.web.faces.event.ZoomInToolAction"

clientAction="EsriMapRectangle"

clientPostBack="true"

复制代码

三、注册managed-bean将所写的类作为一个managed-bean注册到faces-config.xml，并用WebContext实例作为其初始化参数：

<managed-bean>

<managed-bean-name>ToolClass</managed-bean-name>

<managed-bean-class>com.brsc.MyToolClass</managed-bean-class>

<managed-bean-scope>request</managed-bean-scope>

<managed-property>

<property-name>webContext</property-name>

<value>#{mapContext}</value>

</managed-property>

</managed-bean>

复制代码

四、注释：
1． JSP的Tag中serverAction写入继承MapToolAction接口的类（全称），代表对于此工具服务器端要进行的操作[ execute(MapEvent event)]
用户也可以使用任何Managed Bean的函数作为工具对应的方法，只要这个函数使用如下声明：
public void anyMethodName(MapEvent event)
JSP标签使用serverMethod ，如下：
<ags:tool serverMethod="#{bean.anyMethodName}" ... />
这样，MapControl也会将适当的MapEvent 事件传入此函数。

2． JSP的Tag中clientAction写入客户端鼠标选择的方式：

EsriMapPoint 点选

EsriMapLine 线

EsriMapRectangle 四边形

EsriMapCircle 圆

EsriMapOval 椭圆

EsriMapPolyline 多线

EsriMapPolygon 多边形

EsriMapPan 移动

复制代码

对应Server端的几何形状（附图）

3． MapEvent代表客户端进行操作产生的事件，一般会用到MapEvent的
public WebGeometry getWebGeometry()函数来得到客户端输入的几何形状
//Returns the WebGeometry in screen coordinates corresponding to
//the client action performed by the user.
来获得客户端产生的形状，这些Geomentry一般都是screen坐标，需要用toMapGeometry(WebMap)转换为 地图坐标 。
一般操作如下：

public void myToolMethod(MapEvent event) {

WebContext ctx = event.getWebContext();

WebGeometry screenGeom = event.getWebGeometry();

WebGeometry mapGeom = screen.toMapGeometry(ctx.getWebMap());

...

}

复制代码

4． JSP的Tag中clientPostBack
l 设置为false，刷新地图，并且刷新页面；
l 设置为true，只刷新地图，不刷新页面；

对应Server端的几何形状

本文链接

ArcGIS Server 9.2 实现基于web浏览器的在线编辑

2011-03-12T06:33:00Z

ArcGIS Server 9.2 实现基于web浏览器的在线编辑

原文：http://bbs.esrichina-bj.cn/ESRI/viewthread.php?tid=5612&extra=page%3D1

数据准备
Server 9.2开始支持基于web浏览器的数据在线编辑，要实现这样的功能，对数据有特殊的要求，先来看一下文档是怎么描述的：

Geodata Access

Allows an end user to perform replication and data extraction in AcrMap

Map document with a layer from a geodatabase

具体操作可以参考下面的步骤：
1、将需要在线编辑的数据通过SDE导入到数据库；
2、将该数据注册为版本(Register As Versioned…)；
3、在ArcMap中加载这个数据(Layer from a geodatabase)；
4、如果有其他的数据也添加到ArcMap中，保存成一个mxd文档；
数据准备就完成了！

发布服务
在Manager->Services中选择“Publish GIS Resource”，选择发布刚才保存mxd文档。可以看到，在Capabilities中“GeoData Access”被自动勾选了。

发布完成以后，Manager会自动创建两个同名的服务：一个是Map Service，另一个是Geodata Service。

注意，这里需要检查一下这两个服务的Pooled参数，一般默认发布服务的时候都选Pooled，因为这样有利于提高访问效率（就像JDBC的数据库连接池）。但是基于web的在线编辑不能用pooled。因为pooled的原理就是在服务器程序启动的时候先创建好n个完全相同的实例，客户端访问的时候直接从池中获取实例，用完以后再释放到池中以供其他用户使用。所以池化的实例只适用于进行只读的操作，或者对实例进行一些属性进行临时的修改，释放的时候调用reset方法。但是在线编辑修改的是SDE中的底层数据，这样的话就不能确保第一次创建的pooled实例（SOC中的map service实例）跟第二次创建的pooled实例是完全相同的。
第一次发布的时候没有修改pooled参数，导致在Web应用中点击“Editingtask”没有任何反应，也不报错误。后来把程序导入到Eclipse中编译运行在Console中看到如下的错误信息才想起上面的道理：
严重: At least oneAGSLocalMapResource with NotPooled Service is required to display Editing task.
2006-12-2714:45:59 com.esri.adf.web.ags.tasks.EditingTask a
严重: Error while attempting tostart editing com.esri.adf.web.ADFException: No layer available.
创建Web应用
在Manager中创建web应用有向导可以使用，步骤基本模板化。需要注意的有以下几个地方：
1、在layers对话框中，选择添加刚才我们发布的Map service。

2、在tasks的“Select Tasks”标前页中，添加Editing任务，至于其他的任务视需要自行添加。

3、在tasks的“Supporting Resources”标前页中，选择同名的那个service。可以留意一下，这个界面的service比步骤1中的service少，而且有好些是同名的。why？就是因为有些mxd文档中带有一些特殊图层，比如geoprocess、network，还有这个例子中的geodata access，这样的地图发布以后就会创建若干个同名的服务来支持map中的特殊图层。只是这里的图标很有迷惑性，大部分是map service的图标。

4、接下来就是关键的一步，配置Editing task了：
首先是选择要编辑的数据，这里我只发布了一个sde图层，所以没得选（下拉框只有一个内容）；我们可以选的是编辑的数据版本，当时为了测试创建了5个版本，这里就选择成序列的version1～3。
第二步是选择在客户端可以执行的操作种类以及与操作相关的一些选项，都是一些顾名思义的东西，不多说了。
最后一步是设置冲突处理原则，这里就按照默认设置“Parent Win”和“Row Level”。

需要注意的就是以上几点，其他的步骤跟发布普通map应用都差不多。
实例的使用
创建完成以后，把这个应用部署到服务器上，就可以开始测试了。
点击任务中的“Editing”，弹出对话框，从中我们可以选择要编辑的数据的版本，刚才选中的Version 1~3系列就出来了，选中一个版本（比如version 1）以后，点击“Start Editing”提交。

提交以后，地图刷新，将version 1的地图从SDE中读取出来，Editing对话框也相应地改变。刚才的图中左上角可是没有五角星的哦J另外还可以看一下Editing对话框下面的提示“Started Editing”，说明编辑已经成功地启动了。

接下来我们来创建一个新的要素吧，选择“Create Streets layer from sde”下的工具，在五角星的旁边画一个三角形，画完以后“Editing”工具条又发生变化了，其他的大家可以自己去试，工具条的最下面是属性表，我们可以给这个新画的三角形设置它的属性，随便输几个吧，记住“FULL_NAME=我创建的三角形”，这个就是它的标签啦。

创建完成以后点“Save Edit(s)”工具，将编辑结果提交给SDE。接下来我们打开ArcMap看看吧，从ArcCatalog里把数据拖到ArcMap里，版本切换到Version 1：

呵呵，看到了刚才创建的三角形，上面还打着我的戳呢J
概括

基于Web浏览器的编辑是ServerAdvanced版本才有的功能，由于编辑的时候需要选择版本，而版本支持是SDE才有的功能，我还测试过filegeodatabase，结果可以参考前面的批注。不过，用户既然买了server，当然也就有了sde啦。
上面的例子自己不用添加任何代码，只要在几个关键的地方不出差错，程序就能出来了，如果觉得不过瘾，咱们可以把它导入到Eclipse下面进行再加工……

浏览器中编辑

ArcMap查看编辑结果

本文链接

VB的Winsock控件GetData方法获取汉字乱码解决方法

2011-03-03T07:15:00Z

C#发送的socket消息带汉字时，使用Byte类型发送。

VB接收时，使用如下代码：

Private Sub Winsock1_DataArrival(ByVal bytesTotal As Long)
Dim bb(1 To bytesTotal) As Byte
Dim DD As String
Winsock1.GetData bb()
DD = StrConv(bb(), vbFromUnicode)
End Sub

本文链接

汉字转拼音缩写（VB版）

2011-02-24T09:11:00Z

VB代码：

'------------------------
'汉字转拼音缩写
'------------------------
Public Function GetPYSX(Str As String) As String
On Error GoTo PROC_ERROR
    Dim i As Long
    For i = 0 To Len(Str) - 1
        GetPYSX = GetPYSX & GetPYSXChar(Mid(Str, i + 1, 1))
    Next

PROC_ERROR:
    Exit Function
End Function
Public Function GetPYSXChar(char As String) As String
On Error GoTo PROC_ERROR
    Dim lChar As Long
    lChar = 65536 + Asc(char)
    If (lChar >= 45217 And lChar <= 45252) Then
        GetPYSXChar = "A"
    ElseIf (lChar >= 45253 And lChar <= 45760) Then
        GetPYSXChar = "B"
    ElseIf (lChar >= 45761 And lChar <= 46317) Then
        GetPYSXChar = "C"
    ElseIf (lChar >= 46318 And lChar <= 46825) Then
        GetPYSXChar = "D"
    ElseIf (lChar >= 46826 And lChar <= 47009) Then
        GetPYSXChar = "E"
    ElseIf (lChar >= 47010 And lChar <= 47296) Then
        GetPYSXChar = "F"
    ElseIf (lChar >= 47297 And lChar <= 47613) Then
        GetPYSXChar = "G"
    ElseIf (lChar >= 47614 And lChar <= 48118) Then
        GetPYSXChar = "H"
    ElseIf (lChar >= 48119 And lChar <= 49061) Then
        GetPYSXChar = "J"
    ElseIf (lChar >= 49062 And lChar <= 49323) Then
        GetPYSXChar = "K"
    ElseIf (lChar >= 49324 And lChar <= 49895) Then
        GetPYSXChar = "L"
    ElseIf (lChar >= 49896 And lChar <= 50370) Then
        GetPYSXChar = "M"
    ElseIf (lChar >= 50371 And lChar <= 50613) Then
        GetPYSXChar = "N"
    ElseIf (lChar >= 50614 And lChar <= 50621) Then
        GetPYSXChar = "O"
    ElseIf (lChar >= 50622 And lChar <= 50905) Then
        GetPYSXChar = "P"
    ElseIf (lChar >= 50906 And lChar <= 51386) Then
        GetPYSXChar = "Q"
    ElseIf (lChar >= 51387 And lChar <= 51445) Then
        GetPYSXChar = "R"
    ElseIf (lChar >= 51446 And lChar <= 52217) Then
        GetPYSXChar = "S"
    ElseIf (lChar >= 52218 And lChar <= 52697) Then
        GetPYSXChar = "T"
    ElseIf (lChar >= 52698 And lChar <= 52979) Then
        GetPYSXChar = "W"
    ElseIf (lChar >= 52980 And lChar <= 53640) Then
        GetPYSXChar = "X"
    ElseIf (lChar >= 53641 And lChar <= 54480) Then
        GetPYSXChar = "Y"
    ElseIf (lChar >= 54481 And lChar <= 62289) Then
        GetPYSXChar = "Z"
    End If

PROC_ERROR:
Exit Function
End Function

本文链接

汉字转拼音缩写（C#版）

2011-02-24T09:11:00Z

C#代码：

/// <summary>
        /// 汉字转拼音缩写
        /// Code By MuseStudio@hotmail.com
        /// 2004-11-30
        /// </summary>
        /// <param name="str">要转换的汉字字符串</param>
        /// <returns>拼音缩写</returns>
        public string GetPYString(string str)
        {
            string tempStr = "";
            foreach(char c in str)
            {
                if((int)c >= 33 && (int)c <=126)
                {//字母和符号原样保留
                    tempStr += c.ToString();
                }
                else
                {//累加拼音声母
                    tempStr += GetPYChar(c.ToString());
                }
            }
            return tempStr;
        }

        /// <summary>
        /// 取单个字符的拼音声母
        /// Code By MuseStudio@hotmail.com
        /// 2004-11-30
        /// </summary>
        /// <param name="c">要转换的单个汉字</param>
        /// <returns>拼音声母</returns>
        public string GetPYChar(string c)
        {
            byte[] array = new byte[2];
            array = System.Text.Encoding.Default.GetBytes(c);
            int i = (short)(array[0] - '\0') * 256 + ((short)(array[1] - '\0'));

            if ( i < 0xB0A1) return "*";
            if ( i < 0xB0C5) return "a";
            if ( i < 0xB2C1) return "b";
            if ( i < 0xB4EE) return "c";
            if ( i < 0xB6EA) return "d";
            if ( i < 0xB7A2) return "e";
            if ( i < 0xB8C1) return "f";
            if ( i < 0xB9FE) return "g";
            if ( i < 0xBBF7) return "h";
            if ( i < 0xBFA6) return "j";
            if ( i < 0xC0AC) return "k";
            if ( i < 0xC2E8) return "l";
            if ( i < 0xC4C3) return "m";
            if ( i < 0xC5B6) return "n";
            if ( i < 0xC5BE) return "o";
            if ( i < 0xC6DA) return "p";
            if ( i < 0xC8BB) return "q";
            if ( i < 0xC8F6) return "r";
            if ( i < 0xCBFA) return "s";
            if ( i < 0xCDDA) return "t";
            if ( i < 0xCEF4) return "w";
            if ( i < 0xD1B9) return "x";
            if ( i < 0xD4D1) return "y";
            if ( i < 0xD7FA) return "z";

return "*";
}

原文：http://blog.csdn.net/muse2008/archive/2004/11/30/199604.aspx

本文链接

汉字转拼音（C#版）

2011-02-24T09:09:00Z

C#代码：

using System;

using System.Collections.Generic;

using System.Text;

using System.Text.RegularExpressions;

using System.Web;

namespace CrazyCoder.Common

{

/// <summary>

/// 汉字转拼音类

/// by http://www.crazycoder.cn

/// build Date 20030610

/// </summary>

public class CrazyCoderPinyin

{

/// <summary>

/// 定义拼音区编码数组

/// </summary>

private static int[] pyValue = new int[]

{

-20319,-20317,-20304,-20295,-20292,-20283,-20265,-20257,-20242,-20230,-20051,-20036,

-20032,-20026,-20002,-19990,-19986,-19982,-19976,-19805,-19784,-19775,-19774,-19763,

-19756,-19751,-19746,-19741,-19739,-19728,-19725,-19715,-19540,-19531,-19525,-19515,

-19500,-19484,-19479,-19467,-19289,-19288,-19281,-19275,-19270,-19263,-19261,-19249,

-19243,-19242,-19238,-19235,-19227,-19224,-19218,-19212,-19038,-19023,-19018,-19006,

-19003,-18996,-18977,-18961,-18952,-18783,-18774,-18773,-18763,-18756,-18741,-18735,

-18731,-18722,-18710,-18697,-18696,-18526,-18518,-18501,-18490,-18478,-18463,-18448,

-18447,-18446,-18239,-18237,-18231,-18220,-18211,-18201,-18184,-18183, -18181,-18012,

-17997,-17988,-17970,-17964,-17961,-17950,-17947,-17931,-17928,-17922,-17759,-17752,

-17733,-17730,-17721,-17703,-17701,-17697,-17692,-17683,-17676,-17496,-17487,-17482,

-17468,-17454,-17433,-17427,-17417,-17202,-17185,-16983,-16970,-16942,-16915,-16733,

-16708,-16706,-16689,-16664,-16657,-16647,-16474,-16470,-16465,-16459,-16452,-16448,

-16433,-16429,-16427,-16423,-16419,-16412,-16407,-16403,-16401,-16393,-16220,-16216,

-16212,-16205,-16202,-16187,-16180,-16171,-16169,-16158,-16155,-15959,-15958,-15944,

-15933,-15920,-15915,-15903,-15889,-15878,-15707,-15701,-15681,-15667,-15661,-15659,

-15652,-15640,-15631,-15625,-15454,-15448,-15436,-15435,-15419,-15416,-15408,-15394,

-15385,-15377,-15375,-15369,-15363,-15362,-15183,-15180,-15165,-15158,-15153,-15150,

-15149,-15144,-15143,-15141,-15140,-15139,-15128,-15121,-15119,-15117,-15110,-15109,

-14941,-14937,-14933,-14930,-14929,-14928,-14926,-14922,-14921,-14914,-14908,-14902,

-14894,-14889,-14882,-14873,-14871,-14857,-14678,-14674,-14670,-14668,-14663,-14654,

-14645,-14630,-14594,-14429,-14407,-14399,-14384,-14379,-14368,-14355,-14353,-14345,

-14170,-14159,-14151,-14149,-14145,-14140,-14137,-14135,-14125,-14123,-14122,-14112,

-14109,-14099,-14097,-14094,-14092,-14090,-14087,-14083,-13917,-13914,-13910,-13907,

-13906,-13905,-13896,-13894,-13878,-13870,-13859,-13847,-13831,-13658,-13611,-13601,

-13406,-13404,-13400,-13398,-13395,-13391,-13387,-13383,-13367,-13359,-13356,-13343,

-13340,-13329,-13326,-13318,-13147,-13138,-13120,-13107,-13096,-13095,-13091,-13076,

-13068,-13063,-13060,-12888,-12875,-12871,-12860,-12858,-12852,-12849,-12838,-12831,

-12829,-12812,-12802,-12607,-12597,-12594,-12585,-12556,-12359,-12346,-12320,-12300,

-12120,-12099,-12089,-12074,-12067,-12058,-12039,-11867,-11861,-11847,-11831,-11798,

-11781,-11604,-11589,-11536,-11358,-11340,-11339,-11324,-11303,-11097,-11077,-11067,

-11055,-11052,-11045,-11041,-11038,-11024,-11020,-11019,-11018,-11014,-10838,-10832,

-10815,-10800,-10790,-10780,-10764,-10587,-10544,-10533,-10519,-10331,-10329,-10328,

-10322,-10315,-10309,-10307,-10296,-10281,-10274,-10270,-10262,-10260,-10256,-10254

};

/// <summary>

/// 定义数组

/// </summary>

private static string[] pyName = new string[]

{

"A","Ai","An","Ang","Ao","Ba","Bai","Ban","Bang","Bao","Bei","Ben",

"Beng","Bi","Bian","Biao","Bie","Bin","Bing","Bo","Bu","Ba","Cai","Can",

"Cang","Cao","Ce","Ceng","Cha","Chai","Chan","Chang","Chao","Che","Chen","Cheng",

"Chi","Chong","Chou","Chu","Chuai","Chuan","Chuang","Chui","Chun","Chuo","Ci","Cong",

"Cou","Cu","Cuan","Cui","Cun","Cuo","Da","Dai","Dan","Dang","Dao","De",

"Deng","Di","Dian","Diao","Die","Ding","Diu","Dong","Dou","Du","Duan","Dui",

"Dun","Duo","E","En","Er","Fa","Fan","Fang","Fei","Fen","Feng","Fo",

"Fou","Fu","Ga","Gai","Gan","Gang","Gao","Ge","Gei","Gen","Geng","Gong",

"Gou","Gu","Gua","Guai","Guan","Guang","Gui","Gun","Guo","Ha","Hai","Han",

"Hang","Hao","He","Hei","Hen","Heng","Hong","Hou","Hu","Hua","Huai","Huan",

"Huang","Hui","Hun","Huo","Ji","Jia","Jian","Jiang","Jiao","Jie","Jin","Jing",

"Jiong","Jiu","Ju","Juan","Jue","Jun","Ka","Kai","Kan","Kang","Kao","Ke",

"Ken","Keng","Kong","Kou","Ku","Kua","Kuai","Kuan","Kuang","Kui","Kun","Kuo",

"La","Lai","Lan","Lang","Lao","Le","Lei","Leng","Li","Lia","Lian","Liang",

"Liao","Lie","Lin","Ling","Liu","Long","Lou","Lu","Lv","Luan","Lue","Lun",

"Luo","Ma","Mai","Man","Mang","Mao","Me","Mei","Men","Meng","Mi","Mian",

"Miao","Mie","Min","Ming","Miu","Mo","Mou","Mu","Na","Nai","Nan","Nang",

"Nao","Ne","Nei","Nen","Neng","Ni","Nian","Niang","Niao","Nie","Nin","Ning",

"Niu","Nong","Nu","Nv","Nuan","Nue","Nuo","O","Ou","Pa","Pai","Pan",

"Pang","Pao","Pei","Pen","Peng","Pi","Pian","Piao","Pie","Pin","Ping","Po",

"Pu","Qi","Qia","Qian","Qiang","Qiao","Qie","Qin","Qing","Qiong","Qiu","Qu",

"Quan","Que","Qun","Ran","Rang","Rao","Re","Ren","Reng","Ri","Rong","Rou",

"Ru","Ruan","Rui","Run","Ruo","Sa","Sai","San","Sang","Sao","Se","Sen",

"Seng","Sha","Shai","Shan","Shang","Shao","She","Shen","Sheng","Shi","Shou","Shu",

"Shua","Shuai","Shuan","Shuang","Shui","Shun","Shuo","Si","Song","Sou","Su","Suan",

"Sui","Sun","Suo","Ta","Tai","Tan","Tang","Tao","Te","Teng","Ti","Tian",

"Tiao","Tie","Ting","Tong","Tou","Tu","Tuan","Tui","Tun","Tuo","Wa","Wai",

"Wan","Wang","Wei","Wen","Weng","Wo","Wu","Xi","Xia","Xian","Xiang","Xiao",

"Xie","Xin","Xing","Xiong","Xiu","Xu","Xuan","Xue","Xun","Ya","Yan","Yang",

"Yao","Ye","Yi","Yin","Ying","Yo","Yong","You","Yu","Yuan","Yue","Yun",

"Za", "Zai","Zan","Zang","Zao","Ze","Zei","Zen","Zeng","Zha","Zhai","Zhan",

"Zhang","Zhao","Zhe","Zhen","Zheng","Zhi","Zhong","Zhou","Zhu","Zhua","Zhuai","Zhuan",

"Zhuang","Zhui","Zhun","Zhuo","Zi","Zong","Zou","Zu","Zuan","Zui","Zun","Zuo"

};

/// <summary>

/// 汉字转换

/// by http://www.crazycoder.cn/

/// </summary>

/// <param name="hzString"></param>

/// <returns></returns>

public static string Convert(string hzString)

{

return Convert(hzString, 10);

}

/// <summary>

/// 把汉字转换成拼音(全拼)

/// by http://www.crazycoder.cn/

/// </summary>

/// <param name="hzString">汉字字符串</param>

/// <returns>转换后的拼音(全拼)字符串</returns>

public static string Convert(string hzString,int maxLength)

{

if (string.IsNullOrEmpty(hzString))

return null;

if (maxLength <= 1)

maxLength = 10;

hzString = hzString.Trim().Replace(" ", "").Replace("?", "_").Replace("\\", "_").Replace("/", "_").Replace(":", "").Replace("*", "").Replace(">", "").Replace("<", "").Replace("?", "").Replace("|", "").Replace("\"", "'").Replace("(", "_").Replace(")", "_").Replace(";", "_");

hzString = hzString.Replace("，", ",").Replace("；", "_").Replace("。", "_").Replace(""", "").Replace(""", "").Replace("[", "").Replace("]", "").Replace("【", "").Replace("】", "");

hzString = hzString.Replace("{", "").Replace("}", "").Replace("^", "").Replace("&", "_").Replace("=", "").Replace("~", "_").Replace("@", "_").Replace("￥", "");

if (hzString.Length > maxLength)

{

hzString = hzString.Substring(0, maxLength);

}

Regex regex = new Regex(@"([a-zA-Z0-9\._]+)", RegexOptions.IgnoreCase);

if (regex.IsMatch(hzString))

{

if (hzString.Equals(regex.Match(hzString).Groups[1].Value,StringComparison.OrdinalIgnoreCase))

{

return hzString;

}

// 匹配中文字符

regex = new Regex("^[\u4e00-\u9fa5]$");

byte[] array = new byte[2];

string pyString = "";

int chrAsc = 0;

int i1 = 0;

int i2 = 0;

char[] noWChar = hzString.ToCharArray();

for (int j = 0; j < noWChar.Length; j++)

{

// 中文字符

if (regex.IsMatch(noWChar[j].ToString()))

{

array = System.Text.Encoding.Default.GetBytes(noWChar[j].ToString());

i1 = (short)(array[0]);

i2 = (short)(array[1]);

chrAsc = i1 * 256 + i2 - 65536;

if (chrAsc > 0 && chrAsc < 160)

{

pyString += noWChar[j];

}

else

{

// 修正部分文字

if (chrAsc == -9254) // 修正"圳"字

pyString += "Zhen";

else

{

for (int i = (pyValue.Length - 1); i >= 0; i--)

{

if (pyValue[i] <= chrAsc)

{

pyString += pyName[i];

break;

}

// 非中文字符

else

{

pyString += noWChar[j].ToString();

}

return pyString;

}

原文：http://longfei2025.blog.163.com/blog/static/3580771920081154259527/

本文链接