Webservice
Webservice就是一种远程调用技术,他的作用就是从远程系统中获取业务数据
1 课程安排
1.1 什么是webservice
1.2 Webservice入门程序
1.3 Webservice的应用场景
1.4 Webservice的三要素
1.5 WSDL:web服务描述语言
1.6 SOAP:简单对象访问协议
1.7 UDDI:目录服务
1.8 Webservice的四种客户端调用方式
1.9 生成客户端调用方式
1.10 客户端编程调用方式
1.11 HttpURLConnecton调用方式
1.12 Ajax调用方式
1.13 深入开发:用注解修改WSDL内容
2 什么是webservice
2.1 什么是远程调用技术
远程调用数据定义:是系统和系统之间的调用
2.2 Webservice的原理图
- Webservice是使用Http发送SOAP协议的数据的一种远程调用技术
- Webservice要开发服务端
- Webservice要开发客户端
- Webservice客户端开发需要阅读服务端的使用说明书(WSDL)
3 Webservice的入门程序
3.1 需求
- 服务端:发布一个天气查询服务,接收客户端城市名,返回天气数据给客户端
- 客户端:发送城市名称给服务端,接收服务端的返回天气数据,打印
3.2 环境
- JDK:1.6
- MyEclipse:10.0
3.3 实现
3.3.1 服务端:
开发步骤:
第一步:创建SEI(Service Endpoint Interface)接口,本质上就是Java接口
package cn.itcast.ws.jaxws.ws;
/**
* SEI接口
* @author Administrator
*
*/
public interface WeatherInterface {
public String queryWeather(String cityName);
}
package cn.itcast.ws.jaxws.ws;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.Style;
import javax.xml.ws.BindingType;
//SEI实现类
//@WebService表示该类是个服务类,需要发布其中的public方法
@WebService
@SOAPBinding(style = SOAPBinding.Style.RPC)(jdk1.6需要声明,否则启动会报错,jdk1.7就不需要了)
//如何实现发布soap1.2版本协议的服务端程序(Jaxws不支持SOAP1.2服务端发布,如果想发布SOAP1.2服务端,需要在服务端引入第三方JAR(jaxws-ri-2.2.8))
//@BindingType(javax.xml.ws.soap.SOAPBinding.SOAP12HTTP_BINDING)
public class WeatherInterfaceImpl implements WeatherInterface {
@Override
public String queryWeather(String cityName) {
System.out.println("from client...."+cityName);
String weather="晴";
return weather;
}
}
第三步:发布服务,Endpoint发布服务,publish方法,两个参数:1.服务地址;2.服务实现类
package cn.itcast.ws.jaxws.ws;
import javax.xml.ws.Endpoint;
//天气服务端
//当使用jdk1.6发布WebService时,如果不指定@SOAPBinding(style = SOAPBinding.Style.RPC)遇到错误
public class WeatherServer {
public static void main(String[] args) {
//Endpoint发布服务
//参数解释:
//1.address - 服务地址
//2.implementor - 实现类
Endpoint.publish("http://127.0.0.1:12345/weather", new WeatherInterfaceImpl());
System.out.println("服务启动成功......");
}
}
第四步:测试服务是否发布成功,通过阅读使用说明书,确定客户端调用的接口、方法、参数和返回值存在,证明服务发布成功。
- WSDL地址:服务地址+”?wsdl”
- WSDL阅读方式:从下往上
3.3.2 客户端:
开发步骤
第一步:wsimport命令生成客户端代码(wsimport将在下面详细介绍)
wsimport -s . http://127.0.0.1:12345/weather?wsdl
第二步:根据使用说明书,使用客户端代码调用服务端
- 第一步:创建服务视图,视图是从service标签的name属性获取
- 第二步:获取服务实现类,实现类从portType的name属性获取
- 第三步:获取查询方法,从portType的operation标签获取
package cn.itcast.ws.jaxws.ws.client;
import cn.itcast.ws.jaxws.ws.WeatherInterfaceImpl;
import cn.itcast.ws.jaxws.ws.WeatherInterfaceImplService;
//天气查询客户端
//jdk版本不同利用wsimport命令生成的客户端代码也不相同,但功能一致
public class WeatherClient {
public static void main(String[] args) {
//创建服务视图
WeatherInterfaceImplService weatherInterfaceImplService = new WeatherInterfaceImplService();
//获取服务实现类
WeatherInterfaceImpl weatherInterfaceImpl = weatherInterfaceImplService.getPort(WeatherInterfaceImpl.class);
//调用查询方法,打印
String weather = weatherInterfaceImpl.queryWeather("北京");
System.out.println("客户端调用服务器端成功...........");
System.out.println("查询出的天气信息为:"+weather);
}
}
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
请求:
POST /weather HTTP/1.1
Accept: text/xml, multipart/related
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://ws.jaxws.ws.itcast.cn/WeatherInterfaceImpl/queryWeatherRequest"
User-Agent: JAX-WS RI 2.2.4-b01
Host: 127.0.0.1:54321
Connection: keep-alive
Content-Length: 214
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body><ns2:queryWeather xmlns:ns2="http://ws.jaxws.ws.itcast.cn/"><arg0>北京</arg0></ns2:queryWeather>
</S:Body>
</S:Envelope>
响应:
HTTP/1.1 200 OK
Transfer-encoding: chunked
Content-type: text/xml; charset=utf-8
Date: Thu, 26 Nov 2015 03:14:29 GMT
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:queryWeatherResponse xmlns:ns2="http://ws.jaxws.ws.itcast.cn/"><return>晴</return></ns2:queryWeatherResponse>
</S:Body>
</S:Envelope>
6.5 SOAP1.2
如何发布SOAP1.2服务端?
- Jaxws不支持SOAP1.2服务端发布,直接发布会报如下异常
- 如果想发布SOAP1.2服务端,需要在服务端引入第三方JAR(jaxws-ri-2.2.8)
- 在实现类上加入如下注解
@BindingType(SOAPBinding.SOAP12HTTP_BINDING)
请求:
POST /weather HTTP/1.1
Accept: application/soap+xml, multipart/related
Content-Type: application/soap+xml; charset=utf-8;
action="http://ws.jaxws.ws.itcast.cn/WeatherInterfaceImpl/queryWeatherRequest"
User-Agent: JAX-WS RI 2.2.4-b01
Host: 127.0.0.1:54321
Connection: keep-alive
Content-Length: 212
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body><ns2:queryWeather xmlns:ns2="http://ws.jaxws.ws.itcast.cn/"><arg0>北京</arg0></ns2:queryWeather>
</S:Body>
</S:Envelope>
响应
HTTP/1.1 200 OK
Transfer-encoding: chunked
Content-type: application/soap+xml; charset=utf-8
Date: Thu, 26 Nov 2015 03:25:24 GMT
<?xml version='1.0' encoding='UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns2:queryWeatherResponse xmlns:ns2="http://ws.jaxws.ws.itcast.cn/"><return>晴</return></ns2:queryWeatherResponse>
</S:Body>
</S:Envelope>
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的四种客户端调用方式
公网服务地址:
http://www.webxml.com.cn/zh_cn/index.aspx
9.1 第一种生成客户端调用方式
9.1.1 Wsimport命令介绍
- Wsimport就是jdk提供的的一个工具,他作用就是根据WSDL地址生成客户端代码
- Wsimport位置JAVA_HOME/bin
- Wsimport常用的参数:
-s,生成java文件的
-d,生成class文件的,默认的参数(即无论写不写都会有class文件生成)
-p,指定包名的,如果不加该参数,默认包名就是wsdl文档中的命名空间的倒序(-p如果使用一定要放在-s和-d前)
- Wsimport仅支持SOAP1.1客户端的生成
9.1.2 调用公网手机号归属地查询服务
第一步:wsimport生成客户端代码
wsimport -p cn.itcast.mobile -s . http://webservice.we
bxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl
第二步:阅读使用说明书,使用生成客户端代码调用服务端
package cn.itcast.mobile.client;
import cn.itcast.mobile.MobileCodeWS;
import cn.itcast.mobile.MobileCodeWSSoap;
//公网手机号查询客户端
public class MobileClient {
public static void main(String[] args) {
//创建服务试图
MobileCodeWS mobileCodeWS = new MobileCodeWS();
//获取服务实现累
MobileCodeWSSoap mobileCodeWSSoap = mobileCodeWS.getPort(MobileCodeWSSoap.class);
//使用查询方法
String mobileInfo = mobileCodeWSSoap.getMobileCodeInfo("18895626618", "");
System.out.println(mobileInfo);
}
}
9.1.3 公网天气服务端查询
会提示报错,把wsdl网页另存到本地,然后删除无法解析的部分
D:\Workspaces\传智播客webservice学习\wsimport\src>wsimport -p cn.itcast.weather
-s . file:///C:\Users\Administrator\Desktop\WeatherWS.asmx.xml
package cn.itcast.weather.client;
import java.util.List;
import cn.itcast.weather.ArrayOfString;
import cn.itcast.weather.WeatherWS;
import cn.itcast.weather.WeatherWSSoap;
//公网天气查询客户端
public class WeatherClient {
public static void main(String[] args) {
WeatherWS weatherWS = new WeatherWS();
WeatherWSSoap weatherWSSoap = weatherWS.getPort(WeatherWSSoap.class);
ArrayOfString arrayOfString = weatherWSSoap.getWeather("广州", "");
List<String> list = arrayOfString.getString();
for(String str : list){
System.out.println(str);
}
}
}
9.1.4 特点
该种方式使用简单,但一些关键的元素在代码生成时写死到生成代码中,不方便维护,所以仅用于测试。
10 第二种:service编程调用方式
import java.net.MalformedURLException;
import java.net.URI;
import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import cn.itcast.mobile.MobileCodeWSSoap;
//service方式编程webservice
//注意也需要生成客户端,只是不通过自己生成的客户端来创建视图
public class MobileClient {
public static void main(String[] args) {
//创建wsdl的url,注意不是服务地址
URL wsdlDocumentLocation=null;
try {
wsdlDocumentLocation = new URL("http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?WSDL");
} catch (MalformedURLException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
//创建服务名称
//1.namespaceURI - 命名空间地址
//2.localPart - 服务视图名
QName serviceName = new QName("http://WebXml.com.cn/", "MobileCodeWS");
//创建服务视图
//参数解释
//1.wsdlDocumentLocation - wsdl地址
//2.serviceName - 服务名称
Service service = Service.create(wsdlDocumentLocation, serviceName);
//获取服务实现类
MobileCodeWSSoap mobileCodeWSSoap = service.getPort(MobileCodeWSSoap.class);
String mobileInfo = mobileCodeWSSoap.getMobileCodeInfo("18888888888", "");
System.out.println(mobileInfo);
}
}
10.1 特点
该种方式可以自定义关键元素,方便以后维护,是一种标准的开发方式
11 第三种:HttpURLConnection调用方式
开发步骤:
第一步:创建服务地址
第二步:打开一个通向服务地址的连接
第三步:设置参数
设置POST,POST必须大写,如果不大写,报如下异常
如果不设置输入输出,会报如下异常
第四步:组织SOAP数据,发送请求
第五步:接收服务端响应,打印
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.ProtocolException;
import java.net.URL;
//利用HttpURLConnection调用方式(可以不生成客户端)
public class HttpCilent {
public static void main(String[] args) throws IOException {
//第一步:创建服务地址,注意是服务地址不是wsdl地址
URL url = new URL("http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx");
//第二步:打开一个通向服务地址的连接
HttpURLConnection httpURLConnenction = (HttpURLConnection)url.openConnection();
//第三步:设置参数
//3.1发送方式设置:POST
httpURLConnenction.setRequestMethod("POST");
//3.2设置数据格式:content-type
httpURLConnenction.setRequestProperty("content-type", "text/xml;charset=utf-8");
//3.3设置输入和输出,因为默认新创建httpURLConnenction没有读写权限
httpURLConnenction.setDoInput(true);
httpURLConnenction.setDoOutput(true);
//第四步:组织SOAP数据,发送请求
String soapXML = getXML("15226466316");
OutputStream os = httpURLConnenction.getOutputStream();
os.write(soapXML.getBytes());
//第五步:接受服务器相应,打印
int responseCode = httpURLConnenction.getResponseCode();
if(responseCode == 200){ //表示服务端相相应成功
InputStream is = httpURLConnenction.getInputStream();
//is.read();这种直接操作二进制容易出现乱码
//字符流(装饰设计模式)
InputStreamReader isr = new InputStreamReader(is);
BufferedReader br = new BufferedReader(isr);
StringBuilder sb = new StringBuilder();
String temp = null;
while((temp= br.readLine()) != null){
sb.append(temp);
}
System.out.println(sb.toString());
br.close();
isr.close();
is.close();
os.close();
}
}
/**
* <?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<getMobileCodeInfo xmlns="http://WebXml.com.cn/">
<mobileCode>string</mobileCode>
<userID>string</userID>
</getMobileCodeInfo>
</soap:Body>
</soap:Envelope>
*/
public static String getXML(String phoneNum){
//模拟生成xml
String soapXML="<?xml version=\"1.0\" encoding=\"utf-8\"?>"
+"<soap:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">"
+"<soap:Body>"
+"<getMobileCodeInfo xmlns=\"http://WebXml.com.cn/\">"
+"<mobileCode>"+phoneNum+"</mobileCode>"
+"<userID></userID>"
+"</getMobileCodeInfo>"
+"</soap:Body>"
+"</soap:Envelope>";
return soapXML;
}
}
12 Ajax调用方式
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Document</title>
<script type="text/javascript">
function queryMobile(){
//创建XMLHttpRequest对象(这里没有考虑浏览器兼容问题)
var xhr = new XMLHttpRequest();
//打开连接
xhr.open("post","http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx",true);
//设置数据类型
xhr.setRequestHeader("content-type","text/xml;charset=utf-8");
//设置回调函数
xhr.onreadystatechange=function(){
//判断是否发送成功和判断服务端是否响应成功
if(4 == xhr.readyState && 200 == xhr.status){
alert(xhr.responseText);
}
}
//组织SOAP协议数据
var soapXML = "<?xml version=\"1.0\" encoding=\"utf-8\"?>"
+"<soap:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">"
+"<soap:Body>"
+"<getMobileCodeInfo xmlns=\"http://WebXml.com.cn/\">"
+"<mobileCode>"+document.getElementById("phoneNum").value+"</mobileCode>"
+"<userID></userID>"
+"</getMobileCodeInfo>"
+"</soap:Body>"
+"</soap:Envelope>";
alert(soapXML);
//发送数据
xhr.send(soapXML);
}
</script>
</head>
<body>
手机号查询:<input type="text" id="phoneNum"/> <input type="button" value="查询" οnclick="javascript:queryMobile();"/>
</body>
</html>
13 深入开发:用注解修改WSDL内容
WebService的注解都位于javax.jws包下:
1.@WebService-定义服务,在public class上边
- targetNamespace:指定命名空间
- name:portType的名称
- portName:port的名称
- serviceName:服务名称
- endpointInterface:SEI接口地址,如果一个服务类实现了多个接口,只需要发布一个接口的方法,可通过此注解指定要发布服务的接口。
2.@WebMethod-定义方法,在公开方法上边
- operationName:方法名
- exclude:设置为true表示此方法不是webservice方法,反之则表示webservice方法,默认是false
3.@WebResult-定义返回值,在方法返回值前边
- name:返回结果值的名称
4.@WebParam-定义参数,在方法参数前边
- name:指定参数的名称
作用:
通过注解,可以更加形像的描述Web服务。对自动生成的wsdl文档进行修改,为使用者提供一个更加清晰的wsdl文档。
当修改了WebService注解之后,会影响客户端生成的代码。调用的方法名和参数名也发生了变化
package cn.itcast.ws.jaxws.ws;
import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.Style;
import javax.xml.ws.BindingType;
//SEI实现类
//@WebService表示该类是个服务类,需要发布其中的public方法(要不要wsdl优化@WebService都必须要有)
@WebService(
targetNamespace="http://service.cn.itcast",
name="WeatherWSSoap",
portName="WeatherWSSoapPort",
serviceName="WeatherWS"
)
@SOAPBinding(style = SOAPBinding.Style.RPC)
//如何实现发布soap1.2版本协议的服务端程序(Jaxws不支持SOAP1.2服务端发布,如果想发布SOAP1.2服务端,需要在服务端引入第三方JAR(jaxws-ri-2.2.8))
//@BindingType(javax.xml.ws.soap.SOAPBinding.SOAP12HTTP_BINDING)
public class WeatherInterfaceImpl implements WeatherInterface {
@WebMethod(
operationName="getWeather",
exclude=false
)
@Override
public @WebResult(name="result")String queryWeather(@WebParam(name="cityName") String cityName) {
System.out.println("from client...."+cityName);
String weather="晴";
return weather;
}
}