`
xumingrencai
  • 浏览: 1172852 次
文章分类
社区版块
存档分类
最新评论

使用SOAP开发java web服务--Axis开发方案

 
阅读更多
本文的预定读者首先要对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消息表示:
POST /StudentInfo HTTP/1.1
Host:anthropology.cun.edu
Content-Type: text/xml;charset="utf-8"
Content-Length: 640
SOAPAction:"GetStudentInfo"

<SOAP-ENV:Envelop xmlns:SOAP-ENV="http://www.w3c.org/2001/06/soap-envelope"
xmlns:xsi="http://www.w3c.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3c.org/2001/XMLSchema"
SOAP-ENV:encodingStyle="http://www.w3c.org/2001/06/soap-encoding">
<SOAP-ENV:Header>
<person:mail xmlns:person="http://www.cun.edu/Header">xyz@cun.edu
</SOAP-ENV:Header>

<SOAP-ENV:Body>
<m:GetStudentInfo xmlns:m="http://www.cun.edu/jws.student.studentInfo">
<student_name xsi:type='xsd:string'>
Wang wen yin
</student>
</m:GetStudentInfo>
</SOAP-ENV:Body>
</SOAP-ENV:Envelop>
以上是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/
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设置如下
<servlet>
<servlet-name>TestServlet</servlet-name>
<servlet-class>org.apache.axis.transport.http.AxisServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>TestServlet</servlet-name>
<url-pattern>*.jws</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>TestServlet</servlet-name>
<url-pattern>/servlet/TestServlet</url-pattern>
</servlet-mapping>

<servlet-mapping>
<servlet-name>TestServlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>


<servlet>
<servlet-name>AdminServlet</servlet-name>
<servlet-class>
org.apache.axis.transport.http.AdminServlet
</servlet-class>
<load-on-startup>100</load-on-startup>
</servlet>

<servlet-mapping>
<servlet-name>AdminServlet</servlet-name>
<url-pattern>/servlet/AdminServlet</url-pattern>
</servlet-mapping>

<mime-mapping>
<extension>wsdl</extension>
<mime-type>text/xml</mime-type>
</mime-mapping>

<mime-mapping>
<extension>xsd</extension>
<mime-type>text/xml</mime-type>
</mime-mapping>
你现在可以在网址里输入http://localhost/WebServiceTest/servlet/TestServlet看到了吗?Axis是使用axis.jar包里的org.apache.axis.transport.http.AxisServlet对应用程序进行处理的,基本配置就讲到这里。
三、接着我们来说Axis中的内核。
1)不使用Tomcat引擎运行Axis。
先建立一个脚步文件,对环境变量classpath进行设置要把lib下的那些包文件的路径全都包括进去,运行:javaorg.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
public class SoapTest{
public String getStr(String name){
return "Hello,"+name;
}
}
2)部署服务,编写wsdd文件SoapTest_deploy.wsdd:
<deployment name="SimapleTest" xmlns="http://xml.apache.org/axis/wsdd/"
xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"
xmlns:xsd="http://www.w3.org/2000/10/XMLSchema"
xmlns:xsi="http://www.w3.org/2000/10/XMLSchema-instance">
<service name="SoapTest" provider="java:RPC">
<parameter name="className" value="SoapTest"/>
<parameter name="allowedMethods" value="getStr"/>
</service>
</deployment>
其中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文件,内容改为:
<deployment name="SimapleTest" xmlns="http://xml.apache.org/axis/wsdd/"
xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"
xmlns:xsd="http://www.w3.org/2000/10/XMLSchema"
xmlns:xsi="http://www.w3.org/2000/10/XMLSchema-instance">
<service name="SoapTest"/>
</deployment>
和上面一样,对比一下就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工具也是一样的功能,可以参考我上面所说的关于Axis的内核内容
2)编译cs文件成程序集dll:
csc /target:library /r:System.Web.Services.dll /r:System.Xml.dll SoapTestClient.cs
最后我们等到了一个dll文件SoapTestClient.dll,客户端程序通过调用它就行了
3)编写客户端应用程序SoapTestClientApp.cs
using System;

namespache jws.client{
public class SoapTestClientApp{
public SoapTestClientApp(){
}
public static voidMain(string[] args){
if(args.Length!=1){
Console.WriteLine("Usage:SoapTestClientApp <name>");
Environment.Exit(1);
}
SoapTestService st_service=new SoapTestService();
st_service.getStr("Wang wenyin");
}
}
}
4)编译文件csc /r:SoapTestClient.dll SoapTestClientApp.cs
运行SoapTestClientApp
输出结果:
Hello,Wang wenyin
与预期结果相符。

好了,关于soap开发web服务就说到这里了,希望这篇文章能对大家有所帮助,谢谢了:)

对这篇文章有什么疑问的话,请留言给作者。作者联系地址:Sidney.J.Yellow@gmail.com

分享到:
评论

相关推荐

    Java SOAP协议

    本文的预定作者应该对SOAP1.1的基本规范有所了解,并熟悉了j2ee的基本开发,如果不熟悉的话,可以看一下我的Blog:使用SOAP开发java web服务--Axis开发方案 ,详细标准可以查看w3c的官方网站,连接如下:...

    java-ws-clients.rar_SOAP Web_Web Service SOAP_axis

    Java Web Service Clients examples(SOAP,AXIS)

    soap-ws-consumer-axis2:使用Axis2的SOAP Web服务简单消费者示例

    soap-ws-consumer-axis2 使用Axis2的SOAP Web服务简单使用者。 从WSDL文件自动生成的源

    Java Web 服务开发-值得一看

    Java Web 服务开发 计成超 内容概要 Java Web服务环境 简单的Web服务 Java处理XML SOAP JWSDP JAXM(Java API for XML Messaging)|SAAJ(SOAP with Attachement API for Java) Java Web服务环境 商业的 IBM Websphere,...

    Java RPC通信机制之SOAP:应用Apache Axis进行Web Service开发

    Java RPC通信机制之SOAP:应用Apache Axis进行Web Service开发

    MyEclipse下使用Axis开发Web Service()

    本文主要描述如何使用Apache开源项目Axis提供的API来实现Web Services。本文中的提到的例子只为了方便本文的描述而提出,有不妥之处请见谅。 本文的读者应有JAVA web 应用开发基础。应该具有看过WSDL,SOAP,XML等的...

    webservice-axis2:使用 SOAP 和 Apache Axis2 (JAX-WS) 和 XStream 的 Web 服务(客户端和服务器)示例

    网络服务轴 2 使用 SOAP 和 Apache Axis2 (JAX-WS) 和 XStream 的 Web 服务(客户端和服务器)示例

    axis-bin-1_4.zip

    Axis是第三代Apache SOAP,从2000年起,SOAP v2开发小组开始讨论如何让Axis更加灵活、可配置,以及能够处理SOAP和来自W3C的各种XML标准。通过不断地讨论和代码编写,Axis目前取得了如下成果: 速度提高。 Axis通过...

    webservice插件

    Apache的Axis2™的是一个Web服务/ SOAP/ WSDL引擎,继任者广泛使用的Apache Axis SOAP堆栈。有两种实现Apache Axis2 Web服务引擎 - Apache的Axis2/Java访问Apache Axis2/ C 虽然你会发现这里所有在Apache Axis2/...

    gsoap_win32_2.7.7

    很多公司都提供基于 Java™ 的 Web 服务栈,包括 Apache 的 Axis、IBM 的 WebSphere® Studio Application Developer (WSAD) 和 BEA 的 WebLogic Web 服务。Microsoft® .NET 技术提供一些用于 Web 服务的工具,如 ...

    soap-webservice:使用apace axis1的基于SOAP的Web服务

    肥皂网络服务使用Apache Axis的基于SOAP的Web服务这是一个用Apache Axis和Eclipse IDE Apache Axis编写的非常基本的基于SOAP的Web服务,是JAX-WS的参考实现。

    Java之Web服务开发方法论图解

    Java作为可扩展的开发平台备受开发者青睐,在其上开发Web服务(以下简称Web Service)的方法犹如雨后春笋般层出不穷,尤以Apache软件组织的两个子项目Axis2和CXF作为实现Web Service的技术框架最为突出。本文将以...

    Axis开发Web Service程序教程

    本文介绍使用AXIS作为开发环境来体会Web服务的开发过程。

    axis帮助文档(API)

    Axis 的主要功能是作为一个 SOAP 的实现来让开发者通过它来构建自己的 Web Service(支持 Java 和 C++)。随着 Web Services 以及 SOA 的不断发展,越来越多的人投入到了相关技术的实现、开发和标准的制定的工作中。...

    MyEclipse下开发Web Service(Axis)

    本文主要描述如何使用Apache开源项目Axis提供的API来实现Web Services。本文中的提到的例子只为了方便本文的描述而提出,者应有JAVA web 应用开发基础。应该具有看过WSDL,SOAP,XML等的基本规范。熟悉Eclipse+...

    致远A8-M平台API参考手册

    本指南所有 Java 远程接口例程使用 axis2 的 ADB(Axis2 DataBinding Framework)Stub 方式进行开发。 如果使用 Java 进行与 A8 紧耦合的本地开发: 1、 可以跳过 SOAP,直接调用 Web service 的 Java 本地接口...

    axis-getgeoip:如何将Axis2与WSDL2Code一起使用以调用公共SOAP Web服务

    带有WSDL2Code的Axis2 SOAP客户端演示您好,这里是一个演示项目,该项目使用Axis2及其WSDL2Code生成器调用公共Web服务 。要求JDK 1.7+(在jdk1.7.0_79上测试) Apache Maven 3.x(在3.2.5上测试)跑步只需输入: mvn...

    cdyne:Axis2 CDYNE Soap Web 服务客户端

    迪恩包含用于 Java 1.5+ 的自动生成的 Axis2 SOAP 客户端的库在另一个 Maven 项目中使用这个库: 将以下内容添加到发布的 pom.xml 中: &lt;repositories&gt; &lt;repository&gt; &lt;id&gt;maven.leadoperations.co-release&lt;/id&gt; ...

    axis1.4.1常用

    Web Services是由企业发布的完成其特定商务需求的在线应用服务,其他公司或应用软件能够通过Internet来访问并使用这项在线服务。 Axis总体上是一个SOAP引擎,但又不仅仅是个引擎,它还是: 1)是一个简单的独立的服务器 2...

Global site tag (gtag.js) - Google Analytics