EAS-BOS架構(gòu)-模型與架構(gòu)-WebService使用指南

WebService使用指南1.BOSWebService的范圍BOSWebService主要實(shí)現(xiàn)了將實(shí)體和Fa?ade發(fā)布為標(biāo)準(zhǔn)的WebService提供給不同的客戶端調(diào)用。目前只支持將實(shí)體和Fa?ade兩種對(duì)象發(fā)布為WebService。BOSWebService的發(fā)布流程如下：2.在BOSStudio中發(fā)布WebService2.1.發(fā)布WebService運(yùn)行BOSStudio，打開(kāi)“包分類”視圖，在其中選中要發(fā)布WebService的實(shí)體或Fa?ade對(duì)象（可同時(shí)選中多個(gè)），點(diǎn)擊鼠標(biāo)右鍵，在彈出菜單中選擇“發(fā)布WebService”,將彈出“發(fā)布WebService”向?qū)В哼x擇實(shí)體或Fa?ade對(duì)象下要發(fā)布的方法，手工輸入或者點(diǎn)擊“瀏覽”按鈕來(lái)指定發(fā)布生成代碼存放的目錄，可以同時(shí)勾中“追加到配置文件”。這樣BOSStudio將會(huì)根據(jù)選中的對(duì)象和要發(fā)布的方法生成WebService代碼。2.2.編輯WebService配置文件在“包分類”視圖中，選擇要編輯其配置文件的解決方案，點(diǎn)擊工具欄上的“編輯WebService配置文件”按鈕，將會(huì)彈出配置文件編輯向?qū)В涸谄溟g，可以增加或刪除要發(fā)布的對(duì)象（方法），選擇好要發(fā)布的對(duì)象（方法）后，點(diǎn)擊“完成”按鈕，即可完成對(duì)配置文件的編輯。配置文件位于解決方案的根目錄下。3.日構(gòu)建自動(dòng)發(fā)布WebService在編輯好WebServiceDeploy.xml文件的提前下，在日構(gòu)建的Ant腳本中調(diào)用com.kingdee.bos.tool.Generator類的main方法即可自動(dòng)發(fā)布WebService，其參數(shù)有兩種：1）傳入一個(gè)參數(shù)”-h”或”-help”(不區(qū)分大小寫)；2)傳入四個(gè)參數(shù)(配置文件WebServiceDeploy.xml所在目錄全路徑名,需要產(chǎn)生WebService的元數(shù)據(jù)目錄全路徑名,放置生成的相關(guān)Java文件的目錄全路徑名放置生成的相關(guān)WSDL文件的目錄全路徑名)。對(duì)于第一種參數(shù)，將得到com.kingdee.bos.tool.Generator.main(String[])方法的詳細(xì)用法。對(duì)于第二種參數(shù)，將根據(jù)指定的配置文件和元數(shù)據(jù)生成WebService相關(guān)的Java代碼與配置文件。4.WebServiceDeploy.xml文件格式WebServiceDeploy.xml文件的格式如下定義，其中“[”與“]”之間的字符需根據(jù)實(shí)際需要而適當(dāng)更改。<?xmlversion="1.0"encoding="UTF-8"?><deployObjects><deployObject><type>[entity或Fa?ade]</type><name>[實(shí)體或Fa?ade名稱]</name><package>[實(shí)體或Fa?ade的包名]</package><deployMethods><deployMethodid="[要發(fā)布成WebService的方法InnerID]"/><deployMethodid="[要發(fā)布成WebService的方法InnerID]"/>……..</deployMethods></deployObject><deployObjects>5.WebService部署方式5.1.相關(guān)依賴BOSWebService的部署依賴Apache的axis第三方組件，此組件經(jīng)過(guò)BOS的封裝，可以從BOSWEBService項(xiàng)目中下載webapp目錄進(jìn)行部署。5.2.部署步驟發(fā)布出來(lái)的WebService可以部署在標(biāo)準(zhǔn)的J2EE容器中，下面以Apusic3.1為例說(shuō)明WebService的部署步驟。其他WEB容器的部署步驟類似。1.創(chuàng)建一個(gè)webapp（如果已經(jīng)存在webapp則跳過(guò)這一步）將BOSWebService項(xiàng)目（在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.啟動(dòng)應(yīng)用服務(wù)器啟動(dòng)apusic4.運(yùn)行%APUSIC_HOME%/applications/bosws.war/WEB-INF目錄下的deploy.bat，根據(jù)產(chǎn)生的wsdd文件部署webservicedeploy.bat命令接受兩個(gè)參數(shù)，分別是“wsdd文件名webapp”deploy.batVoucher.wsddbosws例：%APUSIC_HOME%/applications/bosws.war/WEB-INF/deploy.batVoucher.wsddbosws是將Voucher這個(gè)WebService部署到bosws這個(gè)web應(yīng)用下面。5.訪問(wèn)http://hostname:port/bosws/services，如果可看到剛才發(fā)布的webservice，則表明部署成功。5.3.相關(guān)配置BOSWEBService的配置文件在webapp/WEB-INF/perties中，目前包括兩項(xiàng)配置1.srvurl表示rpc服務(wù)器的url，默認(rèn)為：tcp://localhost2.metadatapath表示元數(shù)據(jù)的路徑，默認(rèn)為：W:/eas/deploy/apusic/metas6.約束及注意事項(xiàng)注意：BOSWebService的發(fā)布有以下約束1．所有要發(fā)布的實(shí)體的屬性的數(shù)據(jù)類型都必須為標(biāo)準(zhǔn)數(shù)據(jù)類型或在BOSStudio的數(shù)據(jù)類型下拉列表框中可以選取的類型。2．所有實(shí)體或Fa?ade的方法的參數(shù)和返回值類型都必須為標(biāo)準(zhǔn)數(shù)據(jù)類型或在BOSStudio的數(shù)據(jù)類型下拉列表框中可以選取的類型。3．a(chǎn)xis.jar這個(gè)文件是經(jīng)過(guò)修改重新編譯的，不能夠使用apache自帶的替換。4．Fa?ade類型發(fā)布為webservice時(shí)候，方法或返回值的數(shù)據(jù)類型不支持IobjectPK，因?yàn)闊o(wú)法從元數(shù)據(jù)獲取IOBjectPK所對(duì)應(yīng)的實(shí)體，無(wú)法構(gòu)造IobjectPK的實(shí)例。7.客戶端調(diào)用示例客戶端通過(guò)瀏覽器訪問(wèn)WebService服務(wù)器，從而可以得到相應(yīng)的WSDL文件，可以用已有的工具由WSDL文件生成客戶端，例如使用Eclipse3.1可以生成客戶端：新建一個(gè)java工程，將從服務(wù)器端得到的WSDL文件復(fù)制到該工程的根目錄下，切換到“java透視圖”，在“PackageExplorer”視圖下選中WSDL文件，點(diǎn)擊鼠標(biāo)右鍵，選擇“WebServices”-“GenerateClient”菜單，將彈出生成客戶端向?qū)д障驅(qū)崾?，一步一步?lái)就可以生成客戶端。如果要生成C#客戶端，可以先安裝MSStudio環(huán)境，設(shè)定好相應(yīng)的path環(huán)境變量，在命令行里運(yùn)行wsdlXXX.wsdl，即可生成C#客戶端，然后再到MSStudio里建一個(gè)相應(yīng)的工程，將剛剛生成的客戶端代碼導(dǎo)入到該工程中即可。，依8.其他說(shuō)明8.1.對(duì)于axis源碼的調(diào)整Axis的servlet中，org.apache.axis.transport.http.AxisServlet是較為核心的一個(gè)Servlet，改Servl