文件标识版 本 号密 级Webservice开发指南（北京）技术有限公司1 修订记录版本编号版本日期修订人说明0.12006-9-26张乐雷这是创建的最初的版本。将记录开发过程中遇到的各种问题。同时和其他相关的方法、资源等等。0.22006-11-20张乐雷增加了，客户端、服务端生成方式、生成步骤、脚本测试方法V1.0-final2006-11-29张乐雷增加了：优秀文章、增加了发布服务的机制、优化axis工程支持命令和ant生成方式、去掉了代理类的生成、优化了文章结构。V1.12006-12-7张乐雷增加webservice访问方式、启动服务的命令、cmd格式的文件、增加wsdd文件的发布方式、jws格式描述。V1.22007-1-2张乐雷引入了日志跟踪方式、常见问题解答、修订了文件的格式、和97的邮件来往的问题技术交流、附件build.xml代码V1.32007-1-25张乐雷对文章结构进行调整、引入的插件生成代码的方式、增加文档RoadmapV1.42007-4-9张乐雷增加了工具ObjectWeb Lomboz生成客户端的方式。V1.52007-7-11张乐雷增加了：获得wsdl文件的方式V1.62007-7-26张乐雷删除：过时的资源；新增一些基本概念解释、分类、spring整合V1.72007-8-9张乐雷删除：文档开发路线图、增加axis2解释V1.82008-6-27张乐雷增加：通过axis1.*生成代码v1.92009-3-28张乐雷删除：相关文章目录。调整：axis开发流程。丰富：axis工具命令2 目 录1修订记录12目 录13概述13.1主要内容包括13.2本文的特色13.3关于实例工程24Web Service基本概念24.1基本组成24.2什么是 Webservice？34.3什么是SOAP？34.4什么是WSDL？34.5什么是WSDD？44.6什么是UDDI？44.7客户端和服务器端55Axis基础知识65.1什么是axis？65.2什么时Axis2？65.3文件格式介绍85.4Axis开发工具85.5server-config.wsdd95.6序列化与反序列化95.7Axis相比Soap v2的优点95.8性能105.9更多106开发和测试工具106.1开发工具106.2测试webservice接口工具107采用eclipse开发流程117.1根据wsdl或webservice url，生成相关代码。117.2根据java代码生成wsdl和服务端代码118采用Axis开发流程118.1基本流程118.2Axis与Spring的结合138.3Webservice代码设计准备138.4Webservie客户端开发148.5生成客户端和服务器端命令详细实例188.6Webservice服务器端开发198.7Webservice访问方式198.8Webservice服务发布208.9Webservice测试208.10Webservice中的日志跟踪219Axis与应用服务器集成229.1如果配置和发布229.2平台的配置方式249.3生成Web服务的服务端和客户端代码25102.9开发实例2910.1Axis自带实例设置步骤2910.2Axis开发webservice3011常见问题和解答3712参考资源3713总结和展望3714附录3814.1生成代码分类3814.2Axis命令参数3814.3测试webservice用例代码4014.4axis1.*和ant开发步骤41第17页3 概述本文是关于webservcie开发指南，其中主要包括：基本概念、使用axis来进行开发和测试、axis和spring集成开发、aixs和web服务期集成开发、通过ObjectWeb Lomboz工具生成客户端和服务器代码方式等等。核心内容包括： axis命令级别的详细解释、axis和spring相互结合开发指南、开发步骤的梳理和解释。本文只提到了Axis2的基本概念，详细知识，可以参见Axis2的相关文档。同时我单独写的build.xml生成相关代码的脚本。这是重量级别的文章，对webservice知识点和axis的使用命令涉及到比较多。3.1 主要内容包括1、 关于webservice的基本概念2、 Axis相关概念和命令。3、 开发和测试工具，代码实例。4、 开发客户端和服务器端的开发流程。5、 开发的详细的命令介绍。6、 如何测试的方法。7、 发布的步骤。8、 日志跟踪机制。9、 其他优秀文章。 10、 相关参考资料的介绍。11、 其他文档的发布路线图。12、 等等。3.2 本文的特色1、 有助于理解webservice深层的设计思想。因为没有使用eclipse插件，强迫你每次可以看axis相关的知识，必然对相关的概念、代码的架构设计，可以对自动生成的代码的命名、调用细节，有比较深的理解，例如：Proxy模式的设计。2、 增强你对工程的管理能力。 当生成代码时，你将每次手工的设置wsdl文件名称、路径名称等等，处处在影响这你。Ant是管理java的强大的工具，应用最广泛。无论多牛的开发图形工具，它的后台，对工程的管理，很多都是采用ant命令调用。3、 提高你的测试能力。在附件中的工程，生成的代码支持Junit测试的java代码。通过测试，当你在你应用中调用时，通过copy、paste就可以搞定。4、 增强你的思考能力。有些知识，网上是找不到的，这恰恰是你的机会，同时也是公司的机会，因为公司是单个人组成的。通过思考，通过动手，才能突破一些难点。例如：hibernate的Callback代码设计、强大的Template方法、多线程下数据同步和持久化、不同Ip之上数据表的操作访问，程序管理表和物理管理表的设计模式。网上，没人告诉你。不详细的它的源代码调用和相关规范，很难搞清楚。5、 详细和大量的代码实例。这样可以方便你引用，这些所有的代码和build.xml文件，都是经过测试和应用过的。3.3 关于实例工程考虑到，容量比较大，可能要自己到网站下载。参见：相关资源。4 Web Service基本概念4.1 基本组成由两部分组成SOAP-Web Service之间的基本通信协议。WSDL-Web Service描述语言，它定义了Web Service做什么，怎么做和查询的信息。The Web Service Description Language is a specification authored by IBM and Microsoft, and supported by many other organizations. WSDL serves to describe Web Services in a structured way. A WSDL description of a service tells us, in a machine-understandable way, the interface to the service, the data types it uses, and where the service is located.Handler A reusable class which is responsible for processing a MessageContext in some custom way. The Axis engine invokes a series of Handlers whenever a request comes in from a client or a transport listener. SOAP The Simple Object Access Protocol (yes, despite the fact that it sometimes doesnt seem so simple, and doesnt have anything to do with objects. :). You can read the SOAP 1.1 specification at http:/www.w3.org/TR/SOAP. The W3C is currently in the midst of work on SOAP 1.2, under the auspices of the XML Protocol Group. Provider A provider is the back-end Handler which is responsible for actually performing the meat of the desired SOAP operation. Typically this means calling a method on some back-end service object. The two commonly used providers are RPCProvider and MsgProvider, both in the org.apache.axis.providers.java package. 4.2 什么是 Webservice？Web 是使应用程序可以以与平台和编程语言无关的方式进行相互通信的一项技术。Web 服务是一个软件接口，它描述了一组可以在网络上通过标准化的 XML 消息传递访问的操作。它使用基于 XML 语言的协议来描述要执行的操作或者要与另一个 Web 服务交换的数据。一组以这种方式交互的 Web 服务在面向服务的体系结构（Service-Oriented Architecture，SOA）中定义了特殊的 Web 服务应用程序。4.3 什么是SOAP？SOAP（Simple Object Access Protocol ）简单对象访问协议是在分散或分布式的环境中交换信息并执行远程过程调用的轻量级协议，是一个基于XML的协议。使用SOAP，不用考虑任何特定的传输协议（最常用的还是HTTP协议），可以允许任何类型的对象或代码，在任何平台上，以任何一种语言相互通信。SOAP包括四个部分：SOAP封装(envelop)，封装定义了一个描述消息中的内容是什么，是谁发送的，谁应当接受并处理它以及如何处理它们的框架；SOAP编码规则（encoding rules），用于表示应用程序需要使用的数据类型的实例；SOAP RPC表示(RPC representation)，表示远程过程调用和应答的协定；SOAP绑定（binding），使用底层协议交换信息。