怎樣在J2EE組件中引用和查找Web服務(wù)

2019-11-18 11:34:57

字體：大中小

供稿：網(wǎng)友

怎樣在J2EE組件中引用和查找Web服務(wù) 作者:陳亞強(qiáng) 來源:http://www.java-cn.com

本文將討論怎么在J2EE組件中引用Web服務(wù)、并且通過JNDI來查找Web服務(wù)。在內(nèi)容組織上，首先把一個(gè)EJB2.1無狀態(tài)會話Bean發(fā)布成Web服務(wù)，然后開發(fā)基于jsp的Web服務(wù)客戶端，最后著重介紹怎么在JSP的部署時(shí)引用Web服務(wù)，并且討論怎么通過JNDI來查找和調(diào)用Web服務(wù)。

閱讀本文前您需要以下的知識和工具：

J2EE1.4 SDK，并且會初步使用；

把握基本的JAX-RPC Web服務(wù)開發(fā)技能；

了解JNDI的基本知識，能夠使用它進(jìn)行簡單編程；

一般的Java編程知識。

Web服務(wù)客戶端我們知道，JAX-RPC Web服務(wù)客戶端有以下幾個(gè)類型：

基于Stub；
基于動態(tài)代理；
基于動態(tài)調(diào)用接口（DII）。
實(shí)際上，上面三種客戶端都是使用Service接口來作為它們的創(chuàng)建工廠，Service接口中定義了諸如以下的方法：

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

Call createCall() ;
Call createCall(QName portName,
String OperationName) ;
Remote getPort(QName portName,
Class serviceEndpointInterface) ;
Remote getPort(Class serviceEndpointInterface) ;

可以看出，通過Service接口，能夠創(chuàng)建Call對象和Remote對象，而Call或者Remote對象正是調(diào)用Web服務(wù)所需要的。通過使用Service接口，我們可以在Web服務(wù)客戶端通過以下的方式來實(shí)現(xiàn)調(diào)用：

例程2 在客戶端調(diào)用Web服務(wù)

//創(chuàng)建一個(gè)ServiceFactory對象。
ServiceFactory serviceFactory
= ServiceFactory.newInstance();
//通過ServiceFactory
對象創(chuàng)建一個(gè)調(diào)用Web服務(wù)的Service對象。
Service service =
serviceFactory.createService
(taxWsdlUrl,
new QName(nameSpaceUri,
serviceName));

//獲得服務(wù)端點(diǎn)實(shí)例。
TaxService myPRoxy =
( TaxService) service.getPort
(new QName(nameSpaceUri,
portName),
TaxService.class);
//調(diào)用Web服務(wù)。
double result=myProxy.calculateTax(5000);

可以看出，在創(chuàng)建Service實(shí)例時(shí)，需要使用指定的WSDL文件位置、由服務(wù)名和名稱空間URI組成的有效名稱空間，這樣使得創(chuàng)建這個(gè)實(shí)例時(shí)變得復(fù)雜。JAX-RPC規(guī)范推薦使用JNDI來查找服務(wù)接口。通過JNDI，使得調(diào)用Web服務(wù)時(shí)就像調(diào)用EJB一樣簡單。只要通過兩步就可以獲得Web服務(wù)接口：

初始化一個(gè)名稱空間上下文；

在這個(gè)上下文中查找Web服務(wù)。

比如可以按照以下的方式來進(jìn)行：

例程3 通過JNDI調(diào)用Web服務(wù) 1

InitialContext ic = new InitialContext ();
Service abf = (Service)ic.lookup( "java:comp/env/service/AddressBookService");

Web服務(wù)引用的名字（AddressBookService）在部署時(shí)指定，java:comp/env是JNDI的上下文，service是Web服務(wù)的sub context。所以Web服務(wù)的JNDI名字一般由以下幾個(gè)部分組成：

Web服務(wù)JNDI＝客戶端環(huán)境上下文＋
service(sub context)＋服務(wù)引用名字

我們看到，例程3中查找到的是Service接口，其實(shí)在開發(fā)中，我們可以采用另一種服務(wù)引用形式：直接查找Web服務(wù)接口，如例程4所示。

例程4通過JNDI調(diào)用Web服務(wù)2

Context ic= new InitialContext();
HelloServiceInterface service =
(HelloServiceInterface) ic.lookup
("java:comp/env/service/HelloService");

在后面的例子可以看到，使用這個(gè)方式在調(diào)用時(shí)又簡化了一步。下面我們通過一個(gè)實(shí)例來演示怎么在J2EE Web服務(wù)的客戶端引用Web服務(wù)，然后通過JNDI來查找Web服務(wù)。

開發(fā)、部署一個(gè)Web服務(wù)

我們開發(fā)一個(gè)提供個(gè)人所得稅計(jì)算的Web服務(wù)，采用EJB作為服務(wù)端點(diǎn)。首先定義一個(gè)接口，如例程5所示。

例程5 定義服務(wù)接口

package com.hellking.
study.webservice.tax;

import java.rmi.Remote;
import java.rmi.RemoteException;

/**
*個(gè)人所得稅Web服務(wù)。
*/
public interface TaxService
extends Remote
{
public double calculateTax
(double salary)throws
java.rmi.RemoteException;
}

它提供的服務(wù)方法是計(jì)算個(gè)人所得稅。

例程6 EJB部分代碼

double base=1200;
//個(gè)人所得稅基數(shù)，
2003年10起北京為1200元。

//業(yè)務(wù)邏輯代碼，
實(shí)現(xiàn)服務(wù)端點(diǎn)接口中定義的方法。
public double calculateTax(double salary)
{
return getTax(salary-base);

}
//下面是具體的計(jì)算方法。公式適合于現(xiàn)在的個(gè)人所得稅制度。
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;
}

下面編寫一個(gè)配置文件，通過配置文件來生成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服務(wù)的名字是MyTaxService，名稱空間是"urn:Tax"，服務(wù)接口是"com.hellking.study.webservice.tax.TaxService"，這些參數(shù)將在后面的編程中使用。通過以下命令來生成一個(gè)mapping.xml映射文件：

wscompile -define -d . -nd .
-classpath . -mapping mapping.xml
config.xml

發(fā)客戶端

這個(gè)例子提供了兩種不同引用Web服務(wù)的方法，如例程8所示。

例程8 在客戶端通過JNDI查找Web服務(wù)

package com.hellking.study.webservice.tax;

import javax.naming.*;
import javax.xml.rpc.Service;
import javax.xml.namespace.QName;

/**
*Web服務(wù)客戶演示：通過JNDI來查找Web服務(wù)。
*/
public class TaxBean
{
/**
*第一種查找服務(wù)的方法，
直接獲得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服務(wù)端點(diǎn)接口。
TaxService
tax=taxService.getTaxServicePort();
ret=tax.calculateTax(sal);
}
catch(Exception e)
{
System.out.println(e);
}
return ret;
}
/**
*另一種查找服務(wù)的方法，
獲得的是Service接口，
然后再通過這個(gè)接口來獲得具體的服務(wù)。
*/
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");
//使用這種方式獲得服務(wù)端點(diǎn)接口時(shí)，
需要指定名稱空間。
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接口。具體使用那種方式，是和部署描述相關(guān)的，在后面將介紹部署的差別。最后開發(fā)一個(gè)JSP來作為測試客戶端，這個(gè)JSP通過JavaBean調(diào)用Web服務(wù)，如例程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調(diào)用Web服務(wù)。</title>
</head>
<body>
<div align="center">
<h1>Web服務(wù)----適合北京地區(qū)，
2003年</h1>
<%
out.println("個(gè)人所得稅是：<br>");
out.println(tax.getTax1(salary));
out.println("<br>另一種方法調(diào)用Web服務(wù)，
個(gè)人所得稅是：<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服務(wù)

打開J2EESDK部署工具（執(zhí)行％J2EESDK_HOME％//AppServer//bin//deploytool.bat或者$J2EESDK/AppServer/bin/deploytool.sh），新建一個(gè)Web應(yīng)用，把上面的測試JSP添加進(jìn)來。在部署時(shí)，Web應(yīng)用將包含如圖1所示的文件。

圖1 Web應(yīng)用中包含的文件

點(diǎn)擊這個(gè)Web應(yīng)用，在右邊再點(diǎn)擊【W(wǎng)eb services Refs】選項(xiàng)卡，再點(diǎn)擊【Add】按鈕。現(xiàn)在可以增加Web服務(wù)引用了。增加一個(gè)名稱為service/tax的Web服務(wù)引用，如圖2所示。

點(diǎn)擊查看大圖
圖2 增加Web服務(wù)引用

注重上面的Service接口是com.hellking.study.webservice.tax.MyTaxService。然后點(diǎn)擊【Container Managed Ports】，如圖3所示。

點(diǎn)擊查看大圖
圖3 增加容器治理端點(diǎn)

到此，一種引用Web服務(wù)的方式就完成了。

下面看服務(wù)接口直接是Service的情況，再增加一個(gè)Web服務(wù)引用，如圖4所示。

點(diǎn)擊查看大圖
圖4 增加另一種服務(wù)引用

注重上面Service Interface是javax.xml.rpc.Service，并且指定了名稱空間（urn：Tax）和Local Part（MyTaxService）。同樣，按照圖3所示方法增加一個(gè)容器治理端點(diǎn)，端點(diǎn)接口名稱和端口組件名稱和圖3一致。

經(jīng)過了上面的部署，實(shí)際上在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>

下面解釋一下這個(gè)描述付。對Web服務(wù)的引用通過元素來指定；就是在客戶端編程中要使用的引用名字；就是服務(wù)接口，有兩種，分別是javax.xml.rpc.Service和com.hellking.study.webservice.tax.MyTaxService；是服務(wù)的有效名稱空間，假如直接使用com.hellking.study.webservice.tax.MyTaxService作為服務(wù)接口，就不需要指定元素；就是對服務(wù)端點(diǎn)的引用，它引用的是webservices.xml中定義元素。用來鏈接到webservices.xml中指定的，并且兩者的名字是一致的。

調(diào)用測試

部署完成后，在瀏覽器里輸入：

http://127.0.0.1:8080/tax/tax

將出現(xiàn)如圖5所示的界面。