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格式数据:
?
此时,在浏览器中输入:http://localhost:8080/axis2/,如果一切正常将会看到如下界面
?
?
3、编写服务器端代码
?
启动Eclipse,选择File---->New--->Project,打开新建项目向导,如下图所示:
?
?
4、选择Java Project,点击Next,打开新建项目窗口,为新建项目命名,这里命名为:4thWebService,如下图所示:
?
5、点击Finish完成项目创建。
?
6、编写服务器端代码
? 选择File--->New---->Class,为新建的不含任何报名的类,命名为:myWebService,如下图所示:
?
?
7、点击Finish,编写代码,代码如下
?
?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,编写代码,代码如下
?
?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 ?
?
?
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文件,在该文件中添加如下代码:
?
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 ^-^