Flex4项目访问BlazeDS4服务的操作指南.doc

韩祥斌-Flex4 项目访问 BlazeDS4 服务的操作指南使用 Flash Builder4 构建以数据为中心的 Flex 应用1基本步骤：z创建服务端数据服务z创建Flex项目z在Flex项目中连接到数据服务，并配置对数据服务的访问z构建Flex项目的用户界面2Flex应用访问数据服务的方式Flex应用可以以远程对象、HTTP(或REST)服务和Web服务的方式访问数据服务。2.1使用远程对象服务远程对象可以访问如下服务器类型的数据服务：zColdFusion服务z基于AMF的PHP服务zBlazeDSzLiveCycle Data Services2.1.1Flex应用的设置使用远程对象方式访问数据服务，Flex应用必须进行服务器类型的选择（通过“创建Flex项目” 向导或者修改Flex项目的属性实现）。Flex应用确定了服务器类型，就只能访问这种类型的 数据服务。如果要在一个Flex项目中访问多种类型的数据服务，只能再借助于HTTP(或REST) 服务和Web服务的方式。 使用HTTP(或REST)服务和Web服务的方式访问数据服务，无需对Flex项目进行任何设置， 在任何Flex项目中的MXML文件中直接配置使用。2.1.2连接到数据服务在Flash Builder4中，打开Flex应用并使用Data/Service向导连接到数据服务。根据服务器提供 的数据服务进行参数设置，从而根据数据服务自动生成必要的访问代码和值对象。2.1.3跨域策略文件(Cross-domain policy file)如果要在SWF文件或Flex应用中要访问位于不同域（即与Flex应用所在域不同）中的数据服 务时，必须使用跨域策略文件。而支持AMF的数据服务（即远程对象）无需跨域策略文件， 因为这些服务必然位于与Flex应用相同的域。2.2访问HTTP服务可以在任何Flex项目中，通过Flash Builder的Data/Service向导连接到HTTP服务，而无需在创 建项目的时候设置服务类型。2.2.1配置HTTP服务22如上图所示，“配置HTTP服务”的向导中，可以进行如下配置：z是否使用基本URL作为所有操作URL的前缀 如果要访问一个服务的多个操作（即一个URL的多个操作），使用该方式比较方便。 z操作给出一个URL上的明确的操作，以及HTTP方法（如GET/POST/HEAD等）和内容类型。 如果是POST方法，还需要给出内容类型，包括如下两类：application/x-www-form-urlencodedapplication/xmlz参数 对于要访问的URL是的操作，如果需要访问参数，可以在这里提供参数的名称、数据类型、 参数类型。 如果在操作部分设置了内容类型为application/xml，则访问参数不可编辑，参数默认名为 strXML，数据类型String，参数类型POST。z服务详细信息 服务名称是在Flex项目中对数据服务的引用名（必须唯一），服务名称的命名规则：不能以数字打头不能是AS的关键字不能使用已有的AS类名对于PHP类型的数据服务，不能包含下划线 服务包是一个文件的包名，用以放置访问数据服务的AS文件。数据类型包一个文件的包名，用以放置数据服务返回的数据类型的AS文件。zRESTful服务Flash Builder4通过定界符分割参数的方式支持RESTful服务，如下形式：http:/restfulService/items/itemID其中的参数表示NameData TypeParameter TypeitemsStringURLitemIDStringURL3通过BlazeDS访问J2EE类型的数据服务只有先安装BlazeDS，并配置Remote Development Server之后，才能访问BlazeDS服务。 在新建Flex项目的向导中，选择“J2EE”的服务器类型，并选择BlazeDS，才能访问BlazeDS 服务。3.1解压缩BlazeDS将下载的最新的BlazeDS文件（blazeds-turnkey-4.0.0.xxxxx.zip）解压缩，目录结构如下图所 示。其中，“BlazeDS/tomcat”是 BlazeDS 自带的 Tomcat 6 服务器。另外，“BlazeDS/tomcat/webapps/blazeds”是 BlazeDS 提供的空项目，可以作为开发的基础。3.2配置Remote Development Server打开 blazeds/WEB-INF/web.xml 文件，将其中的如下内容的注释去掉，并设置初始化参数useAppserverSecurity 的值为 false 如下：RDSDispatchServletRDSDispatchServletflex.rds.server.servlet.FrontEndServletuseAppserverSecurityfalse103.3创建MyEclipse项目以提供数据服务在MyEclipse IDE中创建Web Project如下图所示：将解压缩后的BlazeDS的“BlazeDS/tomcat/webapps/blazeds”目录下的所有文件复制到MyEclipse项目的WebRoot目录下，并覆盖相关文件。从而将必要的lib中的Jar文件和Flex相 关的配置文件导入MyEclipse项目。完成后的MyEclipse项目如下图所示。下面，就可以根据应用的实际需求，创建必要的数据服务，并配置services-config.xml文件和remoting-config.xml文件，具体参考BlazeDS的用法说明。数据服务开发完成后，将项目部署到Web服务器上，点击“部署项目到服务器”的按钮，如 下图所示：在打开的“项目部署”对话框中，点击“添加”按钮，打开如下图所示：在“新部署”对话框中，点击“Edit Server Connectors”链接，打开如下图 所示：在打开的对话框中，选择解压缩的BlazeDS目录下的tomcat目录，确认后即可看到如下图所 示。部署后的文件目录结构如下图所示：3.4创建Flex项目在Flash Builder4中, 选择菜单“文件新建Flex项目”，打开新建Flex项目对话框，如下图所 示。给项目取名TestBlazeDS，设置“应用程序服务器类型”为J2EE，并选择BlazeDS，如下图所示。点击“下一步”进入如下图所示界面。在“服务器位置”设置部分，“根文件夹”是Flex项目所在的文件夹，“根URL”是Flex项目部署后的网络地址，“上下文根目录”是Flex项目的服务地址。 这里，要“验证配置”成功，必须首先启动数据服务被部署的Tomcat服务器（默 认就是BlazeDS自动的Tomcat服务器）。锦祥法-F1ex4 项目访间 B1azeDS4 服务的操作指南1右 眼 四项目E田园主主输刨建源应出 n四项目.为新文的用文Flex 项目设置构建路径. E国件程件夹序夹 文NwUu )件阻 源路径($) 也I何地a 库路径(l)0sT组件集 MX +recSs park!t) 仅 MX 也)工篮豆主屋.!I.llBft架链接也) I使用 SD默认a 值运行町共享库) I Ie构建路径库自主)Deamx百百.丽.咽!.:圃霄胃四m胃喃喃冒冒n!lII1睛胃霍酣嗯添加Jjl(目也)lIB l libs际币市再则)L主旦旦旦添加 nex SDK(1)编t量也) 删除Q) 且l囚E盘证 RSL 摘要建议在生产环域中使用)(y)回在调试时使用本地调试运行时共享库 ) 回基于依赖项自动确定库排序也)向上也)豆J 向下也) 囹豆E 厄E豆3 C歪歪歪3 下-步也) C豆豆豆取消点击完成即可。韩祥斌-Flex4 项目访问 BlazeDS4 服务的操作指南3.5将Flex项目连接到BlazeDS服务1启动数据服务所部署的Tomcat服务器。2在Flash Builder4中，在“包资源管理器”中选择要连接数据服务的Flex项目，然后选择 菜单“数据连接BlazeDS”，如下图所示：3如果Flex项目的“服务器类型”设置不是BlazeDS，会提示如下信息。如果Flex项目的“服务器类型”设置是BlazeDS，直接进入第6步骤。4选择“是”，即可进入Flex项目的属性对话框。5在Flex项目的属性对话框设置如下（与创建Flex项目时设置的效果相同）6如果Flex项目的“服务器类型”是BlazeDS，但没有Remote Development Server，会提示如 下对话框；如果已经设置了Remote Development Server，直接进入第8步。7打开UiBlazeDS/WEB-INF/web.xml文件，确保有内容如下：RDSDispatchServletRDSDispatchServletflex.rds.server.servlet.FrontEndServletuseAppserverSecurityfalse10RDSDispatchServlet/CFIDE/main/ide.cfm并重新启动Tomcat服务器。然后在Flash Builder4中,选择菜单“数据连接BlazeDS”。8这时候将出现如下对话框，点击“确定”按钮即可。9在打开的如图所示的对话框里，给出了UiBlazeDS提供的数据服务的列表，这里称为“目 标”。这里选择要导入的目标（destination），并在“服务详细信息”区域设置服务包和数据类型包（这两个概念可以参见HTTP服务部分）。10点击“完成”即可自动生成相应数据服务的访问代码（AS文件）和返回数据类型代码（AS文件）。对于上述 Flex 项目连接 BlazeDS 数据服务的步骤，也可以采用如下方法：1.启动数据服务所部署的To