当前页面: 开发资料首页 → Java 专题 → 30分钟内创建Web Service（转）
30分钟内创建Web Service（转）
摘要: 30分钟内创建Web Service（转）
你已经听到过有关Web Service的某些宣传，可能这些宣传将你弄得头昏脑胀。在你的心中或许一直有一个疑团：到底什么是Web Service,我怎样才能使用它们？我们写的这个系列文章将揭开Web Services的神秘面纱，一步步地向你展示怎样去创建、发布、使用及发现它们。 创建一个基础的Web Services并非难事。为了证实这一点，我们将在这篇文章中向你展示如何在30分钟内构建一个Web Service。在后续的文章中，我们将就Web Services做深入的研究，就以下主题做充分诠释：
SOAP 消息
WSDL 定义项及它们与代码的关系
发布服务至UDDI目录
将先前遗留的应用程序做为Web Services发布出去
部分高级话题(如安全问题)
在这篇介绍性的文章中，我们先就Web Services做一些简单的介绍，紧接着向各位演示一个调用及执行Web Service的java类。我们所有的例子程序都是用java写的。我们使用Systinet提供的免费的工具及运行环境(有关访问及下载此软件的详细信息请参看软件安装这一节)来创建例子程序。并非完全必要使用这一工具来理解这些示例程序，但我们强烈建议你使用它。这里介绍的概念及创建的代码是通用的，它们与工具相对独立。我们假设你具备XML的知识，但对Web Services还无所知。
我们认为J2EE是实施商业逻辑的最成熟的框架，我们的目标就是使Web Services 作为J2EE的一个扩展模块，以提供基于XML协议的一致的描述及发现机制。这样就可使得现有的基于J2EE的系统能被更广泛的应用所调用，并提供在异种环境下创建核心商业应用的更强的适应能力。
Web Service - 基本概念
Web Service是具备下列特性的组件： 1.它通过一个SOAP(Simple Object Access Protocol)接口被访问 2.它的接口定义在一个WSDL (Web Service Description Language)文档里。
SOAP是Web Services的根本。它是一种具有扩展性的XML消息协议。SOAP提供了一个应用程序向另一个应用程序发送XML消息的简单而一致的机制。一个SOAP消息是从SOAP发送者传至SOAP接收者的单路消息，任何应用程序均可作为发送者或接收者。SOAP能够支持许多通讯行为，包括请求/响应(request/resposne)、solicit response、单路异步消息，甚至简单讯息(notification)。SOAP是一个仅定义消息结构及一些消息处理规则的高层协议。它完全与底层的协议独立，因此SOAP消息能通过HTTP、JMS或邮件通讯协议来传输。但在当前，通常使用HTTP协议来传送SOAP消息。在这篇文章的后面我们将展示一些SOAP消息的例子。
WSDL是一份包含Web Service描述信息的XML文档，它包含了访问和使用一个Web Service所需要的所有信息，包括这个Web Service的功能、怎样与其通信及它的位置。在开发阶段，你使用WSDL文档创建你的服务接口。一些SOAP的实现(包括Systinet WASP)会在运行时使用WSDL支持动态通信。
安装此软件
环境要求：a Java 1.3.x SDK，a standard HTTP browser。JAVA_HOME环境变量指向你Java 1.3.x SDK的安装目录。 如果你想跟着练习这些示例，需要你从Systinet下载WASP Advanced。解压缩下载的文件包到一个本地磁盘(解压至C盘会更好些)。从bin子目录下找到名为install的脚本文件，执行之以完成安装。在我们的例子中，我们假设将下载的文件解压缩至c:\wasp-advanced 目录下。还需要你下载示例代码 并解压缩至c:\wasp_demo目录下。如果你选择了不同的目录，请相应更新env.bat脚本文件(更改WASP_HOME及WASP_DEMO的值以使其指向WASP的安装目录及示例代码所在目录)。
实现一个简单的Web Service
我们将按如下步骤来创建一个简单的Web Service: 1.创建实现Web Service的商业逻辑的类。 首先我们需要创建一个实现这个Web Service商业逻辑的java类。在这个例子中，我们将创建一个模拟股票报价的java类。 2.将这个java类发布至SOAP服务器上。我们将演示怎样使用WASP的发布工具发布一个java类至一个SOAP服务器 3.生成访问此服务的客户端代理类。一个客户端应用程序使用一个代理对象来访问Web Service。在请求阶段，这个代理对象接收到一个从客户端应用程序发出来的方法调用，并将此调用转化成一个XML消息。在响应阶段，这个代理对象接收到一个回复消息，随后将其转化成java的对象，并将结果返回给客户端应用程序。 4.客户端应用程序的开发。客户端应用程序将代理对象看作是一个便利于与Web Service交互的普通的java对象。
提示：我们使用微软Windows平台的一些语法来创建我们的脚本文件，如果你使用的是一个基于Unix的环境，请相应更新这些脚本。现在让我们开始编写这个具备股价查找功能的简单java类。请看如下的java代码： 提示：这个示例中的所有代码均可在解压缩之后的示例代码子目录下找到。它们位于com.systinet.demos.stock包中。
/* * StockQuoteService.java * * Created on Sat 13th Oct 2001, 15:25 */package com.systinet.demos.stock;/** * Simple stock quote service * @author zdenek * @version 1.0 */public class StockQuoteService { public double getQuote(String symbol) { if(symbol!=null && symbol.equalsIgnoreCase("SUNW")) return 10; if(symbol!=null && symbol.equalsIgnoreCase("MSFT")) return 50; if(symbol!=null && symbol.equalsIgnoreCase("BEAS")) return 11; return 0; } public java.util.LinkedList getAvailableStocks() { java.util.LinkedList list = new java.util.LinkedList(); list.add("SUNW"); list.add("MSFT"); list.add("BEAS"); return list; }}Figure 1: Web Service code (StockQuoteService.java) 我们的例子不过是又一个简单的股标报价系统而已(我们已经看到许多这样的系统，开发者必须是已登记的而被授权的卖主)，但它说明了创建及部署Web Service是多么容易。在我们的例子中，我们将去获取三种股票的市价(BEAS,MSFT,及SUNW)。 将我们开发的类转化成一个Web Service的最便捷的方式是：编译我们开发的java类，然后用部署工具将这些类发布至Web Service的运行环境。 提示：你可以在示例源代码bin子目录下找到所有的脚本文件。提示：在你运行此示例之前，你需先安装Systinet的SOAP框架。请参考安装这一节。 首先，运行startservcer.bat脚本以起动Web Service运行环境。然后我们编译StockQuoteService.java文件，并使用deploy.bat将编译后的类发布至SOAP运行时环境。
接下来，我们需要通过在HTTP浏览器开启管理控制台 来确认是否一切都工作正常了。请按刷新按钮以显示发布至服务器上的服务包列表。你应当看到包含StockQuoteService服务的StockService包已发布至服务器上。Web Service运行环境会自动产生WSDL文件，外部可通过http://localhost:6060/StockQuoteService/链接获取此文件。
<?xml version='1.0'?>
实现Web Service客户端(java)
客户端使用一个java的代理类来调用远程的Web Service。当使用Systinet WASP时,这个代理是在运行时根据WSDL文件生成的。我们需要一个java接口来保持与这个动态生成的对象的引用。可以自己创建这个接口文件，或者也可使用WASP提供的WSDLCompiler来替我们生成一个。创建这样一个接口文件是比较容易的，因为它唯一的要求是在此接口中的方法必须是定义在Web Service中的商业逻辑方法的一个子集。让我们看如下的代码。首先，这个客户程序创建了一个WebServiceLookup对象，然后这个对象调用lookup方法创建Web Service的代理。lookup方法需要两个参数：一个是对WSDL文件的引用，另一个是代理类。此方法返回Web Service的代理，可以用此代理对Web Service进行调用。
/** * Stock Client * * @created July 17, 2001 * @author zdenek */package com.systinet.demos.stock;import org.idoox.wasp.Context;import org.idoox.webservice.client.WebServiceLookup;public class StockClient { /** * Web service client main method. * Finds the web service and * @param args not used. */ public static void main( String[] args ) throws Exception { // lookup service WebServiceLookup lookup = (WebServiceLookup)Context.getInstance(Context.WEBSERVICE_LOOKUP); // bind to StockQuoteService StockQuoteServiceProxy quoteService = (StockQuoteServiceProxy)lookup.lookup( "http://localhost:6060/StockQuoteService/";, StockQuoteServiceProxy.class ); // use StockQuoteService System.out.println("Getting available stocks"); System.out.println("------------------------"); java.util.LinkedList list = quoteService.getAvailableStocks(); java.util.Iterator iter = list.iterator(); while(iter.hasNext()) { System.out.println(iter.next()); } System.out.println(""); System.out.println("Getting SUNW quote"); System.out.println("------------------------"); System.out.println("SUNW "+quoteService.getQuote("SUNW")); System.out.println(""); }}Figure 3: Web Service client code (StockClient.bat)
运行runJavaclient.bat脚本文件。这个脚本文件将运行WSDLCompiler以生成java接口，然后它会编译及运行客户端程序。你可在控制台看到getAvailableStocks及getQuote方法调用后的输出。
开发及运行Web Service客户端(javascript)
提示：请注意Web Service 的javascript客户端版本需要安装了MSXML3.0 SP2及后续版本的IE6或IE5的支持。 我们可以使用runJScriptClient.bat生成一个基于浏览器的javascript客户端。这个脚本会在IE中打开一个HTML页面，然后你便可在此页面调用Web Service的方法了。
粗看SOAP消息
现在我们可以通过WASP的管理控制平台来查看交互于客户端及服务器端的SOAP消息了。在浏览器中开发管理控制平台，然后点击刷新按钮在查看所有发布了的Web Service包。你应当看到StockQuoteService服务已发布在此服务器上了。点击"enable"链接(在在StockQuoteService区"Debig is OFF:"标签的旁边),使调试SOAP请求的功能生效，然后重新运行runJAvaclient.bat，在管理控制平台点击"show SOAP conversation"链接，一个新浏览器窗口将打开，其中显示了两组输入、输出的SOAP消息：
==== INPUT ==== http://localhost:6060/StockQuoteService/ ==== 11/7/01 3:45 PM =<;?xml version="1.0" encoding="UTF-8"?>
===================================================================== ==== OUTPUT ==== http://localhost:6060/StockQuoteService/ ======================<;?xml version="1.0" encoding="UTF-8"?>
===================================================================== ==== INPUT ==== http://localhost:6060/StockQuoteService/ ==== 11/7/01 3:45 PM =<;?xml version="1.0" encoding="UTF-8"?>
===================================================================== ==== OUTPUT ==== http://localhost:6060/StockQuoteService/ ======================<;?xml version="1.0" encoding="UTF-8"?>
===================================================================== Figure 4: SOAP messages
以下是SOAP消息的基本结构：
<headER attrs>
输出消息包含方法调用的结果：
清洁一下
在结尾我们可以运行undeploy.bat以解除我们示例服务的部署。
小结
在这篇打头的文章中我们向你演示了创建一个简单的Web Service并非难事 -- 事实上，使用Web Service的一个好处是他们相对容易创建和布署。我们介绍了一些基本的概念，包括SOAP及WSDL，还演示了SOAP消息的结构。同时还创建及分析了与Web Service交互信息的WSDL文件。在下一篇文章中，我们将深入探讨复杂类型、错误消息及远程对象引用等话题。
↑返回目录
前一篇: (1~10) （译者：陈佳新）
后一篇: 12个最重要的J2EE最佳实践