1 Webservice就是一种远程调用技术，他的作用就是从远程系统中获取业务数据
2什么是webservice
2.1什么是远程调用技术
远程调用数据定义：是系统和系统之间的调用
2.2Webservice的原理图
Webservice是使用Http发送SOAP协议的数据的一种远程调用技术
Webservice要开发服务端
Webservice要开发客户端
Webservice客户端开发需要阅读服务端的使用说明书（WSDL）
3Webservice的入门程序
3.1需求
服务端：发布一个天气查询服务，接收客户端城市名，返回天气数据给客户端
客户端：发送城市名称给服务端，接收服务端的返回天气数据，打印
3.2环境
JDK：1.7
Eclipse：mars
3.3实现
3.3.1服务端：
开发步骤：
第一步：创建SEI（Service Endpoint Interface）接口，本质上就是Java接口
package cn.itcast.ws.jaxws.ws;
/**
*
* <p>Title: WeatherInterface.java</p>
* <p>Description:SEI接口</p>
* <p>Company: www.itcast.com</p>
* @version 1.0
*/
public interface WeatherInterface {
public String queryWeather(String cityName);
}
第二步：创建SEI实现类，在实现类上加入@WebService
package cn.itcast.ws.jaxws.ws;
import javax.jws.WebService;
/**
*
* <p>Title: WeatherInterfaceImpl.java</p>
* <p>Description:SEI实现类</p>
* <p>Company: www.itcast.com</p>
* @version 1.0
*/
@WebService//@WebService表示该类是一个服务类，需要发布其中的public的方法
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;
/**
*
* <p>Title: WeatherServer.java</p>
* <p>Description:天气服务端</p>
* <p>Company: www.itcast.com</p>
* @version 1.0
*/
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());
}
}
第四步：测试服务是否发布成功，通过阅读使用说明书，确定客户端调用的接口、方法、参数和返回值存在，证明服务发布成功。
WSDL地址：服务地址+”?wsdl”
WSDL阅读方式：从下往上
3.3.2客户端：
开发步骤
第一步：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;
/**
*
* <p>Title: WeatherClient.java</p>
* <p>Description:天气查询客户端</p>
* <p>Company: www.itcast.com</p>
* @version 1.0
*/
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(weather);
}
}
3.4Webservice的优缺点
优点：
发送方式采用http的post发送，http的默认端口是80，防火墙默认不拦截80，所以跨防火墙
采用XML格式封装数据，XML是跨平台的，所以webservice也可以跨平台。
Webservice支持面向对象
缺点：
采用XML格式封装数据，所以在传输过程中，要传输额外的标签，随着SOAP协议的不断完善，标签越来越大，导致webservice性能下降
4Webservice应用场景
4.1软件集成和复用
4.2适用场景
发布一个服务（对内/对外），不考虑客户端类型，不考虑性能，建议使用webservice
服务端已经确定使用webservice，客户端不能选择，必须使用webservice
4.3不适用场景
考虑性能时不建议使用webservice
同构程序下不建议使用webservice，比如java 用RMI，不需要翻译成XML的数据
5WSDL
5.1定义
WSDL及web服务描述语言，他是webservice服务端使用说明书，说明服务端接口、方法、参数和返回值，WSDL是随服务发布成功，自动生成，无需编写
5.2文档结构
服务视图，webservice的服务结点，它包括了服务端点
为每个服务端点定义消息格式和协议细节
服务端点，描述 web service可被执行的操作方法，以及相关的消息，通过binding指向portType
定义一个操作（方法）的数据参数(可有多个参数)
定义 web service 使用的全部数据类型
5.3阅读方式：从下往上
6SOAP
6.1定义：
SOAP即简单对象访问协议，他是使用http发送的XML格式的数据，它可以跨平台，跨防火墙，SOAP不是webservice的专有协议。
SOAP=http+xml
6.2协议格式
必需有 Envelope 元素，此元素将整个 XML 文档标识为一条 SOAP 消息
可选的 Header 元素，包含头部信息
必需有Body 元素，包含所有的调用和响应信息
可选的 Fault 元素，提供有关在处理此消息所发生错误的信息
6.3TCP/IP Monitor
6.3.1代理原理
6.3.2配置
6.3.3测试
在浏览器中输入代理服务地址，能正常访问，代表代理服务器设置成功
6.4SOAP1.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.5SOAP1.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.6SOAP1.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
7UDDI
UDDI 是一种目录服务，企业可以使用它对 Web services 进行注册和搜索。UDDI，英文为 “Universal Description, Discovery and Integration”，可译为“通用描述、发现与集成服务”。
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：就是一个目录服务，提供搜索和注册功能，因为不常用，所以了解下就可以了。
9Webservice的四种客户端调用方式
公网服务地址：
http://www.webxml.com.cn/zh_cn/index.aspx
9.1第一种生成客户端调用方式
9.1.1Wsimport命令介绍
Wsimport就是jdk提供的的一个工具，他作用就是根据WSDL地址生成客户端代码
Wsimport位置JAVA_HOME/bin
Wsimport常用的参数：
-s，生成java文件的
-d，生成class文件的，默认的参数
-p，指定包名的，如果不加该参数，默认包名就是wsdl文档中的命名空间的倒序
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;
/**
*
* <p>Title: MobileClient.java</p>
* <p>Description:公网手机号查询客户端</p>
* <p>Company: www.itcast.com</p>
* @version 1.0
*/
public class MobileClient {
public static void main(String[] args) {
//创建服务视图
MobileCodeWS mobileCodeWS = new MobileCodeWS();
//获取服务实现类
MobileCodeWSSoap mobileCodeWSSoap = mobileCodeWS.getPort(MobileCodeWSSoap.class);
//调用查询方法
String reuslt = mobileCodeWSSoap.getMobileCodeInfo("13888888", null);
System.out.println(reuslt);
}
}
9.1.3公网天气服务端查询
package cn.itcast.mobile.client;
import java.util.List;
import cn.itcast.weather.ArrayOfString;
import cn.itcast.weather.WeatherWS;
import cn.itcast.weather.WeatherWSSoap;
/**
*
* <p>Title: WeatherClient.java</p>
* <p>Description:公网天气查询客户端</p>
* <p>Company: www.itcast.com</p>
* @version 1.0
*/
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编程调用方式
ackage cn.itcast.mobile.client;
import java.io.IOException;
import java.net.MalformedURLException;
import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import cn.itcast.mobile.MobileCodeWSSoap;
/**
*
* <p>Title: ServiceClient.java</p>
* <p>Description:Service编程实现服务端调用</p>
* <p>Company: www.itcast.com</p>
* @version 1.0
*/
public class ServiceClient {
public static void main(String[] args) throws IOException {
//创建WSDL的URL，注意不是服务地址
URL url = new URL("http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl");
//创建服务名称
//1.namespaceURI - 命名空间地址
//2.localPart - 服务视图名
QName qname = new QName("http://WebXml.com.cn/", "MobileCodeWS");
//创建服务视图
//参数解释：
//1.wsdlDocumentLocation - wsdl地址
//2.serviceName - 服务名称
Service service = Service.create(url, qname);
//获取服务实现类
MobileCodeWSSoap mobileCodeWSSoap = service.getPort(MobileCodeWSSoap.class);
//调用查询方法
String result = mobileCodeWSSoap.getMobileCodeInfo("1866666666", "");
System.out.println(result);
}
}
10.1特点
该种方式可以自定义关键元素，方便以后维护，是一种标准的开发方式
11第三种：HttpURLConnection调用方式
开发步骤：
第一步：创建服务地址
第二步：打开一个通向服务地址的连接
第三步：设置参数
设置POST，POST必须大写，如果不大写，报如下异常
如果不设置输入输出，会报如下异常
第四步：组织SOAP数据，发送请求
第五步：接收服务端响应，打印
package cn.itcast.mobile.client;
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.URL;
/**
*
* <p>Title: HttpClient.java</p>
* <p>Description:HttpURLConnection调用方式</p>
* <p>Company: www.itcast.com</p>
* @version 1.0
*/
public class HttpClient {
public static void main(String[] args) throws IOException {
//第一步：创建服务地址，不是WSDL地址
URL url = new URL("http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx");
//第二步：打开一个通向服务地址的连接
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
//第三步：设置参数
//3.1发送方式设置：POST必须大写
connection.setRequestMethod("POST");
//3.2设置数据格式：content-type
connection.setRequestProperty("content-type", "text/xml;charset=utf-8");
//3.3设置输入输出，因为默认新创建的connection没有读写权限，
connection.setDoInput(true);
connection.setDoOutput(true);
//第四步：组织SOAP数据，发送请求
String soapXML = getXML("15226466316");
OutputStream os = connection.getOutputStream();
os.write(soapXML.getBytes());
//第五步：接收服务端响应，打印
int responseCode = connection.getResponseCode();
if(200 == responseCode){//表示服务端响应成功
InputStream is = connection.getInputStream();
InputStreamReader isr = new InputStreamReader(is);
BufferedReader br = new BufferedReader(isr);
StringBuilder sb = new StringBuilder();
String temp = null;
while(null != (temp = br.readLine())){
sb.append(temp);
}
System.out.println(sb.toString());
is.close();
isr.close();
br.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>
* @param phoneNum
* @return
*/
public static String getXML(String phoneNum){
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;
}
}
12Ajax调用方式
<!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://webservice.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="查询" onclick="javascript:queryMobile();"/>
</body>
</html>
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注解之后，会影响客户端生成的代码。调用的方法名和参数名也发生了变化