在J2EE组件中引用和查找Web服务

1/5/2008来源:Java教程人气:5536


  Web服务客户端
  我们知道,JAX-RPC Web服务客户端有以下几个类型:
  
  基于Stub;
  基于动态代理;
  基于动态调用接口(DII)。
  实际上,上面三种客户端都是使用Service接口来作为它们的创建工厂,Service接口中定义了诸如以下的方法:
  
  例程1 Service接口中的某些方法
  
  Call createCall() ;
  Call createCall(QName portName, String OperationName) ;
  Remote getPort(QName portName, Class serviceEndpointInterface) ;
  Remote getPort(Class serviceEndpointInterface) ;
  
  可以看出,通过Service接口,能够创建Call对象和Remote对象,而Call或者Remote对象正是调用Web服务所需要的。
  
  通过使用Service接口,我们可以在Web服务客户端通过以下的方式来实现调用:
  
  例程2 在客户端调用Web服务
  
      //创建一个ServiceFactory对象。
      ServiceFactory serviceFactory = ServiceFactory.newInstance();
      //通过ServiceFactory对象创建一个调用Web服务的Service对象。
      Service service =
         serviceFactory.createService(taxWsdlUrl,
        new QName(nameSpaceUri, serviceName));
      
      //获得服务端点实例。
       TaxService myPRoxy =
        ( TaxService) service.getPort(new QName(nameSpaceUri, portName),
         TaxService.class);
       //调用Web服务。
      double result=myProxy.calculateTax(5000);
  
  可以看出,在创建Service实例时,需要使用指定的WSDL文件位置、由服务名和名称空间URI组成的有效名称空间,这样使得创建这个实例时变得复杂。JAX-RPC规范推荐使用JNDI来查找服务接口。通过JNDI,使得调用Web服务时就像调用EJB一样简单。只要通过两步就可以获得Web服务接口:
  
  初始化一个名称空间上下文;
  在这个上下文中查找Web服务。
  比如可以按照以下的方式来进行:
  
  例程3 通过JNDI调用Web服务 1
  
  InitialContext ic = new InitialContext ();
  Service abf = (Service)ic.lookup( "java:comp/env/service/AddressBookService");
  
  Web服务引用的名字(AddressBookService)在部署时指定,java:comp/env是JNDI的上下文,service是Web服务的sub context。所以Web服务的JNDI名字一般由以下几个部分组成:
  
  Web服务JNDI=客户端环境上下文+service(sub context)+服务引用名字
  
  我们看到,例程3中查找到的是Service接口,其实在开发中,我们可以采用另一种服务引用形式:直接查找Web服务接口,如例程4所示。
  
  例程4通过JNDI调用Web服务2
  
  Context ic= new InitialContext();
  HelloServiceInterface service =
  (HelloServiceInterface) ic.lookup("java:comp/env/service/HelloService");
  
  在后面的例子可以看到,使用这个方式在调用时又简化了一步。
  
  下面我们通过一个实例来演示怎么在J2EE Web服务的客户端引用Web服务,然后通过JNDI来查找Web服务。
  
  开发、部署一个Web服务
  我们开发一个提供个人所得税计算的Web服务,采用EJB作为服务端点。首先定义一个接口,如例程5所示。
  
  例程5 定义服务接口
  
  package com.hellking.study.webservice.tax;
  
  import java.rmi.Remote;
  import java.rmi.RemoteException;
  
  /**
   *个人所得税Web服务。
   */
  public interface TaxService extends Remote
  {
   public double calculateTax(double salary)throws java.rmi.RemoteException;
  }
  
  它提供的服务方法是计算个人所得税。
  
  下面是EJB部分代码。
  
  (由于EJB的实现代码是特意借朋友的会计书查到的,它是真正意义的业务逻辑代码,适合于现在的个人所得税计算,来之不易,所以贴出来共享之, ^_^)
  
  例程6 EJB部分代码
  
  double base=1200;//个人所得税基数,2003年10起北京为1200元。
  
  //业务逻辑代码,实现服务端点接口中定义的方法。
  public double calculateTax(double salary)
  { 
   return getTax(salary-base);
  
   }
   //下面是具体的计算方法。公式适合于现在的个人所得税制度。
  private double getTax(double tax_salary)
  {
   double tax=0.0d;
   if(0>tax_salary)               tax=0;
   else if(0<tax_salary&&tax_salary <=500)   tax=tax_salary*0.05-0;
   else if(500<tax_salary&&tax_salary<=2000)  tax=tax_salary*0.10-25;
   else if(2000<tax_salary&&tax_salary<=5000)  tax=tax_salary*0.15-125;
   else if(5000<tax_salary&&tax_salary<=20000) tax=tax_salary*0.20-375;
   else if(20000<tax_salary&&tax_salary<=40000) tax=tax_salary*0.25-1375;
   else if(40000<tax_salary&&tax_salary<=60000) tax=tax_salary*0.30-3375;
   else if(60000<tax_salary&&tax_salary<=80000) tax=tax_salary*0.35-6375;
   else if(80000<tax_salary&&tax_salary<=100000) tax=tax_salary*0.40-10375;
   else if(100000<tax_salary)          tax=tax_salary*0.45-15375;
    
   return tax;
  }
  
  下面编写一个配置文件,通过配置文件来生成WSDL到JAX-RPC之间的映射描述符。配置文件如下:
  
  例程7 config.xml
  
  <?xml version="1.0" encoding="UTF-8"?>
  <configuration
   xmlns="http://java.sun.com/xml/ns/jax-rpc/ri/config">
   <service
   name="MyTaxService"
   targetNamespace="urn:Tax"
   typeNamespace="urn:Tax"
   packageName="com.hellking.study.webservice.tax">
   <interface name="com.hellking.study.webservice.tax.TaxService"/>
   </service>
  </configuration>
  
  注重这里Web服务的名字是MyTaxService,名称空间是"urn:Tax",服务接口是"com.hellking.study.webservice.tax.TaxService",这些参数将在后面的编程中使用。通过以下命令来生成一个mapping.xml映射文件:
  
  wscompile -define -d . -nd . -classpath . -mapping mapping.xml config.xml
  
  接下来就可以部署这个Web服务。Web服务部署的细节请参考本系列文章《使用EJB2.1无状态会话Bean作为Web服务端点》一文。假如你不想手工部署,您也可以通过J2EESDK提供的GUI部署工具来部署它。
  
  开发客户端
  这个例子提供了两种不同引用Web服务的方法,如例程8所示。
  
  例程8 在客户端通过JNDI查找Web服务
  
  package com.hellking.study.webservice.tax;
  
  import javax.naming.*;
  import javax.xml.rpc.Service;
  import javax.xml.namespace.QName;
  
  /**
   *Web服务客户演示:通过JNDI来查找Web服务。
   */
  public class TaxBean
  {
  /**
   *第一种查找服务的方法,直接获得MyTaxService接口。
   */
   public double getTax1(double sal)
   {
   double ret=0;
   try
   {
        Context ctx=new InitialContext();
       MyTaxService taxService=(MyTaxService)ctx.lookup("java:comp/env/service/tax");
       //通过MyTaxService获得TaxService服务端点接口。
  TaxService tax=taxService.getTaxServicePort();
        ret=tax.calculateTax(sal);
   }
   catch(Exception e)
   {
   System.out.println(e);
   }
   return ret;
   }
   /**
   *另一种查找服务的方法,获得的是Service接口,然后再通过这个接口来获得具体的服务。
   */
   public double getTax2(double sal)
   {
   double ret=0;
   try
   {
      Context ctx=new InitialContext();
      Service service=(Service)ctx.lookup("java:comp/env/service/tax2");
      QName portQName= new QName("urn:Tax","TaxService");
      //使用这种方式获得服务端点接口时,需要指定名称空间。
  TaxService tax=(TaxService)service.getPort(portQName,
  com.hellking.study.webservice.tax.TaxService.class);
      ret=tax.calculateTax(sal);
   }
   catch(Exception e)
   {
  
   e.printStackTrace();
   System.out.println(e);
   }
   return ret;
   }
  }
  
  可以看出,第一