怎样在J2EE组件中引用和查找Web服务-JSP教程,J2EE/EJB/服务器

本文将讨论怎么在j2ee组件中引用web服务、并且通过jndi来查找web服务。在内容组织上，首先把一个ejb2.1无状态会话bean发布成web服务，然后开发基于jsp的web服务客户端，最后着重介绍怎么在jsp的部署时引用web服务，并且讨论怎么通过jndi来查找和调用web服务。

阅读本文前您需要以下的知识和工具：

j2ee1.4 sdk，并且会初步使用；

掌握基本的jax-rpc web服务开发技能；

了解jndi的基本知识，能够使用它进行简单编程；

一般的java编程知识。

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

 

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

例程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服务的方法，如例程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;
}
}
 

 

可以看出，第一种方法查找的就是mytaxservice接口，而第二种方法查找的是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.parsedouble
((string)request.getparameter
(“salary”));
}
catch(exception e){}
%>
<html>
<head>
<title>通过jndi调用web服务。</title>
</head>
<body>
<div align=”center”>
<h1>web服务—-适合北京地区，
2003年</h1>
<%
out.println(“个人所得税是：<br>”);
out.println(tax.gettax1(salary));
out.println(“<br>另一种方法调用web服务，
个人所得税是：<br>”);
out.println(tax.gettax2(salary));
%>
<hr>
<form action=”/tax/tax”>
<table border=1>
<tr bgcolor=654321>
<td >输入工资</td>
<td><input type=text name=salary></td>
</tr>
<tr><td colspan=2><input
type=submit value=查看></td>
</tr>
</table>
</form>
</div>
<hr>
</body>
</html>
 

 

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

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

打开j2eesdk部署工具（执行％j2eesdk_home％\\appserver\\bin\\deploytool.bat或者$j2eesdk/appserver/bin/deploytool.sh），新建一个web应用，把上面的测试jsp添加进来。在部署时，web应用将包含如图1所示的文件。

 

 

图1 web应用中包含的文件

点击这个web应用，在右边再点击【web services refs】选项卡，再点击【add】按钮。现在可以增加web服务引用了。增加一个名称为service/tax的web服务引用，如图2所示。

 

 

图2 增加web服务引用

注意上面的service接口是com.hellking.study.webservice.tax.mytaxservice。然后点击【container managed ports】，如图3所示。

 

 

图3 增加容器管理端点

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

下面看服务接口直接是service的情况，再增加一个web服务引用，如图4所示。

 

 

图4 增加另一种服务引用

注意上面service interface是javax.xml.rpc.service，并且指定了名称空间（urn：tax）和local part（mytaxservice）。同样，按照图3所示方法增加一个容器管理端点，端点接口名称和端口组件名称和图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服务的引用通过元素来指定；就是在客户端编程中要使用的引用名字；就是服务接口，有两种，分别是javax.xml.rpc.service和com.hellking.study.webservice.tax.mytaxservice；是服务的有效名称空间，如果直接使用com.hellking.study.webservice.tax.mytaxservice作为服务接口，就不需要指定元素；就是对服务端点的引用，它引用的是webservices.xml中定义元素。用来链接到webservices.xml中指定的，并且两者的名字是一致的。

调用测试

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

http://127.0.0.1:8080/tax/tax

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

 

 

图5 调用web服务

总结

通过上面的介绍，相信读者对web服务的引用已经有了全面的认识。我们可以看到，通过使用jndi，在j2ee组件中调用web服务就像面向对象编程一样，甚至可以不理解wsdl、xml之类的概念就能调用web服务。