posts - 431,  comments - 344,  trackbacks - 0

一. 介绍


本文并不是想介绍 Web 服务的原理、系统架构等,我们假设您已经了解了关于 Web 服务的一些基本的概念、原理等知识。本文主要是针对那些已经了解 Web 服务概念,但是还没有亲身体会 Web 服务所带来令人欢欣鼓舞的特征的开发人员。在此我们认为你已经具备了 Java XML 等基础知识,如果你还有其他开发环境的经验例如 VB VC 那是再好不过的了。

1 Web 服务


虽然我们并不想详细讲述 Web 服务的体系结构,但是大概的介绍一下还是有必要的。 Web 服务是一种新型的 Web 应用程序。不同于其他 Web 应用程序,它是自适应、自我描述、模块化的应用程序,并可以跨越 Web 进行发布、定位以及调用。简单的 Web 服务可以提供例如天气预报或者航班信息的服务。一旦部署了 Web 服务,其他的应用程序就可以发现和调用所部署的服务。

2 AXIS 项目


Axis
框架来自 Apache 开放源代码组织,它是基于 Java 语言的最新的 SOAP 规范( SOAP 1.2 )和 SOAP with Attachments 规范(来自 Apache Group )的开放源代码实现。有很多流行的开发工具都使用 AXIS 作为其实现支持 Web 服务的功能,例如 JBuilder 以及著名的 Eclipse J2EE 插件 Lomboz AXIS 的最新版本是 1.1 ,可以从 http://ws.apache.org/axis/index.html 下载。

 

整个 AXIS 项目包括以下几个部分:

  1. 消息流子系统
    消息流子系统提供了灵活的消息传递框架,这个消息传递框架包括处理程序、链、序列化程序和反序列化程序。处理程序是一个处理请求、响应和故障流的对象。处理程序可被组合在一起成为链,而且可以使用一个灵活的部署描述符来配置这些处理程序的顺序。
  2. 传输框架子系统
    提供了一个传输框架,这个传输框架可以帮助您创建自己的可插式传输发送器和传输侦听器。
  3. 数据编码子系统
    AXIS
    完全按照 XML Schema 规范提供各种数据类型的自动序列化,并且提供功能扩展接口来使用您自己定制的序列化器和反序列化器。
  4. 其他
    AXIS
    完全支持 WSDL 以及日志记录、出错以及故障处理机制。它同时提供一些工具用来讲 WSDL 文档转换成客户端的调用框架以及根据类来产生 WSDL 定义文档。

AXIS 目前版本支持的标准是: W3C SOAP 1.1 1.2 WSDL 1.1 SAAJ 1.1 SUN 公司: SOAP with Attachments API for Java ); JAX-RPC SUN 公司: Java API for XML-Based RPC 1.0

除了前面介绍的 AXIS 外,本文中还将会用到 TOMCAT ,这里不再另行介绍。另外为了演示 Web 服务真正与开发环境无关以及 AXIS 产生的是标准的、符合规范的 Web 服务,我们还将用到微软公司的 SOAP TOOLKIT 以及微软的开发环境 VB VC 来做为 Web 服务的客户端。

. 环境搭建


由于 AXIS 本身是基于 Java 语言开发的项目,并且是以 Web 应用形式发布的,因此它运行时需要一个应用服务器作为支撑。为了方便我们这里选用的是 Tomcat 。由于 AXIS 本身需要用到处理 XML 信息的包,所以我们建议使用 JDK1.4 并安装 Tomcat 4.1.24 。下面是环境搭建步骤,读取根据自身情况进行安装。

  1. 安装 JDK1.4.1
  2. 安装 Tomcat 4.1.24 C:\Tomcat 并验证安装是否成功
  3. 下载 AXIS 项目打包文件 axis-1_1.zip 解压缩后将目录中的 webapps 目录下的 axis 子目录拷贝到 C:\Tomcat\webapps 下。
验证 AXIS 的安装:重新启动 Tomcat 服务器后打开浏览器输入网址 http://localhost:8080/axis 后,点击链接 "Validate" 来验证 Axis 所需的几个 Java 包是否齐全。  

 

点击超链接Validate后,AXIS会自动检查所需的每一个Java组件,这协组件分为:必需组件以及可选组件,必须保证所有必需组件都存在。 

三. Web Service服务端开发


经过了前两步之后我们就可以开始Web服务之旅了!大多数人在学习一种编程语言的第一步都是从Hello world程序开始的,我们也不例外。我们将提供这样一个Web服务,通过给它传入姓名,服务返回:你好[姓名],欢迎来到Web服务的世界。这就是我们的需求。我们将马上根据AXIS的要求完成我们的需求,你就会发现原来Web服务可以这么简单!

编写JavaHello.java,内容如下:

 
 
public class Hello{
 public String hello(String name){
  if(name==null)
   name = "";
  return "你好"+name+",欢迎来到Web服务的世界!";
}
}

 

仅此而已,无需编译,将该文件改名为Hello.jws并拷贝到AXIS应用目录C:\Tomcat\webapps\axis下。

下面我们就可以测试该Web服务了,打开浏览器并输入刚刚创建的文件名对应的URL地址http://localhost:8080/axis/Hello.jws浏览器显示如下结果:

There is a Web Service here     
        Click to see the WSDL 

 

点击页面上的链接查看该Web服务对应的WSDL信息如下所示(我们将在下一小节简单介绍WSDL

 
 
<?xml version="1.0" encoding="UTF-8" ?>
-<wsdl:definitions
 targetNamespace="http://localhost:8080/axis/Hello.jws"
 xmlns="http://schemas.xmlsoap.org/wsdl/"
 xmlns="http://www.w3.org/2000/xmlns/"
 xmlns:apachesoap="http://xml.apache.org/xml-soap" 
 xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
 xmlns:impl="http://localhost:8080/axis/Hello.jws" 
 xmlns:intf="http://localhost:8080/axis/Hello.jws"
 xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" 
 xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
 - <wsdl:message name="helloRequest">
 <wsdl:part name="name" type="xsd:string" /> 
 </wsdl:message>
 + <wsdl:message name="helloResponse">
 - <wsdl:portType name="Hello">
 - <wsdl:operation name="hello" parameterOrder="name">
 <wsdl:input name="helloRequest" message="intf:helloRequest" /> 
 <wsdl:output name="helloResponse" message="intf:helloResponse" />
 </wsdl:operation> 
 </wsdl:portType>
 - <wsdl:binding name="HelloSoapBinding" type="intf:Hello"> 
 <wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http" />
 - <wsdl:operation name="hello"> 
 <wsdlsoap:operation soapAction="" />
 - <wsdl:input name="helloRequest">
 <wsdlsoap:body use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
  namespace="http://DefaultNamespace" />  
 </wsdl:input>- <wsdl:output name="helloResponse">  
 <wsdlsoap:body use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
  namespace="http://localhost:8080/axis/Hello.jws" />   
 </wsdl:output> 
 </wsdl:operation> 
 </wsdl:binding>
 - <wsdl:service name="HelloService">
 - <wsdl:port name="Hello" binding="intf:HelloSoapBinding">
 <wsdlsoap:address location="http://localhost:8080/axis/Hello.jws" /> 
 </wsdl:port>  
 </wsdl:service> 
 </wsdl:definitions>

 

到此我们已经完成了helloWeb服务了,那我们怎么告诉用户如何来使用该服务呢?我们只需要告诉用户我们的Web服务的URL地址:http://localhost:8080/axis/Hello.jws?wsdl就可以了!下一节我们将介绍如何通过这个地址来访问对应的Web服务。

四. Web Service客户端开发


在这一节中我们将使用三种不同的语言来访问刚刚创建的Web服务,分别是JavaVBVC。为了使用VBVC访问Web服务,我们需要安装微软公司的Soap Toolkit 开发工具包,这个工具包可以从微软公司的主页

http://download.microsoft.com/download/xml/soap/2.0/W98NT42KMe/EN-US/SoapToolkit20.exe

下载,下载该软件包并使用默认方式安装即可。

在开始客户端开发之前有两个概念我们必须先粗略的介绍一下。

SOAP:简单对象访问协议。这是一种在松散的、分布的环境中使用XML对等地交换结构化的和类型化的信息提供了一个简单且轻量级的机制,它是一个基于XML的协议。它包括四个部分:SOAP封装(envelop),封装定义了一个描述消息中的内容是什么,是谁发送的,谁应当接受并处理它以及如何处理它们的框架;SOAP编码规则(encoding rules),用于表示应用程序需要使用的数据类型的实例; SOAP RPC表示(RPC representation),表示远程过程调用和应答的协定;SOAP绑定(binding),使用底层协议交换信息。

虽然这四个部分都作为SOAP的一部分,作为一个整体定义的,但他们在功能上是相交的、彼此独立的。特别的,信封和编码规则是被定义在不同的XML命名空间(namespace)中,这样使得定义更加简单。

SOAP的主要设计目标是简明性和可扩展性。这就意味着有一些传统消息系统或分布式对象系统中的特性将不包含在SOAP的核心规范中。这些特性包括:分布式垃圾收集;批量消息传输/处理;对象引用;对象激活。

WSDLWeb Service描述语言。使用了WSDL,我们就可以通过这种跨平台和跨语言的方法使Web Service代理的产生自动化。就像COMCORBAIDL文件,WSDL文件由客户和服务器约定。由于WSDL设计成可以绑定除SOAP以外的其他协议,这里我们主要关注WSDLHTTP上和SOAP的关系。同样,由于SOAP目前主要用来调用远程的过程和函数,WSDL支持SOAP传输的文档规范。

WSDL文档可以分为两部分。顶部分由抽象定义组成,而底部分则由具体描述组成。抽象部分以独立于平台和语言的方式定义SOAP消息,它们并不包含任何随机器或语言而变的元素。这就定义了一系列服务,截然不同的网站都可以实现。

1. Java客户端


使用AXIS的工具将使Web服务的访问和我们之前介绍的创建一个Web服务一样的简单。我们前面安装的AXIS环境中已经包含着这样的工具,它是一个Java类,类名为:org.apache.axis.wsdl.WSDL2Java。打开命令行窗口,转到AXIS目录下的WEB-INF子目录。确保Tomcat服务已经处于启动状态,键入命令

 
 
Java -Djava.ext.dirs=lib org.apache.axis.wsdl.WSDL2Java http://localhost:8080/axis/Hello.jws?wsdl

 

该命令执行的结果是在当前所在目录下产生一个子目录 localhost/axis/Hello_jws,该目录下有四个Java源文件,它们分别是:

Hello.java 定义了Web服务接口,此例中只有一个hello方法。

HelloService.java 定义了用于获取Web服务接口的方法。

HelloServiceLocator.java 接口HelloService的具体实现。

HelloSoapBindingStub.java Web服务客户端桩,通过该类与服务器交互。

这四个Java类帮我们处理了大部分的逻辑,我们需要的仅仅是把这些类加到我们的项目然后创建一个我们自己的类来调用它们即可。为此我们新加一个类Main.java,为了方便,让这个类与刚产生的四个类都在同一个包下。内容如下:

 
 
//Main.java
package localhost.axis.Hello_jws;
public class Main{
public static void main(String[] args) throws Exception{
 HelloService service = new HelloServiceLocator();
 Hello hello = service.getHello(); 
 System.out.println("Response:"+hello.hello("罐头")); 
 }
}

 

使用以下命令进行编译:

 javac -classpath lib\axis.jar;lib\jaxrpc.jar localhost\axis\Hello_jws\*.java

 

如果编译没有问题的话执行该测试程序:

 Java -Djava.ext.dirs=lib -cp . localhost.axis.Hello_jws.Main
运行结果:Response:你好罐头,欢迎来到Web服务的世界!

 

WSDL2Java工具自动产生的几个类中,类HelloServiceLocator中保存这一些跟服务器相关的信息,例如URL地址等,当服务器的地址更改后但是服务并没有改动的时候直接修改该文件中的字符串定义,而无需重新生成这几个类。具体需要修改的内容,打开该文件便可一目了然。
posted on 2006-09-20 14:43 周锐 阅读(553) 评论(0)  编辑  收藏 所属分类: Web Service

只有注册用户登录后才能发表评论。


网站导航: