在開發UDDI的客戶端程序時,我們一般考慮的都是IBM提供的UDDI4J,但不知道大家注意到沒有,在BEA的WebLogic中也提供了一個非常方便的UDDI Client API。只是它被包含在weblogic.jar文件中而沒有單獨發布。WebLogic UDDI Client API的結構完全遵循了UDDI的體系結構,所以,通過對這套API類庫的學習和實踐,相信也有助于我們更好地理解UDDI的體系架構。
Inquiry和Publish的基礎
對UDDI注冊中心的操作不外乎兩大類:查詢和發布(刪除)。所以WebLogic定義了二個類,分別對應查詢與發布的操作:Inquiry類用于查詢,Publish類用于發布。這兩個類位于weblogic.uddi.client.service包里,它們都繼承于UDDIService類。在UDDIService類里定義了一個URL屬性,保存著查詢或發布的URL地址。
Inquiry和Publish類通過父類UDDIService的setURL方法來設置它們的查詢或發布地址。
查詢 Inquiry
向UDDI注冊中心查詢的目標有四類:商業實體(BusinessEntity)、商業服務(BusinessService)、綁定模板信息(BindingTemplate)和tModel。我們來看Inquiry類里的方法,不難發現,這四種目標的查詢,正對應Inquiry類里的四個find方法:
它包括兩類方法find和get,其中find類方法用于查找與發現,而get類方法用于獲取詳細信息。
四個find方法對應四種查詢,五個get方法對應UDDI定義的四個數據模型(商業實體對應兩個方法)。
一般查詢的步驟是先通過find方法得到數據模型的基本信息,以及它的一個唯一標識Key。然后就可以根據這個Key調用get方法獲取這個模型的詳細信息。
商業實體(BusinessEntity)查詢
通過Inquiry類定義的findBusiness方法結合getBusinessDetail方法可以在UDDI注冊中心數據庫中查詢商業實體的各種信息。
findBusiness方法要求一個FindBusiness對象作為參數,用來定義查詢的條件。
構建FindBusiness對象并設置它的一些屬性,比如setName(new Name(“IBM”),查詢以IBM命名的商業實體。
查詢結果可以得到所有滿足查詢條件的BusinessInfo對象的Vector。
BusinessInfo定義了商業實體的基本信息,比較重要的是Name和BusinessKey。
getBusinessDetail方法根據BusinessKey的值可以得到BusinessEntity對象的Vector。
在BusinessEntity對象中定義了多個商業實體的詳細信息,包括Contact、Operator、DiscoveryURL、Description,以及Category和Identifier信息。
下面是一段簡化的代碼,演示了如何根據參數查詢BusinessEntity的信息。
void echoBusiness(String parm){ try { FindBusiness fb = new FindBusiness(); fb.setName(new Name(parm)); Vector vBusinessInfo = finder.findBusiness(fb).getBusinessInfos().getBusinessInfoVector(); for(int i=0;i BusinessInfo bInfo = (BusinessInfo)vBusinessInfo.elementAt(i); log(bInfo.getName().getValue()+" ["+bInfo.getBusinessKey()+"]"); GetBusinessDetail gbt = new GetBusinessDetail(); gbt.addBusinessKey(bInfo.getBusinessKey()); Vector vBusinessEntity = finder.getBusinessDetail(gbt).getBusinessEntityVector(); for(int j=0;j BusinessEntity bEntity = (BusinessEntity)vBusinessEntity.elementAt(j); log( "authorizedname is "+bEntity.getAuthorizedName() +" operator is "+bEntity.getOperator()); } } } catch (Exception ex) { ex.printStackTrace(); } } |
雖然在Inquiry類中定義了findService方法,但是一般情況下可以根據查詢到的BusinessInfo對象來進一步查詢此BusinessEntity下屬的BusinessService。注意到在BusinessInfo類中有一個方法getServiceInfos,它可以幫助我們得到此商業實體所提供的商業服務。
從BusinessInfo對象可以獲取此商業實體下所有的ServiceInfo對象的集合。ServiceInfo對象定義了商業服務的基本信息,比較重要的有Name和ServiceKey。
類似地,用Inquiry類提供的getServiceDetail方法可以得到商業服務的詳細信息,即BusinessService類。它包括商業服務的多種有用信息,如:Description,Category等。
進一步,根據BusinessService類定義的getBindingTemplates方法,又可以取得此服務下的所有綁定模板信息。
在BindingTemplate對象中定義了綁定模板的一些重要屬性,如:AccessPoint等。
再進一步,可以從BindingTemplate中提供的方法getTModelInstanceDetails中獲取tModel Instance的詳細信息,即InstanceDetails對象。包括有OverviewDoc。
從OverviewDoc可以得到OverviewURL,這就是我們在發布WebService時的WSDL的URL地址。
下面,筆者也給出一段代碼演示了這個查詢過程:
void echoBusiness2(String parm){ try { file://查詢BusinessInfo FindBusiness fb = new FindBusiness(); fb.setName(new Name(parm)); Vector vBusinessInfo =finder.findBusiness(fb).getBusinessInfos().getBusinessInfoVector(); for(int i=0;i BusinessInfo bInfo = (BusinessInfo)vBusinessInfo.elementAt(i); log(bInfo.getName().getValue()+" ["+bInfo.getBusinessKey()+"]"); file://查詢ServiceInfo Vector vServiceInfo = bInfo.getServiceInfos().getServiceInfoVector(); for(int j=0;j ServiceInfo sInfo = (ServiceInfo)vServiceInfo.elementAt(j); log(sInfo.getName().getValue()+"["+sInfo.getServiceKey()+"]"); file://查詢BusinessService GetServiceDetail gsd = new GetServiceDetail(); gsd.addServiceKey(sInfo.getServiceKey()); Vector vBusinessService = finder.getServiceDetail(gsd).getBusinessServiceVector(); for(int k=0;k BusinessService bService = (BusinessService)vBusinessService.elementAt(k); file://查詢BindingTemplate Vector vBindingTemplate = bService.getBindingTemplates().getBindingTemplateVector(); for(int p=0;p BindingTemplate bTemplate = (BindingTemplate)vBindingTemplate.elementAt(p); log(bTemplate.getAccessPoint().getValue()); file://查詢TModelInstanceInfo Vector vTModelInstanceInfo = bTemplate.getTModelInstanceDetails().getTModelInstanceInfoVector(); for(int q=0;q TModelInstanceInfo tmInstanceInfo = (TModelInstanceInfo)vTModelInstanceInfo.elementAt(q); file://直接顯示了InstanceDetails的OverviewDoc的信息 log(tmInstanceInfo.getInstanceDetails().getOverviewDoc().getOverviewURL().getValue()); } } } } } } catch (Exception ex) { ex.printStackTrace(); } } |
這段代碼比較長,嵌套很多,但是理清了頭緒相信讀者還是能夠看明白的。無非就是一層層查詢:從BusinessInfo -> ServiceInfo -> BusinessService -> BindingTemplate -> TModelInstanceInfo -> InstanceDetail,最后顯示它的OverviewDoc的URL值。
查詢TModel
TModel的查詢有兩條路,一條是上面的從BusinessInfo開始的層級查詢,最終得到TModel的InstaceDetail對象。另一條路則也是從Inquiry開始的,用find方法查詢全部的tModel數據模型。
先從Inquiry對象的findTModel方法查詢全部合乎條件的tModel對象,同樣要求有輸入參數FindTModel對象定義查詢條件。
然后,同樣用getTModelDetail方法取得tModel對象的詳細信息,即TModel類。它包括了tModel的主要屬性,如Category,Identifier,Operator,OverviewDoc等等。
下面這段代碼演示了這種查詢過程:
void echoTModel(String param){ try { FindTModel ftm = new FindTModel(); ftm.setName(new Name(param)); Vector vTModelInfo = finder.findTModel(ftm).getTModelInfos().getTModelInfoVector(); for(int j=0;j TModelInfo tInfo = (TModelInfo)vTModelInfo.elementAt(j); log(tInfo.getName().getValue()+"["+tInfo.getTModelKey()+"]"); GetTModelDetail gtd = new GetTModelDetail(); gtd.addTModelKey(tInfo.getTModelKey()); Vector vTModel = finder.getTModelDetail(gtd).getTModelVector(); for(int i=0;i TModel tModel = (TModel)vTModel.elementAt(i); log(tModel.getName().getValue()+" "+tModel.getAuthorizedName()); } } } catch (Exception ex) { ex.printStackTrace(); } } |
延伸閱讀
文章來源于領測軟件測試網 http://www.kjueaiud.com/