基于工具集的web应用开发帮助手册for silverlight

1第1章Web应用开发概 基于工具集的Web应用开发简 基于工具集的Web应用开发标 第2章基于JavaScript的Web应用开发模 开发简 整体架 第3章基于Silverlight的Web应用框架开 总体流 框 配置JSON文 JSON文件 编译框 第4章基于Silverlight的Web插件扩展开 总体流 添加插件方 配置JSON文 配置插 运行结 打包插 发布插 第5章常见问题解 第1Web应用开发基于工具集的Web应用开发简介WebWeb应用框架和框架相关的扩展插件，用户先选择自己需要的Web应用框架，然后选择该框架相应的扩展插件，最终生成Web应用定制包并安装。后期根据扩展需要可在Web应用超市中重新定制Web应用并更新本地Web应用。自行开WebWebWeb应用超市供用户(2)Web应用超市中的已有Web应用框架和相关的扩展插件，根据插件扩展规范扩展Web应用框架中的功能，生成插件包，并上载到Web应用超市中丰富其中的客户端用户定制并Web应用到本地，使用Web应用安装器将安装包安装到本地MapGISIGServer运行时环境中，包括示例数据安装、功能库扩展、服务扩展、站点发布，WebWeb框架以及功能插件，快速搭建一个持自由定制和扩展，加入Web应用超市。基于工具集的Web应用开发标准Web应用系统开发一般标准WebWebGIS应用框架WebWeb应用框插程插程功能插装载功能插件工具功能插件功能插件功能插件1.1基于工具集的Web应用开发结构说一 编译后的插件将存放于Web项目的$$tools$$ Web应用框架，即为Web项目的基础框架。例如，WebGIS息，Web应用框架解析该配置文件，将功能插件装载到制定网页版块中。Web应用系统编译打包后的根 名称以框架ID命名，{frameID}文件夹框架 为表1.1：1.1Web应用框架打包结t存放web框架相关说明文 注：以上文件夹的生成是根据实际Web应用框架选择对应文件后生成，若没有选择相关项，则不会生WebID命名的文件夹，插件所有文件均存放与此文件Web应用系统打包上载规范存放于..\MapGIS10\ProgramWeb应用框架、Web应用插件打包工具，打包工具相关操作参见第3Web应用框架打包小节以及第4章功能插件打包。第2章基于JavaScript应用开发模式息Web框架站点功能插件功能插件

功能插 2.1JavaScript的架构Web应用框架通过$$framework$$.json文件，功能插件配置信息动态xap文件,文件中需要的dll文件，创建插件资源为UIElement资源，获取根据插件创建UI功能菜单，设置菜单点击，调用插件方法第3章基于Silverlight应用框架开发WebWeb应用框架和框架相关的扩展插件，用户先选择自己需要的Web应用框架，然后选择该框架相应的扩展插件，最终生成Web应用定制包并安装。后期根据扩展需要可在Web应用超市中重新定制Web应用并更新本地Web应用。WebWebGIS应用框架要提供符合标准的Web应用框架。三大步骤图3.1：框架定框架定框架打框架发

3.1框架开发流Web框架Web应用框架定制在此步根据不业功能需求，根据Web应用框架规范定制不同的行业框架以及界面显示样式。Web应用框架定制流程如下图3.2所示：组 3.2Web应用框架定制组 基于Silverlight物流案例框架设下图3.3所示：3.3示例框在SilverlightSilverlight框架中，涉及插件调用框架中的全局对象或属性，与JS框架的调给插件，在MainPage.xaml.cs3.1所示，在插件中即可获取，具体获取方式参见4.3.2小节框架全局对象。3、3、Invoke Typetm.Invoke(App.Current.RootVisual,null); 功能插件功能插件图3.4全局属性插件方程序代3.1框架定义取全局对象的方publicIMSMap{return}{return}{return}框 结 结构，如图3.5所示图3.5框 为工具插件的根，其他插件均存放于此下；“$$framework$$.json”为插件的配置文配置JSON文件tools字段中，根据布局框架时定义的菜单结构，自定义需要的字段；“$$framework$$.json”文件信息如下图3.6所示：3.6$$framework.json配置信Web框架netframeworkWeb应用框架调用插件的tools3.23.2tools结点中调用插件配插件功能插件编译后的xap文在框架中需要动态加载的功能插件dll库注：单个tools的参数里除imgSrc、xapPath、mainName、FunName是自定义设定外，其他均为插件打JSON文件加载dll文件。配置好JSON文件后，在Silverlight的生成工具条的文件中编写JSON文件的代码，如程序代码3.2所示：程序代码3.2JSON文/////////JSONJSON///publicvoid{downloader=newpleted+=}/// ///public{JsonObject_data=JsonObject.Load(e.Result)asJsonObject;pluginJSON=_data["tools"]asJsonArray; }}在JSON文件回调中，tools中的xapPath字段配置信息，动态xap文件，如下程序代码3.3所示。程序代码3.3动态xap文////// ///<paramname="xapPath">JSONtools中的xapPath值///<paramname="toolID">插件ID</param>publicvoidloadXAP(stringxapPathstringtoolID){//1•使用 =newstringpath$$tools$$toolIDxapPath; }xap文件成功后，在App pleted回调中动态加载对应的dll如程序代码3.4所示。程序代3.4dll文件实///XAPCanvas//////<paramname="resultStream">使用Web privatevoidCreateXAPResource(stringdllStr,stringmainStr,StreamresultStream){StreamResourceInfo(resultStreamasStream,null),newUri(dllStr,AssemblyPartassemblyPart=newAssemblyassembly=Typet=element.GetType(); creatUI(element,fun);}程序代3.5UI，关联插件方/////////UI//////<paramname="fun">插 {btn.Click+=new}//////{} 3.7运行框架界编译框Silverlight项目框架测试好后，需要编译成站点文件，选择.web项目右键发布，如图3.8所示。3.8选择发布项在弹出的框选择发布的路径等设置，即可发布成站点文件，如 3.9所示3.9设置路径等信Web应用框架打包WebWeb框架使用的数据、工作流、服务扩展以及使用的插件打包成一个符合规范的Web应用框架包，上载至Web超市，供用户下3.11所示。IIS版本、应用程序池.netframework版本，在框架中使用的数据库 Web3.12设置框架基本完成。如下图3.13所示：3.13框架打包成打包完成后，会生成一个Web应用框架.webpkg压缩包，位于..\MapGIS于Silverlight物流案例如图3.14所示。3.14生成的框架Web应用框架发布Web应用框架打包完成后即可使用Web应用框架上载工具上传到Web应用超市供用户使用，Web应用超市上传地址为{aeID}\xxebpkg（3.16品分类选择：WEB应用→可定制应用→基础，如图3.15所示；3.15框架上传通用信息设3.16框架文件路详细描述，添加文本或详细描述框架功能，如图3.17所3.17框架功能详细描注：依赖此框架的插件须先上传到web应用超市后，再在此设置插件列表3.18设置插件列第4章基于Silverlight插件扩展开发能插件开发。总体流程如下图4.1所示：4.1插件开发流发环境工具打开框架站点，另一种是直接开发定制所需要的Web应用框架；装载到Web应用框架中；下面以“基于Silverlight的物流案例”为例进行讲解。Web应用框架准备Web如下图4.2、图4.3、图4.4所示。4.24.3解压框架以及发布框4.4框架安装成框架正常安装之后，会自动将框架以站点形式发布到WebWeb服务器上（如IIS。框架站点文件位于..\MapGIS10\Program\WebShopApplications\{frameID}文件夹中；例如基于SilverlightSilverlight物流案例框架安装后如图4.5所示。4.5安装后结功能插件开发创建插件项目4.6创建项4.7框架全局对象在项目的MainPage.xaml.cs页面，编写框架全局对象的方法，例如在基于Silverlight程序代码4.1框架全局对象方usingusingprivatevoidgetMapContainer()Typet=MethodInfomt.GetMethod("getIMSMap");}实现插件功能添加插件方如程序代码4.2所示。程序代码4.2添加插件方publicvoid{if{}m.mapContainer=this.map;m.mapContainer=this.map;}配置JSON文配置参数如图4.8所示，主要是设置插件id，插件按钮的和插件xap文件名，dll4.8配置文件信4.44.1。插件实现完成后，会在.Web项目的clienbin中生成一个xap文件，如图4.9所示。配置插打开Web框架站点：一种是从Web应用超市的基于Silverlight的Web应用框架，，将框架站点源码导入到VS2010中，该框架源码一般位于..\MapGIS10\Program\WebShopApplications\{frameID}\$$others$$ 发的Web框架项目，则直接打开框架项目；在VS2010的框架项目的.Web项目中添加存放插件的文件夹 于存放功能插件（.xap 下面以基于Silverlight物流案例为例：..\MapGIS10\Program\WebShopApplications\c826e4bb6c124384ac3d90fe6e4fb828，在此下的“$$others$$VS2010中,然后在框架图4.10所示：4.10导入框架源4.10中如“01”是一个工具插件的文件夹名称，可以自定义，在插件打包安装过程，系统会随机生成一个插件ID，该名称将无效。注：{frameID}是框架ID号，框架的所有文件存放于此文件夹中运行结4.11运行结4.12打开插件打包工4.13配置插件信4.15插件文件选其它资源：若工具插件中需要相关矢量