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

　　Web服务客户端

　　我们知道，JAX-RPC Web服务客户端有以下几个类型：

　　基于Stub；

　　基于动态代理；

　　基于动态调用接口（DII）。

　　实际上，上面三种客户
定义了诸如以下的方法：

端都是使用Service接口来作为

它们的创建工厂，Service接口中

　　例程1 Service接口中的某些方法

　　Call createCall() ;

　　Call createCall(QNam

e portName, String operation

Name)　;

　　Remote getPort(QName

portName, Class serviceEndp

ointInterface)　;

　　Remote getPort(Class serviceEndp

ointInterface)　;

　　可以看出，通过Service接口，能够
正是调用Web服务所需要的。

创建Call对象和Remote对象，而Call或者Remote对象

　　通过使用Service接口

，我们可以在Web服务客户端通

过以下的方式来实现调用：

　　例程2 在客户端调用Web服务

　　　　　　　　//创建一个ServiceFactory对象。

　　　　　　　　ServiceFactory servi

ceFactory =　ServiceFactory.newInstance();

　　　　　　　　//通过Se

rviceFactory对象创建一个调用

Web服务的Service对象。

　　　　　　　　Service service =

rviceFactory.createService(t

axWsdlUrl,

　　　　　　　　　　new

QName(nameSpaceUri, serviceN

ame));

　　　　　　　　//获得服务端点实例。

　　　　　　　　 TaxService myProxy =

　　　　　　　　　 ( TaxService) ser
portName),

vice.getPort(new QName(nameSpaceUri,

　　　　　　　　　　 TaxService.class);

　　　　　　　　 //调用Web服务。

　　　　　　　　double result=myProx

y.calculateTax(5000);

　　可以看出，在创建Serv
URI组成的有效名称空间，
查找服务接口。通过JNDI，
得Web服务接口：

ice实例时，需要使用指定的WSD
这样使得创建这个实例时变得复
使得调用Web服务时就像调用EJB

L文件位置、由服务名和名称空间
杂。JAX-RPC规范推荐使用JNDI来
一样简单。只要通过两步就可以获

　　初始化一个名称空间上下文；

　　在这个上下文中查找Web服务。

　　比如可以按照以下的方式来进行：

　　例程3 通过JNDI调用Web服务 1

　　InitialContext ic =

new InitialContext ();

　　Service abf = (Service)ic.lookup

( "java:comp/env/service/AddressBookService");

　　Web服务引用的名字（A
下文，service是Web服务的

ddressBookService）在部署时
sub context。所以Web服务的JN

指定，java:comp/env是JNDI的上
DI名字一般由以下几个部分组成：

　　Web服务JNDI＝客户端

环境上下文＋service(sub cont

ext)＋服务引用名字

　　我们看到，例程3中查找到的是Servi
用形式：直接查找Web服务接口，如例程4

ce接口，其实在开发中，我们可以采用另一种服务引
所示。

　　例程4通过JNDI调用Web服务2

　　Context ic= new InitialContext();

　　HelloServiceInterface service =

　　　　(HelloServiceInt

erface) ic.lookup("java:comp

/env/service/HelloService");

　　在后面的例子可以看到，使用这个方式在调用时又简化了一步。

　　下面我们通过一个实例来演示怎么在
来查找Web服务。

J2EE Web服务的客户端引用Web服务，然后通过JNDI

　　开发、部署一个Web服务

　　我们开发一个提供个人
，如例程5所示。

所得税计算的Web服务，采用EJB

作为服务端点。首先定义一个接口

　　例程5 定义服务接口

　　package com.hellking

.study.webservice.tax;

　　import java.rmi.Remote;

　　import java.rmi.RemoteException;

　　/**

　　 *个人所得税Web服务。

　　public interface TaxService exte

nds Remote

　　{

　　 public double calcu

lateTax(double salary)throws

java.rmi.RemoteException;

　　}

　　它提供的服务方法是计算个人所得税。

　　下面是EJB部分代码。

　　（由于EJB的实现代码是特意借朋友
合于现在的个人所得税计算，来之不易，

的会计书查到的，它是真正意义的业务逻辑代码，适
所以贴出来共享之， ^_^）

　　例程6 EJB部分代码

　　double base=1200;//个人所得税基

数，2003年10起北京为1200元。

　　//业务逻辑代码，实现服务端点接口中定义的方法。

　　public double calcul

ateTax(double salary)

　　{　

　　　　 return getTax(salary-base);

　　 }

　　　//下面是具体的计算方法。公式适合于现在的个人所得税制度。

　　　 private double ge

tTax(double tax_salary)

　　　　{

　　　　 double tax=0.0d;

　　　　 if(0>tax_salary)　　　　　　　　　　　　　　 tax=0;

　　　　 else if(0<tax_salary&&ta

x_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<
salary*0.15-125;

;tax_salary&&tax_salary<=

5000)　 tax=tax_

　　　　 else if(5000<
salary*0.20-375;

;tax_salary&&tax_salary<=

20000)　tax=tax_

　　　　 else if(20000&l
_salary*0.25-1375;

t;tax_salary&&tax_salary<

=40000)　tax=tax

　　　　 else if(40000&l
_salary*0.30-3375;

t;tax_salary&&tax_salary<

=60000)　tax=tax

　　　　 else if(60000&l
_salary*0.35-6375;

t;tax_salary&&tax_salary<

=80000)　tax=tax

　　　　 else if(80000<tax_salary
tax=tax_salary*0.40-10375;

&&tax_salary<=100000)

　　　　 else if(100000&
;

lt;tax_salary)　　　　　　　

　　 tax=tax_salary*0.45-15375

　　　　 return tax;

　　　　}

　　下面编写一个配置文件
件如下：

，通过配置文件来生成WSDL到JA

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

　　　</service>

　　</configuration>

　　注意这里Web服务的名字是MyTaxServ
"com.hellking.study.webservice.tax.T
以下命令来生成一个mapping.xml映射文

ice，名称空间是"urn:Tax"，服务接口是
axService"，这些参数将在后面的编程中使用。通过
件：

　　wscompile -define -d

. -nd .　-classpath . -mapp

ing mapping.xml config.xml

　　接下来就可以部署这个Web服务。Web
态会话Bean作为Web服务端点》一文。如
部署工具来部署它。

服务部署的细节请参考本系列文章《使用EJB2.1无状
果你不想手工部署，您也可以通过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 c

tx=new InitialContext();

　　　　　　MyTaxService taxServic
up("java:comp/env/service/tax");

e=(MyTaxService)ctx.look

　　　　　　//通过MyTa

xService获得TaxService服务端

点接口。

　　TaxService tax=taxService.getTax

ServicePort();

　　　　　　 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 servi

ce=(Service)ctx.lookup("java

:comp/env/service/tax2");

　　　　 QName portQName= new QNam

e("urn:Tax","TaxService");

　　　　 //使用这种方式获得服务端点接口时，需要指定名称空间。

　　TaxService tax=(TaxService)servi

ce.getPort(portQName,

　　com.hellking.study.webservice.ta

x.TaxService.class);

　　　　 ret=tax.calculateTax(sal);

　　 }

　　 catch(Exception e)

　　 {

　　 e.printStackTrace();

　　 System.out.println(e);

　　 }

　　 return ret;

　　 }

　　可以看出，第一种方法查找的就是My
口。具体使用那种方式，是和部署描述相

TaxService接口，而第二种方法查找的是Service接
关的，在后面将介绍部署的差别。

　　最后开发一个JSP来作为测试客户端
。

，这个JSP通过JavaBean调用Web服务，如例程9所示

　　例程9 测试的JSP

　　<%@ page contentType="text/html;charset=gb2312"%>

　　<%@ page import="com.hellking.study.webservice.tax.*,javax.naming.*"%>

　　<jsp:useBean id="tax" class="com.hellking.study.webservice.tax.TaxBean"/>

　　double salary=0;

　　try{

　　salary=Double.parseD

ouble((String)request.getPar

ameter("salary"));

　　}

　　catch(Exception e){}

　　 <html>

　　 <head>

　　 <title>通过JNDI调用Web服务。</title>

　　 </head>

　　 <body>

　　 <h1>Web服务----适合北京地区，2003年</h1>

　　 out.println("个人所得税是：<br>");

　　　　 out.println(tax.getTax1(salary));

　　　　 out.println("<br>另一种方法调用Web服务，个人所得税是：<br>");

　　　　 out.println(tax.getTax2(salary));

　　 <hr>

　　 </tr>

　　 </tr>

　　 </table>

　　 </form>

　　 </div>

　　 <hr>

　　 </body>

　　</html>

　　最后来看具体的部署描述符。

　　在客户端的描述中引用Web服务

　　打开J2EESDK部署工具
$J2EESDK/AppServer/bin/d
。在部署时，Web应用将包

（执行％J2EESDK_HOME％AppS
eploytool.sh），新建一个Web
含如图1所示的文件。

erverbindeploytool.bat或者
应用，把上面的测试JSP添加进来

　　图1 Web应用中包含的文件

　　点击这个Web应用，在右边再点击【W
现在可以增加Web服务引用了。增加一个

eb services Refs】选项卡，再点击【Add】按钮。
名称为service/tax的Web服务引用，如图2所示。

　　图2 增加Web服务引用

　　注意上面的Service接口是com.hellk
击【Container Managed Ports】，如图3

ing.study.webservice.tax.MyTaxService。然后点
所示。

　　图3 增加容器管理端点

　　到此，一种引用Web服务的方式就完成了。

　　下面看服务接口直接是Service的情

况，再增加一个Web服务引用，如图4所示。

　　图4 增加另一种服务引用

　　注意上面Service Interface是javax
）和Local Part（MyTaxService）。同样
口名称和端口组件名称和图3一致。

.xml.rpc.Service，并且指定了名称空间（urn：Tax
，按照图3所示方法增加一个容器管理端点，端点接

　　经过了上面的部署，实际上在web.xml中生成了以下的部署描述符。

　　例程 10 生成的部署描述符

　　<service-ref>

　　　　<service-ref-name>service/tax</service-ref-name>

　　　　<service-interface>com.hellking.study.webservice.tax.MyTaxService</service-interface>

　　　　<wsdl-file>WEB-INF/wsdl/MyTaxService.wsdl</wsdl-file>

　　　　<jaxrpc-mapping-file>mapping.xml</jaxrpc-mapping-file>

　　　　<port-component-ref>

　　　　　<service-endpoint-interface>com.hellking.study.webservice.tax.TaxService

　　</service-endpoint-interface>

　　　　　<port-component-link>TaxServicePort</port-component-link>

　　　　</port-component-ref>

　　　</service-ref>

　　　<service-ref>

　　　　<service-ref-name>service/tax2</service-ref-name>

　　　　<service-interface>javax.xml.rpc.Service</service-interface>

　　　　<wsdl-file>WEB-INF/wsdl/MyTaxService.wsdl</wsdl-file>

　　　　<jaxrpc-mapping-file>mapping.xml</jaxrpc-mapping-file>

　　　 <service-qname xmlns:service-qname_ns__="urn:Tax">service-qname_ns__:MyTaxService

　　</service-qname>

　　　　<port-component-ref>

　　　　　<service-endpoint-interface>com.hellking.study.webservice.tax.TaxService

　　</service-endpoint-interface>

　　　　　<port-component-link>TaxServicePort</port-component-link>

　　　　</port-component-ref>

　　　</service-ref>

　　下面解释一下这个描述付。对Web服务的引用通过<service-ref>元素来指定；<service-ref-name>就是在客户端编程中要使用的引用名字；<service-interface>就是服务接口，有两种，分别是javax.xml.rpc.Service和com.hellking.study.webservice.tax.MyTaxService；<service-qname>是服务的有效名称空间，如果直接使用com.hellking.study.webservice.tax.MyTaxService作为服务接口，就不需要指定<service-qname>元素；<port-component-ref>就是对服务端点的引用，它引用的是webservices.xml中定义<port-component>元素。<port-component-link>用来链接到webservices.xml中指定的<port-component-name>，并且两者的名字是一致的。

　　调用测试

　　部署完成后，在浏览器里输入：

　　http://127.0.0.1:8080/tax/tax

　　将出现如图5所示的界面。

　　总结

　　通过上面的介绍，相信
使用JNDI，在J2EE组件中调
类的概念就能调用Web服务

读者对Web服务的引用已经有了
用Web服务就像面向对象编程一
。

全面的认识。我们可以看到，通过
样，甚至可以不理解WSDL、XML之