Sep 26

详解SOAP开发Java Web服务 不指定

Heck , 11:32 , 编程杂谈 , 评论(0) , 引用(0) , 阅读(595) , Via 本站原创 | |
        本文适合首先要对j2ee有所了解的读者,熟悉xml,tomcat等基本内容,本文主要是简单介绍一下web服务的基本内容,怎样在java web开发中构建soap服务:
一、soap(simple object access protocol)简单对象访问协议
  要了解soap,首先就需要了解分布式计算的由来,随着下一代的分布式计算体系web服务的出现,soap成为了创建和调用通过网络发布的应用程序的实际通信标准。soap类似传统的二进制协议iiop(corba)和jrmp(rmi),但它不采用二进制数据表示法,而是采用使用xml的,基于文本的数据表示法。
  
  通过xml表示法,soap定义了一种小型有线连接协议和编码格式,以表示数据类型、编程语言和数据库,还可以使用各种internet标准协议作为其消息传输工具,还可以提供表示rpc和文档驱动的消息交换等通信模型的约定。请注意,w3c正致力于soap的研究,http://www.w3c.org/2000/xp/group/ ,并得到了主流供应商的积极响应,以便对于基于xml的协议相关的重要任务达成共识,并定义其关键要求和使用场景。
  
  soap1.2的基本规范定义了以下基本内容:
  
  1)用于将xml文档表示为结构化soap消息的语法和语义
  2)在soap消息中表示数据的编码标准
  3)用于交换soap消息的通信模型
  4)soap传输等底层协议的绑定
  soap消息主要包括了信封头,消息头,主体,附件几部分

  一个简单的soap消息表示:

  以上是1.2版本命名空间,1.1的命名空间 soap envelope:http://schemas.xmlsoap.org/soap/envelop/ ,soap encoding: http://schemas.xmlsoap.org/soap/encoding/
  
  关于soap编码规范请参阅www.w3c.org/tr/xmlschema-2/ 定义的编码值,其他的一些规范可以上www.w3c.org 上具体查看。
  
二、以下从实际例子来学习
  这里我使用的是apache的一个子项目axis的具体例子,便于深入了解soap的运行:
  
  1)下载axis的相关内容http://ws.apache.org/axis/:
  (来源www.hecks.tk)
  2)建立一个实例程序(遵守j2ee的web程序规范),如(webservicetest目录)
  
  把axis中lib文件夹的内容拷到你的webservicetest/web-inf/lib下,同时上网下载xerces(下载地点:http://xml.apache.org/xerces-j/)解释器的包文件xerces.jar,也拷到webservicetest/web-inf/lib文件夹下,(若要配置log4j,请把属性文件log4j.properties拷到webservicetest/web-inf/classes文件夹下)
  
  3)修改应用程序webservicetest/web-inf中的web.xml文件:主要servlet设置如下

  你现在可以在网址里输入http://localhost/webservicetest/servlet/testservlet 看到了吗?axis是使用axis.jar包里的org.apache.axis.transport.http.axisservlet对应用程序进行处理的,基本配置就讲到这里。
  
三、接着我们来说axis中的内核
  1)不使用tomcat引擎运行axis。
  
  先建立一个脚步文件,对环境变量classpath进行设置要把lib下的那些包文件的路径全都包括进去,运行:java org.apache.axis.transport.http.simpleaxisserver <port>
  
  2)内部服务处理程序是org.apache.axis.providers.java.rpcprovider,标志出服务所需的方法,然后提供从soap请求消息组成部分的参数。
  
  3)axis的应用程序端管理功能:
  
  java org.apache.axis.client.adminclient 就会列出参数,可供你选择。我们的例子是:java org.apache.axis.client.adminclient -l http://localhost/webservicetest/servlet/testservlet list 就会显示出服务列表,返回的是xml文件
  4)wsdl2java应用程序可以把wsdl文件创建基于java的程序,如占位程序等
  java org.apache.axis.wsdl.wsdl2java <url>
  
  axis的基本内容说到这里
  
  四、具体例子

  1)编写逻辑程序,简单如:soaptest.java
  2) 部署服务,编写wsdd文件soaptest_deploy.wsdd:

  其中classname参数是你的想部署的类名(全名),allowedmethods是调用的服务的方法,如果有多个方法的话可以用空格分开(如: <parameter name="allowedmethods" value="getstr getmoney"/>),当用*的时候表示全部。
  
  好了现在准备部署了,确保环境路径classpath设置正确,运行:
  
  java org.apache.axis.client.adminclient -l http://localhost/webservicetest/servlet/testservlet soaptest_deploy.wsdd
  
  (这里不懂的话,请参考以上的说明)
  
  ok,呵呵,至此,我们已经完成了一个web服务的部署:测试http://localhost/webservicetest/servlet/testservlet 看里面是否多了一个选择soaptest服务?
  
  如果不想要服务了那重新编写一个wsdd文件,内容改为:

  和上面一样,对比一下就ok了。
  
五、客户端测试:
  客户端我们也可以使用java来进行测试,网上也有资料的,你可以去学习,很简单的。现在为了体现web服务的魅力,我用.net平台来测试吧,客户端使用c#编写(先要安装.net framework sdk):
  
  1)通过wsdl生成web服务代理,在net平台下运行:
  
  wsdl /l:cs /protocol:soap /out:soaptestclient.cs http://localhost/webservicetest/services/soaptest?wsdl
  
  我们通过wsdl得到了一个cs文件soaptestclient.cs(当前目录),你可以打开cs文件,研究一下里面的代码,那个getstr(string name)就是我们需要调用的方法,我们的客户端通过调用该方法就可以调用服务器端的方法,内部的转化wsdl.exe工具已经帮我们完成了,axis下的wsdl2java



来源:Heck's Blog
地址:http://www.hecks.tk/java-web-soap-sevices-html/
转载时须以链接形式注明作者和原始出处及本声明,否则将追究法律责任,谢谢配合!
Tags: