WebLogic UDDI Client API實例學習(一)

在開發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();
}
}

BusinessService和BindingTemplate的查詢

雖然在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();
　 }
}