WebLogicUDDIClientAPI实例学习(一)

 　　在开发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  

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  

log( "authorizedname is "+bEntity.getAuthorizedName()

+" operator is "+bEntity.getOperator());

}

}

}

catch (Exception ex) {

ex.printStackTrace();

}

} ||| 

　　虽然在Inquiry类中定义了findService方法，但是一般情况下可以根据查询到的BusinessInfo对象来进一步查询此BusinessEntity下属的BusinessService。注意到在BusinessInfo类中有一个方法getServiceInfos，它可以帮助我们得到此商业实体所提供的商业服务。 

 

　　类似地，用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  

　　　log(bInfo.getName().getValue()+" ["+bInfo.getBusinessKey()+"]");

　　　file://查询ServiceInfo

　　　Vector vServiceInfo = bInfo.getServiceInfos().getServiceInfoVector();

　　　for(int j=0;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  

　　　file://查询BindingTemplate

　　　Vector VBindingTemplate =

　　　　　bService.getBindingTemplates().getBindingTemplateVector();

　　　for(int p=0;p  

　　　　(BindingTemplate)VBindingTemplate.elementAt(p);

　　　　log(bTemplate.getACCESSPoint().getValue());

　　　　file://查询TModelInstanceInfo

　　　　Vector vTModelInstanceInfo = 

　　　　　bTemplate.getTModelInstanceDetails().getTModelInstanceInfoVector();

　　　for(int q=0;q  

　　　　(TModelInstanceInfo)vTModelInstanceInfo.elementAt(q);

　　　　file://直接显示了InstanceDetails的OverviewDoc的信息

　　log(tmInstanceInfo.getInstanceDetails().getOverviewDoc().getOverviewURL().getValue());

　　　}

　　}

　　　}

　　}

　}

}

catch (Exception ex) {

ex.printStackTrace();

}

}

||| 
 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  

　　　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  

　　log(tModel.getName().getValue()+" "+tModel.getAuthorizedName());

　　　}

　　}

　}

　catch (Exception ex) {

　　ex.printStackTrace();

　}