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 ^-^