WebService 操作手册
手册下载
Table of Contents
1 WebService简介 4
2 开发环境 4
3 环境配置 4
3.1 JDK 8.0 配置 4
3.2 IDEA 配置 6
3.3 Maven 配置 10
3.4 CXF、Axis2、Cmder配置 10
4 CXF 运用 11
4.1 常规运用 11
4.2 SpringBoot框架嵌入CXF 18
5 Axis2 运用 23
5.1 常规运用 23
5.2 SpringBoot框架嵌入Axis2 27
6 JDK自带ws运用 31
6.1 常规运用 31
1
WebService简介
基础的 Web Services平台是 XML + HTTP。
HTTP 协议是最常用的因特网协议。
XML 提供了一种可用于不同的平台和编程语言之间的语言。
WebServices 平台的元素:
l SOAP (简易对象访问协议)
l UDDI (通用描述、发现及整合)
l WSDL (Web services描述语言)
WebService 三种实现方式:
l CXF (简易对象访问协议)
l AXIS 2 (通用描述、发现及整合)
l JWS-MS (Web services 描述语言)
WebService注意事项:
l 只支持List、JavaBean类型的数据,不支持Map
2 开发环境
作用
进行不同系统间的数据交互传输
框架
Spring-boot 或 SpringMVC
运行环境
JDK 8.0、WIN10
运行时容器
Tomcat 8.0
依赖
Maven、Cmder(控制台)、CXF、Axis
推荐IDE
IntelliJ IDEA 2016.3
3 环境配置
3.1 JDK 8.0 配置
1、解压工具下的JDK8.7z到相应目录,如F:\Tool\JDK
2、配置环境变量
2.1新建环境变量JAVA_HOME
2.2新建环境变量CLASSPATH
内容为:.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar
2.3 在PATH变量里面追加
%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin
3. 验证JDK8.0是否安装完成
使用快捷键WIN + R 运行 cmd 输入java -version
如果出现以下,信息则表示正常
java version "1.8.0_101"
Java(TM) SE Runtime Environment (build 1.8.0_101-b13)
Java HotSpot (TM) 64-Bit Server VM(build 25.101-b13, mixed mode)
3.2 IDEA 配置
1、运行安装包中的IntelliJ IDEA安装文件(exe格式),进入软件的安装界面。
2、点击Next,界面如图所示。
3、点击Next,出现如下界面,此时需要等待一段时间(软件安装所需的文件正在提取)
4、完成后点击Next,出现如下界面。
4、点击Finish,结束安装。
5、启动IntelliJ IDEA,第一次启动时会有如下的提示框,直接点击OK即可。
6、在软件弹出的窗口中选择注册码激活(Activation Code),并将注册码复制到如下的文本框中,完成后点击OK即可。
7、当出现如下图所示界面时,说明已经安装成功。
3.3 Maven 配置
1、解压工具下的maven-3.3.9.7z到相应的目录
2、注意事项,配置maven的setting文件
配置<localRepository>F:\Tools\maven-3.3.9\.m2\repository</localRepository>
设置网络仓库下载并保存的jar包路径
3.4 CXF、Axis2、Cmder配置
1、cxf 和 axis2环境变量不建议同时安装,因为有几个可执行文件名重复
2、配置与(3.3 Maven配置)类似,只需配置环境变量
4 CXF 运用
4.1 常规运用
详细见《源码》cxfdemo01
新建工程
1、Maven选择
2、配置编译源、先新建main目录
3、新建2个包service和 client
4、配置依赖pom
服务端创建
客户端创建
1、获取服务请求wsdl文件
2、右键另存为 *.wsdl 格式文件
3、使用cxf工具创建客户端
wsdl2java -p webservice -d ./ -client .\Hello.wsdl
其中 -p [包名] -d[输出路径] -client [生成client代码]
4、客户端调用服务
见:[源码] cxfdemo01
消息输出:》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》
服务器
客户端
5、注意事项
服务请求类需加上@WebService注解,
请求方法 需加上@WebMethod注解,
不加会导致无法生成正确的客户端
4.2 SpringBoot框架嵌入CXF
新建工程
详细见《源码》cxfdemo02
1、新建 或使用http://start.spring.io/
2、配置POM
服务端创建
创建SpringBoot启动服务
创建CXF配置类
创建服务类和服务接口
客户端创建
消息输出:》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》
服务器
客户端
5 Axis2 运用
5.1 常规运用
新建工程
详细见《源码》axis2demo01
工程配置
1. 配置axis2 webapp结构
在webapp下新建conf、modules、services 3个目录
并将axis2.xml复制进conf
在services下新建HelloWorld/META-INF (提示:服务提供接口目录)
新建services.xml,服务配置文件(配置说明http://axis.apache.org/axis2/java/sandesha/userGuide.html)
web.xml 配置
2. POM配置
服务端创建
客户端创建
1、使用wsdl2java生成客户端
命令:%axis2_home%\bin\wsdl2java.bat -p client -uri http://localhost:8080/services/HelloWorldImpl?wsdl
2、调用客户端
检查wsdl连接
消息输出:》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》
服务器
客户端
5.2 SpringBoot框架嵌入Axis2
新建工程
详细见《源码》axis2demo02
在webapp下新建conf、modules、services 3个目录
并将axis2.xml复制进conf
在services下新建HelloWorld/META-INF (提示:服务提供接口目录)
新建services.xml,服务配置文件(配置说明http://axis.apache.org/axis2/java/sandesha/userGuide.html)
2. POM配置
配置依赖说明:springboot启动以来jar包,axis2基础jar包与axis2demo01工程jar一致
服务端创建
1、servlet创建,说明springboot内置tomcat并使用其他方式取消了web.xml的配置
2、服务类创建
客户端创建
1、使用wsdl2java生成客户端
命令:%axis2_home%\bin\wsdl2java.bat -p client -uri http://localhost:8080/services/HelloWorldImpl?wsdl
2、调用客户端
消息输出:》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》
服务器
客户端
6 JDK自带ws运用
6.1 常规运用
新建工程
详细见《源码》jwsdemo01
1. POM配置
(无)
服务端创建
提示:@WebService 必须加上
客户端创建
1、使用JDK自带wsimport生成客户端
2、调用客户端
消息输出:》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》》
服务器
客户端