在开发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(); } } |
延伸阅读
文章来源于领测软件测试网 https://www.ltesting.net/