当前位置: 代码迷 >> Web前端 >> Axis2 创设 webservice 操作手册
  详细解决方案

Axis2 创设 webservice 操作手册

热度:771   发布时间:2012-12-18 12:43:41.0
Axis2 创建 webservice 操作手册

1.3 什么是WebService

?

?

简单理解:Web Service 就是一个网络组件(一个可以通过网络访问的程序)。

它有一个或多个端口(Port),这些端口用于接收客户端的请求,并返回响应?

请求和响应的 都是一种基于XML的消息。不过这种消息遵循特定的格式(SOAP )。

?

?

1.4 WebService WSDL SOAP关系

?

Web Service = SOAP + HTTP + WSDL。其中,SOAP Simple Object Access Protocol)协议是web service的主体,它通过HTTP或者SMTP等应用层协议进行通讯,自身使用XML文件来描述程序的函数方法和参数信息,从而完成不同主机的异构系统间的计算服务处理。这里的WSDL(Web Services Description Language)web 服务描述语言也是一个XML文档,它通过HTTP向公众发布,公告客户端程序关于某个具体的 Web service服务的URL信息、方法的命名,参数,返回值等。

?

SOAP格式数据:

?

<?xml version='1.0' encoding='utf-8'?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
		<soapenv:Body>
				<helloServer xmlns="http://gongqiang">
				<arg0 xmlns="">张三</arg0>
			</helloServer>
		</soapenv:Body>
</soapenv:Envelope>

?

?

1.5 Web Service服务器工作流程

?

监听网络端口(监听服务端口)

接收客户端请求(接收SOAP请求)

解析客户端请求(解析SOAP消息,将SOAP消息转换为数据对象)

调用业务逻辑 (调用Web Service实现类的特定操作,参数是由SOAP消息转换而来的数据对象)

生成响应 (将返回值转换为SOAP消息)

返回响应 (返回SOAP响应) ?

?

?

1.6 Web Service客户端工作流程

?

?构造SOAP请求消息(将本地数据对象转换为SOAP消息)

发送SOAP消息到Web Service服务器的指定端口

接收SOAP响应消息?

将SOAP响应消息转换为本地数据对象 ??

?

?

2.系统所需环境

?

?

JDK1.4以上版本

设置JAVA_HOME环境变量

ANT必须是1.6.5以上版本

设置AXIS2_HOME环境变量,指向安装跟目录

在path路径下添加:%AXIS2_HOME%\bin\

?

?

3.构建WebService服务器

?

?

3.1 使用AXIS2构建WebService服务器

POJO

Eclipse插件

3.1.1 ?POJO方式?

1、下载所需的包:axis2 的2进制的包和axis2.war

?

下载地址:http://ws.apache.org/axis2/download/1_5_2/download.cgi

?

2、将下载的axis2.war,放置到tomcat的webapps目录下,启动tomcat,此时webapps目录会自动解压出axis2目录,如下图所示

?

?


此时,在浏览器中输入:http://localhost:8080/axis2/,如果一切正常将会看到如下界面


?

?

3、编写服务器端代码

?

启动Eclipse,选择File---->New--->Project,打开新建项目向导,如下图所示:

?


?

4、选择Java Project,点击Next,打开新建项目窗口,为新建项目命名,这里命名为:4thWebService,如下图所示:

?


5、点击Finish完成项目创建。

?

6、编写服务器端代码

? 选择File--->New---->Class,为新建的不含任何报名的类,命名为:myWebService,如下图所示:

?


?

7、点击Finish,编写代码,代码如下

?

public class MyWebService {
	public String helloWebService(String name) {   
        return name + " ,this is WebService ^-^";   
    }  
}
?

8、将编译后的MyWebService .class放置到tomcat的webapps\axis2\WEB-INF\pojo(没有pojo文件夹的需要手动创建该文件夹)目录下

?

9、在地址栏中输入:

?

http://localhost:8080/axis2/services/MyWebService?wsdl,如果创建成功,将会看到如下界面:

?


使用POJO方式搭建Web Service优缺点

优点:简单

缺点:服务器端java类不能含有包名

?

?

3.1.2 ? 使用框架构建webservice

?

1、下载所需的包(方法参考3.1.1 POJO方式中的1 2)

?

2、下载Axis2_Codegen_Wizard_1.3.0,Axis2_Service_Archiver_1.3.0并解压插件到eclipse的plugins目录下,启动eclipse(下载地址略)

?

3、编写服务器端代码

? 选择File--->New---->Class,为新建的类,包名命名为:gongqiang,类名命名为:myWebService,如下图所示:

?


?

?4、点击Finish,编写代码,代码如下

?

package gongqiang;

public class MyWebService {
	public String helloWebService(String name) {   
        return name + " ,this is WebService ^-^";   
    }  
}
?

5、新建项目,FILE---->NEW---->OTHER,选择Axis2 Service Archiver ,如下图

?


6、点击Next进入下一个设置页面

?


7、在该页面中设置你的JAVA类编译后存放的CLASS目录,记住这里的目录不需要包括JAVA包,点击next进入下一个设置页面

?


8、选择第一个SkipWSDL,点击Next进入下一页,该页我们不设置,再点击Next,进入如下页面

?


9、点击Next,出现如下页面

?


10、面中填入ServiceName,ClassName(你将要作为webservice暴露的JAVA类的全路径),点击load

选择Search declared methods only只显示你定义的方法,然后在列表中选择你需要暴露的方法,点击next,出现如下图

?


11、点击finish,出现如下图表示生成服务器端成功。

?


12、将生成的loginService放置到tomcat的ebapps\axis2\WEB-INF\services目录下,如下图

?


?

13、在地址栏中输入:

http://localhost:8080/axis2/services/myService2?wsdl,如果创建成功,将会看到如下界面:

?


?

3.1.3 ? 使用独立安装模式

1、修改配置文件:axis2二进制文件下面的axis2-1.5.2\conf\axis2.xml ?

?

<transportReceivername="http"                     
class="org.apache.axis2.transport.http.SimpleHTTPServer"> 
<parameter name="port">8060</parameter>
</transportReceiver>
?

端口号修改为:8060(防止与tomcat冲突)

2、运行axis2server.bat(位于axis2二进制文件下面的axis2-1.5.2\bin目录下)

3、浏览器中输入:http://localhost:8060/axis2/services/Version?wsdl,可以看到如下界面

?


?

4.构建WebService客户端

4.1.1 ?使用插件创建WebService客户端

1、下载geronimo-stax-api_1.0_spec-1.0.1.jar,backport-util-concurrent-3.1.jar,将下载后的文件放置到eclipse安装目录的Axis2_Codegen_Wizard_1.3.0文件下(该文件夹是3.1.2 ?第2步中解压之后的文件夹)

2、修改Axis2_Codegen_Wizard_1.3.0\plugin.xml文件,在该文件中添加如下代码:

?

<library name="lib/geronimo-stax-api_1.0_spec-1.0.1.jar"> 
       <export name="*"/> 
</library> 
<library name="lib/backport-util-concurrent-3.1.jar"> 
	     <export name="*"/>
</library> 
?

3、将文件夹Axis2_Codegen_Wizard_1.3.0重命名为Axis2_Codegen_Wizard_1.4.0

4、启动Eclipse ,点击File---->New--->Other,弹出如下界面:

?


5、选择Axis2 Code Genetator,点击Next,进入下一个设置页面,如下图:

?


6、选择Generate Java source from a WSDL file,点击Next,进入下一个设置界面,如下图

?


7、在上图文本框中输入wsdl地址,点击Next,进入下一设置页面,如下图:

?


8、点击Next,进入下一个设置页面,如下图:

?


9、点击上图的Browse,选择生成客户端代码存放位置(这里放置到桌面),点及Finish,将会看到如下操作,说明客户端创建成功

?


?

10、将生成的两个类(这里为MyService2CallbackHandler.java、MyService2Stub.java)源文件拷贝到eclipse工作空间中,如下图:


?

?

11、引入相关jar 包

? ?A)点击Window---->Preferences,进入Preferences窗口,如下图

?


B)依此选择Java-->Build Path--->User Liberaries,点击New ,新建User Liberaries(这里命名为axis2)选中新建好的axis2库,点击import,引入jar包(axis2二进制包中lib目录下所有jar包)

?

?

C)右键项目名称,选择build path---->Add Liberary弹出Add Liberary窗口,如下图

?


D)点击Next,选择刚刚创建的axis2 库。

?

12、编写客户端实现类,代码如下

package gongqiang;

public class MyClient {

	public static void main(String[] args) {
		try {

			MyService2Stub stub = new MyService2Stub();
			// 初始化SimpleMethod方法。
			MyService2Stub.HelloWebService request = new MyService2Stub.HelloWebService();
			// 调用simpleMethod的setName方法。
			request.setName("gq");
			System.out.println(stub.helloWebService(request).get_return());

		} catch (Exception e) {
			e.printStackTrace();
		}
	}

}

?

13、执行MyClient.class,控制台输出如下信息,说明调用服务成功

?

gq ,this is WebService ^-^


  相关解决方案