Webservice
Webservice
就是一种远程调用技术,他的作用就是从远程系统中获取业务数据
1
课程安排
- 什么是webservice
- Webservice入门程序
- Webservice的应用场景
- Webservice的三要素
- WSDL:web服务描述语言
- SOAP:简单对象访问协议
- UDDI:目录服务
- Webservice的四种客户端调用方式
- 生成客户端调用方式
- 客户端编程调用方式
- HttpURLConnecton调用方式
- Ajax调用方式
- 深入开发:用注解修改WSDL内容
2
什么是
webservice
2.1
什么是远程调用技术
远程调用数据定义:是系统和系统之间的调用
2.2
Webservice
的原理图
- Webservice是使用Http发送SOAP协议的数据的一种远程调用技术
- Webservice要开发服务端
- Webservice要开发客户端
- Webservice客户端开发需要阅读服务端的使用说明书(WSDL)
3
Webservice
的入门程序
3.1
需求
- 服务端:发布一个天气查询服务,接收客户端城市名,返回天气数据给客户端
- 客户端:发送城市名称给服务端,接收服务端的返回天气数据,打印
3.2
环境
- JDK:1.7
- Eclipse:mars
3.3
实现
3.3.1
服务端:
开发步骤:
- 第一步:创建SEI(Service Endpoint Interface)接口,本质上就是Java接口
- 第二步:创建SEI实现类,在实现类上加入@WebService
- 第三步:发布服务,Endpoint发布服务,publish方法,两个参数:1.服务地址;2.服务实现类
- 第四步:测试服务是否发布成功,通过阅读使用说明书,确定客户端调用的接口、方法、参数和返回值存在,证明服务发布成功。
- WSDL地址:服务地址+”?wsdl”
- WSDL阅读方式:从下往上
3.3.2
客户端:
开发步骤
- 第一步:wsimport命令生成客户端代码
wsimport -s .
http://127.0.0.1:12345/weather?wsdl
- 第二步:根据使用说明书,使用客户端代码调用服务端
- 第一步:创建服务视图,视图是从service标签的name属性获取
- 第二步:获取服务实现类,实现类从portType的name属性获取
- 第三步:获取查询方法,从portType的operation标签获取
3.4
Webservice
的优缺点
优点:
- 发送方式采用http的post发送,http的默认端口是80,防火墙默认不拦截80,所以跨防火墙
- 采用XML格式封装数据,XML是跨平台的,所以webservice也可以跨平台。
- Webservice支持面向对象
缺点:
- 采用XML格式封装数据,所以在传输过程中,要传输额外的标签,随着SOAP协议的不断完善,标签越来越大,导致webservice性能下降
4
Webservice
应用场景
4.1
软件集成和复用
4.2
适用场景
- 发布一个服务(对内/对外),不考虑客户端类型,不考虑性能,建议使用webservice
- 服务端已经确定使用webservice,客户端不能选择,必须使用webservice
4.3
不适用场景
- 考虑性能时不建议使用webservice
- 同构程序下不建议使用webservice,比如java 用RMI,不需要翻译成XML的数据
5
WSDL
5.1
定义
WSDL
及web
服务描述语言,他是webservice
服务端使用说明书,说明服务端接口、方法、参数和返回值,WSDL
是随服务发布成功,自动生成,无需编写
5.2
文档结构
- <service>服务视图,webservice的服务结点,它包括了服务端点
- <binding>为每个服务端点定义消息格式和协议细节
- <portType>服务端点,描述 web service可被执行的操作方法,以及相关的消息,通过binding指向portType
- <message>定义一个操作(方法)的数据参数(可有多个参数)
- <types>定义 web service 使用的全部数据类型
5.3
阅读方式:从下往上
6
SOAP
6.1
定义:
- SOAP即简单对象访问协议,他是使用http发送的XML格式的数据,它可以跨平台,跨防火墙,SOAP不是webservice的专有协议。
- SOAP=http+xml
6.2
协议格式
- 必需有 Envelope 元素,此元素将整个 XML 文档标识为一条 SOAP 消息
- 可选的 Header 元素,包含头部信息
- 必需有Body 元素,包含所有的调用和响应信息
- 可选的 Fault 元素,提供有关在处理此消息所发生错误的信息
6.3
TCP/IP Monitor
6.3.1
代理原理
6.3.2
配置
6.3.3
测试
在浏览器中输入代理服务地址,能正常访问,代表代理服务器设置成功
6.4
SOAP1.1
请求
响应
6.5
SOAP1.2
- 如何发布SOAP1.2服务端
- Jaxws不支持SOAP1.2服务端发布,直接发布会报如下异常
- 如果想发布SOAP1.2服务端,需要在服务端引入第三方JAR(jaxws-ri-2.2.8)
- 在实现类上加入如下注解
@BindingType(SOAPBinding.SOAP12HTTP_BINDING)
请求:
响应
6.6
SOAP1.1
和
SOAP1.2
区别
- 相同点:
- 请求发送方式相同:都是使用POST
- 协议内容相同:都有Envelope和Body标签
- 不同点:
- 数据格式不同:content-type不同
- SOAP1.1:text/xml;charset=utf-8
- SOAP1.2:application/soap+xml;charset=utf-8
- 命名空间不同:
- SOAP1.1:http://schemas.xmlsoap.org/soap/envelope/
- SOAP1.2:http://www.w3.org/2003/05/soap-envelope
7
UDDI
UDDI
是一种
目录服务
,企业可以使用它对
Web services
进行注册和搜索。
UDDI
,英文为
"Universal Description, Discovery and Integration"
,可译为
“
通用描述、发现与集成服务
”
。
UDDI
并不像
WSDL
和
SOAP
一样深入人心,
因为很多时候,使用者知道
Web
服务的位置(通常位于公司的企业内部网中)。
8
课程回顾
- 什么是webservice
- 什么是远程调用,系统和系统之间的调用,从远程系统当中获取业务数据。
- Webservice是web服务,他是用http传输SOAP协议数据的一种远程调用技术
- Webservice入门程序
- 服务端
- 第一步:创建SEI接口
- 第二步:创建SEI实现类,要在类上加入@WebService
- 第三步:发布服务,Endpoint的publish方法,2两个参数:1.服务地址;2.实现类实例
- 第四步:测试服务是否发布成功,通过阅读使用说明书,确定服务接口、方法、参数、返回值存在,说明服务发布成功。
- WSDL地址:服务地址+”?wsdl”
- WSDL阅读方式,从下往上,servvice->binding->portType->其中有接口、方法、参数和返回值
- 客户端
- 第一步:使用wsimport生成客户端代码
- 第二步:根据使用说明书,使用客户端调用服务端
- 创建服务视图,视图是从service的name属性获取
- 获取服务实现类,从portType的name属性获取
- 调用查询方法,从portType下的operation标签的name属性获取
- 优缺点:
- 发送方式采用http的post,http默认端口是80,所以跨越防火墙
- 数据封装使用XML格式,XML是跨平台,所以webservice可以跨平台
- Webservice支持面向对象开发
- Webservice应用场景
- 软件集成和复用
- 适用场景:
- 发布服务(对内/对外),不考虑性能,不考虑客户端类型,建议使用webservice
- 服务端已确定使用webservice,客户端只能使用webservice
- 不适用场景:
- 考虑性能时,不建议使用webservice
- 同构程序下,不建议使用webservice,比如客户端服务端都是java开发,建议Java RMI
- WSDL
- 定义:WSDL即Web服务描述语言,他是webservice服务端的使用说明书,他说明服务端接口、方法、参数和返回值,他是随服务发布成功,自动生成,无需编写
- 文档结构:
- Service
- Binding
- portType
- message
- types
- 阅读方式:从下往上
- SOAP
- 定义:SOAP即简单对象访问协议,他是使用http发送的XML格式的数据,跨平台、跨防火墙,他不是webservice的专有协议
- SOAP=http+xml
- 协议的格式:
- 必须有:envelope和body
- 非必有:header和fault
- SOAP1.1和1.2区别:
- 相同点:
- 都使用http的POST发送请求
- 协议的格式都相同:都有envelope标签和body标签
- 不同点:
- Content-type:
- 相同点:
SOAP1.1
:text/xml;charset=utf-8;SOAP1.2:application/soap+xml;charset=utf-8
- 命名空间不同:
- UDDI:就是一个目录服务,提供搜索和注册功能,因为不常用,所以了解下就可以了。
9
Webservice
的四种客户端调用方式
公网服务地址:
9.1
第一种生成客户端调用方式
9.1.1
Wsimport
命令介绍
- Wsimport就是jdk提供的的一个工具,他作用就是根据WSDL地址生成客户端代码
- Wsimport位置JAVA_HOME/bin
- Wsimport常用的参数:
- -s,生成java文件的
- -d,生成class文件的,默认的参数
- -p,指定包名的,如果不加该参数,默认包名就是wsdl文档中的命名空间的倒序
- Wsimport仅支持SOAP1.1客户端的生成
9.1.2
调用公网手机号归属地查询服务
- 第一步:wsimport生成客户端代码
- 第二步:阅读使用说明书,使用生成客户端代码调用服务端
9.1.3
公网天气服务端查询
9.1.4
特点
该种方式使用简单,但一些关键的元素在代码生成时写死到生成代码中,不方便维护,所以仅用于测试。
10
第二种:
service
编程调用方式
10.1
特点
该种方式可以自定义关键元素,方便以后维护,是一种标准的开发方式
11
第三种:
HttpURLConnection
调用方式
开发步骤:
第一步:创建服务地址
第二步:打开一个通向服务地址的连接
第三步:设置参数
设置POST
,POST
必须大写,如果不大写,报如下异常
如果不设置输入输出,会报如下异常
第四步:组织SOAP
数据,发送请求
第五步:接收服务端响应,打印
12
Ajax
调用方式
13
深入开发:用注解修改
WSDL
内容
WebService
的注解都位于javax.jws
包下:
@WebService-
定义服务,在
public class
上边
targetNamespace
:指定命名空间
name
:
portType
的名称
portName
:
port
的名称
serviceName
:服务名称
endpointInterface
:
SEI
接口地址,如果一个服务类实现了多个接口,只需要发布一个接口的方法,可通过此注解指定要发布服务的接口。
@WebMethod-
定义方法,在公开方法上边
operationName
:方法名
exclude
:设置为
true
表示此方法不是
webservice
方法,反之则表示
webservice
方法,默认是
false
@WebResult-
定义返回值,在方法返回值前边
name
:返回结果值的名称
@WebParam-
定义参数,在方法参数前边
name
:指定参数的名称
作用:
通过注解,可以更加形像的描述
Web
服务。对自动生成的
wsdl
文档进行修改,为使用者提供一个更加清晰的
wsdl
文档。
当修改了
WebService
注解之后,会影响客户端生成的代码。调用的方法名和参数名也发生了变化