EAS-BOS架构-模型与架构-WebService使用指南

WebService使用指南1.BOSWebService的范围BOSWebService主要实现了将实体和Façade发布为标准的WebService提供给不同的客户端调用。目前只支持将实体和Façade两种对象发布为WebService。BOSWebService的发布流程如下：2.在BOSStudio中发布WebService2.1.发布WebService运行BOSStudio，打开“包分类”视图，在其中选中要发布WebService的实体或Façade对象（可同时选中多个），点击鼠标右键，在弹出菜单中选择“发布WebService”,将弹出“发布WebService”向导：选择实体或Façade对象下要发布的方法，手工输入或者点击“浏览”按钮来指定发布生成代码存放的目录，可以同时勾中“追加到配置文件”。这样BOSStudio将会根据选中的对象和要发布的方法生成WebService代码。2.2.编辑WebService配置文件在“包分类”视图中，选择要编辑其配置文件的解决方案，点击工具栏上的“编辑WebService配置文件”按钮，将会弹出配置文件编辑向导：在其间，可以增加或删除要发布的对象（方法），选择好要发布的对象（方法）后，点击“完成”按钮，即可完成对配置文件的编辑。配置文件位于解决方案的根目录下。3.日构建自动发布WebService在编辑好WebServiceDeploy.xml文件的提前下，在日构建的Ant脚本中调用com.kingdee.bos.tool.Generator类的main方法即可自动发布WebService，其参数有两种：1）传入一个参数”-h”或”-help”(不区分大小写)；2)传入四个参数(配置文件WebServiceDeploy.xml所在目录全路径名,需要产生WebService的元数据目录全路径名,放置生成的相关Java文件的目录全路径名放置生成的相关WSDL文件的目录全路径名)。对于第一种参数，将得到com.kingdee.bos.tool.Generator.main(String[])方法的详细用法。对于第二种参数，将根据指定的配置文件和元数据生成WebService相关的Java代码与配置文件。4.WebServiceDeploy.xml文件格式WebServiceDeploy.xml文件的格式如下定义，其中“[”与“]”之间的字符需根据实际需要而适当更改。<?xmlversion="1.0"encoding="UTF-8"?><deployObjects><deployObject><type>[entity或Façade]</type><name>[实体或Façade名称]</name><package>[实体或Façade的包名]</package><deployMethods><deployMethodid="[要发布成WebService的方法InnerID]"/><deployMethodid="[要发布成WebService的方法InnerID]"/>……..</deployMethods></deployObject><deployObjects>5.WebService部署方式5.1.相关依赖BOSWebService的部署依赖Apache的axis第三方组件，此组件经过BOS的封装，可以从BOSWEBService项目中下载webapp目录进行部署。5.2.部署步骤发布出来的WebService可以部署在标准的J2EE容器中，下面以Apusic3.1为例说明WebService的部署步骤。其他WEB容器的部署步骤类似。1.创建一个webapp（如果已经存在webapp则跳过这一步）将BOSWebService项目（在CVS中，Host:Repositorypath:i:/bos4.1)下的webapp目录copy一份至%APUSIC_HOME%/applications目录下，并将目录改名（例：bosws.war）。编辑%APUSIC_HOME%/config目录下的server.xml，加入一行：<applicationname="bosws.war"base="W:\apusic\applications\bosws.war"start="auto"/>2.将生成的WebSerivce的java代码编译为class或打成jar包，放在webapp目录下此例子中，class文件放在%APUSIC_HOME%/applications/bosws.war/WEB-INF/classes目录下。3.启动应用服务器启动apusic4.运行%APUSIC_HOME%/applications/bosws.war/WEB-INF目录下的deploy.bat，根据产生的wsdd文件部署webservicedeploy.bat命令接受两个参数，分别是“wsdd文件名webapp”deploy.batVoucher.wsddbosws例：%APUSIC_HOME%/applications/bosws.war/WEB-INF/deploy.batVoucher.wsddbosws是将Voucher这个WebService部署到bosws这个web应用下面。5.访问http://hostname:port/bosws/services，如果可看到刚才发布的webservice，则表明部署成功。5.3.相关配置BOSWEBService的配置文件在webapp/WEB-INF/perties中，目前包括两项配置1.srvurl表示rpc服务器的url，默认为：tcp://localhost2.metadatapath表示元数据的路径，默认为：W:/eas/deploy/apusic/metas6.约束及注意事项注意：BOSWebService的发布有以下约束1．所有要发布的实体的属性的数据类型都必须为标准数据类型或在BOSStudio的数据类型下拉列表框中可以选取的类型。2．所有实体或Façade的方法的参数和返回值类型都必须为标准数据类型或在BOSStudio的数据类型下拉列表框中可以选取的类型。3．axis.jar这个文件是经过修改重新编译的，不能够使用apache自带的替换。4．Façade类型发布为webservice时候，方法或返回值的数据类型不支持IobjectPK，因为无法从元数据获取IOBjectPK所对应的实体，无法构造IobjectPK的实例。7.客户端调用示例客户端通过浏览器访问WebService服务器，从而可以得到相应的WSDL文件，可以用已有的工具由WSDL文件生成客户端，例如使用Eclipse3.1可以生成客户端：新建一个java工程，将从服务器端得到的WSDL文件复制到该工程的根目录下，切换到“java透视图”，在“PackageExplorer”视图下选中WSDL文件，点击鼠标右键，选择“WebServices”-“GenerateClient”菜单，将弹出生成客户端向导照向导提示，一步一步来就可以生成客户端。如果要生成C#客户端，可以先安装MSStudio环境，设定好相应的path环境变量，在命令行里运行wsdlXXX.wsdl，即可生成C#客户端，然后再到MSStudio里建一个相应的工程，将刚刚生成的客户端代码导入到该工程中即可。，依8.其他说明8.1.对于axis源码的调整Axis的servlet中，org.apache.axis.transport.http.AxisServlet是较为核心的一个Servlet，改Servl