1. 常见的远程调用协议与技术
IOS的七层模型:
第一层:应用层。定义了用于在网络中进行通信和传输数据的接口;
第二层:表示层。定义不同的系统中数据的传输格式,编码和解码规范等;
第三层:会话层。管理用户的会话,控制用户间逻辑连接的建立和中断;
第四层:传输层。管理着网络中的端到端的数据传输;
第五层:网络层。定义网络设备间如何传输数据;
第六层:链路层。将上面的网络层的数据包封装成数据帧,便于物理层传输;
第七层:物理层。这一层主要就是传输这些二进制数据。
Socket通信:Socket属于传输层,它是对TCP/IP协议的实现,包含TCP/UPD,它是所有通信协议的基础。
特点: 开启端口,该通信是长连接的通信 ,很容易被防火墙拦截,虽可以通过心跳机制来实现 ,但开发难度复杂;性能相对于其他的通信协议是最优的(客户端的大型网络游戏基本都是Socket通信);传输的数据一般是字符串 ,可读性不强。
Http协议:属于应用层的协议,对Socket进行了封装,HttpClient项目提供了通过java编程发送Http请求。
soap(http+xml):simple object access protocol(简单对象访问协议),xml是无关乎平台与语言的,使用http协议发送和接受xml数据来实现跨平台跨语言的远程调用。实现的技术是即将介绍的WebService。
RPC(Remote Procedure Call Protocol):使用C/S方式,采用http协议,发送请求到服务器,等待服务器返回结果。这个请求包括一个参数集和一个文本集,通常形成“classname.methodname”形式。优点是跨语言跨平台,C端、S端有更大的独立性,缺点是不支持对象,无法在编译器检查错误,只能在运行期检查。流行的RPC框架有gRPC、Thrift、Dubbo。
RMI:RMI是个典型的为java定制的远程通信协议,传输的标准格式是Java Object Stream;基于Java串行化机制将请求的Java Object信息转化为流,传输协议是Socket。缺点是只能基于Java语言。
JMS: JMS是Java的消息服务,JMS的客户端之间可以通过JMS服务进行异步的消息传输。JMS支持两种消息模型:Point-to-Point(P2P)和Publish/Subscribe(Pub/Sub),即点对点和发布订阅模型。 JMS规定的传输格式是Message,将参数信息放入Message中,传输协议不限。
2. WebService技术
WebService是一种跨编程语言和跨操作系统平台的远程调用技术,从表面上看,WebService就是一个应用程序向外界暴露出一个能通过Web进行调用的API,也就是说能用编程的方法通过Web来调用这个应用程序。我们把调用这个WebService的应用程序叫做客户端,而把提供这个WebService的应用程序叫做服务端。从深层次看,WebService是建立可互操作的分布式应用程序的新平台,是一个平台,是一套标准。它定义了应用程序如何在Web上实现互操作性。XML+XSD,SOAP和WSDL是构成WebService平台的三大技术;并且WebService服务提供商可以通过两种方式来暴露它的WSDL文件地址:
1.注册到UDDI服务器,以便被人查找;
2.直接告诉给客户端调用者。
XML+XSD:WebService采用HTTP协议作为传输协议,采用XMl格式封装数据,XML的优点在于它与平台和语言无关,XSD(XML Schema)来定义一套标准的数据类型,无论你使用什么语言的数据类型都会被转换为XSD类型。
SOAP(Simple Object Access Protocol):WebService通过HTTP协议发送请求和接收结果时,发送的请求内容和结果内容都采用XML格式封装,并增加了一些特定的HTTP消息头,以说明HTTP消息的内容格式,这些特定的HTTP消息头和XML内容格式就是SOAP协议。
WSDL:用于描述WebService及其函数、参数和返回值的XML。一些最新的开发工具既能根据你的Web service生成WSDL文档,又能导入WSDL文档,生成调用相应WebService的代理类代码。
UUDI:一种目录服务,企业可以使用它对Webservices进行注册和搜索。
2.1 使用WebService调用第三方接口
http://www.webxml.com.cn/zh_cn/index.aspx此网站提供了发布了的WebService服务。
WebService的调用有三种方式:
http#get
http#post
http#post+xml(soap)
package com.ws.client;
/**
* @desc 国内手机号码归属地查询WEB服务:http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx
* @author yutao
* @create 2018-06-26 9:33
*/
public class MobileCodeService {
/**
* Http GET请求
* @param mobileCode
* @param userID
*/
public void get(String mobileCode,String userID){
try {
URL url = new URL("http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx/getMobileCodeInfo?mobileCode="+mobileCode+"&userID="+userID);
HttpURLConnection httpURLConnection = (HttpURLConnection) url.openConnection();
httpURLConnection.setConnectTimeout(5000); //设置连接超时
httpURLConnection.setRequestMethod("GET"); //GET请求
if (httpURLConnection.getResponseCode()==httpURLConnection.HTTP_OK) { //请求返回码200
InputStream inputStream = httpURLConnection.getInputStream();
ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream(); //内存流
byte[] bytes = new byte[1024];
int len = -1;
while ((len=inputStream.read(bytes))!=-1) {
byteArrayOutputStream.write(bytes,0,len);
}
System.out.println(byteArrayOutputStream.toString()); //返回的是xml字符串
}
} catch (IOException e) {
e.printStackTrace();
}
}
/**
* Http POST请求
* @param mobileCode
* @param userID
*/
public void post(String mobileCode,String userID) {
/** org.apache.commons.httpclient.HttpClient访问网络的实现步骤:
* 1. 准备一个请求客户端:浏览器
* 2. 准备请求方式: GET 、POST
* 3. 设置要传递的参数
* 4.执行请求
* 5. 获取结果
*/
HttpClient httpClient = new HttpClient();
PostMethod postMethod = new PostMethod("http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx/getMobileCodeInfo");
postMethod.setParameter("mobileCode",mobileCode);
postMethod.setParameter("userID",userID);
try {
int code = httpClient.executeMethod(postMethod);
if (code == 200) {
String result = postMethod.getResponseBodyAsString();
System.out.println(result);
}
} catch (IOException e) {
e.printStackTrace();
}
}
/**
* soap 请求(HTTP#POST + xml)
*/
public void soap() {
HttpClient httpClient = new HttpClient();
PostMethod postMethod = new PostMethod("http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx");
try {
File file = new File("F:\\idea\\project\\webservice\\src\\main\\resources\\soap.xml");
InputStreamRequestEntity inputStreamRequestEntity = new InputStreamRequestEntity(new FileInputStream(file),"text/xml; charset=utf-8");
postMethod.setRequestEntity(inputStreamRequestEntity); //设置POST请求请求体
int code = httpClient.executeMethod(postMethod);
if (code == HttpURLConnection.HTTP_OK) {
System.out.println(postMethod.getResponseBodyAsString());
}
} catch (FileNotFoundException e) {
e.printStackTrace();
} catch (HttpException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
public static void main(String[] args) {
MobileCodeService mobileCodeService = new MobileCodeService();
mobileCodeService.get("13456789000","");
}
}
2.1.1 使用WSDL
上述的三种调用方式返回的数据都是xml字符串
<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://WebXml.com.cn/">13456789000:浙江 杭州 浙江移动大众卡</string>
对于这样的数据我们每次取得岂不是都要编写xml解析,显然不是我们希望得到的。通过工具可以根据WebService的WSDL生成对应编程语言的代理类,原理如下图:
WSDL地址:http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?WSDL
使用JDK的wsimport指令生成代理类:
/**
* -d表示输出的.class文件位置,-s表示输出的.java文件位置,-p表示输出的包名
* wsimport无法生成SOAP12、GET、POST请求的代理类
*/
wsimport -d D:/ -s D:/src -p com.ws.proxy http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?WSDL
将生成的源码放入项目上述指定的包中或将生成的class文件打成jar包引入项目中,即可使用。
/**
* 返回的xml都会通过代理类处理成了String字符串或其他集合数据等
*/
public class MobileCodeWSTest {
public static void main(String[] args) {
//获取MobileCodeWS服务
MobileCodeWS ws = new MobileCodeWS();
//获取SOAP请求的服务
MobileCodeWSSoap mobileCodeWSSoap = ws.getMobileCodeWSSoap();
//调用该服务的getMobileCodeInfo方法
String mobileCodeInfo = mobileCodeWSSoap.getMobileCodeInfo("18712343850", "");
System.out.println(mobileCodeInfo);
//调用该服务的getDatabaseInfo方法,ArrayOfString是生成的代理类,通过getString方法返回List集合
ArrayOfString databaseInfo = mobileCodeWSSoap.getDatabaseInfo();
List<String> list = databaseInfo.getString();
for (String s : list) {
System.out.println(s);
}
}
}
2.2 服务端WebService发布
2.2.1 WSDL
http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?WSDL解析如下:
<?xml version="1.0" encoding="utf-8"?>
<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/"
xmlns:tns="http://WebXml.com.cn/" xmlns:s="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/"
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/"
targetNamespace="http://WebXml.com.cn/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"> <!--targetNamespace是命名空间,默认使用cn.com.WebXml作为生成代理类的包-->
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"> <!--文档-->
<a href="http://www.webxml.com.cn/" target="_blank">WebXml.com.cn</a> <strong>国内手机号码归属地查询WEB服务</strong>,提供最新的国内手机号码段归属地数据,每月更新。<br />使用本站 WEB 服务请注明或链接本站:<a href="http://www.webxml.com.cn/" target="_blank">http://www.webxml.com.cn/</a> 感谢大家的支持!<br />&nbsp;
</wsdl:documentation>
<wsdl:types>
<s:schema elementFormDefault="qualified" targetNamespace="http://WebXml.com.cn/">
<s:element name="getMobileCodeInfo"> <!--输入参数信息,对外提供WebService的输入参数类-->
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="mobileCode" type="s:string" /> <!--输入参数名及参数类型-->
<s:element minOccurs="0" maxOccurs="1" name="userID" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="getMobileCodeInfoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="getMobileCodeInfoResult" type="s:string" /> <!--返回参数名及类型-->
</s:sequence>
</s:complexType>
</s:element>
<s:element name="getDatabaseInfo">
<s:complexType />
</s:element>
<s:element name="getDatabaseInfoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="getDatabaseInfoResult" type="tns:ArrayOfString" />
</s:sequence>
</s:complexType>
</s:element>
<s:complexType name="ArrayOfString"> <!-- 服务定义返回的类型,对外提供WebService的类型类 -->
<s:sequence>
<s:element minOccurs="0" maxOccurs="unbounded" name="string" nillable="true" type="s:string" />
</s:sequence>
</s:complexType>
<s:element name="string" nillable="true" type="s:string" />
<s:element name="ArrayOfString" nillable="true" type="tns:ArrayOfString" />
</s:schema>
</wsdl:types>
<wsdl:message name="getMobileCodeInfoSoapIn"> <!--服务端口输入参数信息-->
<wsdl:part name="parameters" element="tns:getMobileCodeInfo" /> <!--参数信息在上面<wsdl:types>中-->
</wsdl:message>
<wsdl:message name="getMobileCodeInfoSoapOut"> <!--服务端口返回参数信息-->
<wsdl:part name="parameters" element="tns:getMobileCodeInfoResponse" /> <!--参数信息在上面<wsdl:types>中-->
</wsdl:message>
<wsdl:message name="getDatabaseInfoSoapIn">
<wsdl:part name="parameters" element="tns:getDatabaseInfo" />
</wsdl:message>
<wsdl:message name="getDatabaseInfoSoapOut">
<wsdl:part name="parameters" element="tns:getDatabaseInfoResponse" />
</wsdl:message>
<wsdl:message name="getMobileCodeInfoHttpGetIn">
<wsdl:part name="mobileCode" type="s:string" />
<wsdl:part name="userID" type="s:string" />
</wsdl:message>
<wsdl:message name="getMobileCodeInfoHttpGetOut">
<wsdl:part name="Body" element="tns:string" />
</wsdl:message>
<wsdl:message name="getDatabaseInfoHttpGetIn" />
<wsdl:message name="getDatabaseInfoHttpGetOut">
<wsdl:part name="Body" element="tns:ArrayOfString" />
</wsdl:message>
<wsdl:message name="getMobileCodeInfoHttpPostIn">
<wsdl:part name="mobileCode" type="s:string" />
<wsdl:part name="userID" type="s:string" />
</wsdl:message>
<wsdl:message name="getMobileCodeInfoHttpPostOut">
<wsdl:part name="Body" element="tns:string" />
</wsdl:message>
<wsdl:message name="getDatabaseInfoHttpPostIn" />
<wsdl:message name="getDatabaseInfoHttpPostOut">
<wsdl:part name="Body" element="tns:ArrayOfString" />
</wsdl:message>
<wsdl:portType name="MobileCodeWSSoap"> <!--服务端口类型,对外提供WebService业务类或接口-->
<wsdl:operation name="getMobileCodeInfo"> <!-- 操作名 -->
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"><br /><h3>获得国内手机号码归属地省份、地区和手机卡类型信息</h3><p>输入参数:mobileCode = 字符串(手机号码,最少前7位数字),userID = 字符串(商业用户ID) 免费用户为空字符串;返回数据:字符串(手机号码:省份 城市 手机卡类型)。</p><br /></wsdl:documentation>
<wsdl:input message="tns:getMobileCodeInfoSoapIn" /> <!--输入参数,对应上面<wsdl:message>-->
<wsdl:output message="tns:getMobileCodeInfoSoapOut" /> <!--返回参数,对应上面<wsdl:message>-->
</wsdl:operation>
<wsdl:operation name="getDatabaseInfo">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"><br /><h3>获得国内手机号码归属地数据库信息</h3><p>输入参数:无;返回数据:一维字符串数组(省份 城市 记录数量)。</p><br /></wsdl:documentation>
<wsdl:input message="tns:getDatabaseInfoSoapIn" />
<wsdl:output message="tns:getDatabaseInfoSoapOut" />
</wsdl:operation>
</wsdl:portType>
<wsdl:portType name="MobileCodeWSHttpGet">
<wsdl:operation name="getMobileCodeInfo">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"><br /><h3>获得国内手机号码归属地省份、地区和手机卡类型信息</h3><p>输入参数:mobileCode = 字符串(手机号码,最少前7位数字),userID = 字符串(商业用户ID) 免费用户为空字符串;返回数据:字符串(手机号码:省份 城市 手机卡类型)。</p><br /></wsdl:documentation>
<wsdl:input message="tns:getMobileCodeInfoHttpGetIn" />
<wsdl:output message="tns:getMobileCodeInfoHttpGetOut" />
</wsdl:operation>
<wsdl:operation name="getDatabaseInfo">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"><br /><h3>获得国内手机号码归属地数据库信息</h3><p>输入参数:无;返回数据:一维字符串数组(省份 城市 记录数量)。</p><br /></wsdl:documentation>
<wsdl:input message="tns:getDatabaseInfoHttpGetIn" />
<wsdl:output message="tns:getDatabaseInfoHttpGetOut" />
</wsdl:operation>
</wsdl:portType>
<wsdl:portType name="MobileCodeWSHttpPost">
<wsdl:operation name="getMobileCodeInfo">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"><br /><h3>获得国内手机号码归属地省份、地区和手机卡类型信息</h3><p>输入参数:mobileCode = 字符串(手机号码,最少前7位数字),userID = 字符串(商业用户ID) 免费用户为空字符串;返回数据:字符串(手机号码:省份 城市 手机卡类型)。</p><br /></wsdl:documentation>
<wsdl:input message="tns:getMobileCodeInfoHttpPostIn" />
<wsdl:output message="tns:getMobileCodeInfoHttpPostOut" />
</wsdl:operation>
<wsdl:operation name="getDatabaseInfo">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"><br /><h3>获得国内手机号码归属地数据库信息</h3><p>输入参数:无;返回数据:一维字符串数组(省份 城市 记录数量)。</p><br /></wsdl:documentation>
<wsdl:input message="tns:getDatabaseInfoHttpPostIn" />
<wsdl:output message="tns:getDatabaseInfoHttpPostOut" />
</wsdl:operation>
</wsdl:portType>
<!-- 服务Soap访问方式 -->
<wsdl:binding name="MobileCodeWSSoap" type="tns:MobileCodeWSSoap"> <!--服务端口类型,对应上面的</wsdl:portType>-->
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" />
<!--该服务提供了以下二种操作-->
<wsdl:operation name="getMobileCodeInfo"> <!--操作名称(对外暴露调用的方法名)-->
<soap:operation soapAction="http://WebXml.com.cn/getMobileCodeInfo" style="document" />
<wsdl:input>
<soap:body use="literal" />
</wsdl:input>
<wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="getDatabaseInfo">
<soap:operation soapAction="http://WebXml.com.cn/getDatabaseInfo" style="document" />
<wsdl:input>
<soap:body use="literal" />
</wsdl:input>
<wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<!-- 服务Soap12访问方式-->
<wsdl:binding name="MobileCodeWSSoap12" type="tns:MobileCodeWSSoap">
<soap12:binding transport="http://schemas.xmlsoap.org/soap/http" />
<wsdl:operation name="getMobileCodeInfo">
<soap12:operation soapAction="http://WebXml.com.cn/getMobileCodeInfo" style="document" />
<wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
<wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="getDatabaseInfo">
<soap12:operation soapAction="http://WebXml.com.cn/getDatabaseInfo" style="document" />
<wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
<wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<!--服务Get访问方式-->
<wsdl:binding name="MobileCodeWSHttpGet" type="tns:MobileCodeWSHttpGet">
<http:binding verb="GET" />
<wsdl:operation name="getMobileCodeInfo">
<http:operation location="/getMobileCodeInfo" />
<wsdl:input>
<http:urlEncoded />
</wsdl:input>
<wsdl:output>
<mime:mimeXml part="Body" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="getDatabaseInfo">
<http:operation location="/getDatabaseInfo" />
<wsdl:input>
<http:urlEncoded />
</wsdl:input>
<wsdl:output>
<mime:mimeXml part="Body" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<!--服务Post访问方式-->
<wsdl:binding name="MobileCodeWSHttpPost" type="tns:MobileCodeWSHttpPost">
<http:binding verb="POST" />
<wsdl:operation name="getMobileCodeInfo">
<http:operation location="/getMobileCodeInfo" />
<wsdl:input>
<mime:content type="application/x-www-form-urlencoded" />
</wsdl:input>
<wsdl:output>
<mime:mimeXml part="Body" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="getDatabaseInfo">
<http:operation location="/getDatabaseInfo" />
<wsdl:input>
<mime:content type="application/x-www-form-urlencoded" />
</wsdl:input>
<wsdl:output>
<mime:mimeXml part="Body" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="MobileCodeWS"> <!--服务名,对外提供WebService的服务类-->
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"><a href="http://www.webxml.com.cn/" target="_blank">WebXml.com.cn</a> <strong>国内手机号码归属地查询WEB服务</strong>,提供最新的国内手机号码段归属地数据,每月更新。<br />使用本站 WEB 服务请注明或链接本站:<a href="http://www.webxml.com.cn/" target="_blank">http://www.webxml.com.cn/</a> 感谢大家的支持!<br />&nbsp;</wsdl:documentation>
<wsdl:port name="MobileCodeWSSoap" binding="tns:MobileCodeWSSoap"> <!--服务端口名及服务访问方式(Soap、Soap12、Get、Post,对应上面的<wsdl:binding>)-->
<soap:address location="http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx" /> <!--服务访问地址-->
</wsdl:port>
<wsdl:port name="MobileCodeWSSoap12" binding="tns:MobileCodeWSSoap12">
<soap12:address location="http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx" />
</wsdl:port>
<wsdl:port name="MobileCodeWSHttpGet" binding="tns:MobileCodeWSHttpGet">
<http:address location="http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx" />
</wsdl:port>
<wsdl:port name="MobileCodeWSHttpPost" binding="tns:MobileCodeWSHttpPost">
<http:address location="http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx" />
</wsdl:port>
</wsdl:service>
</wsdl:definitions>2.2.2 WebService注解
@WebService
/**
* 用于注解在需要作为WebService发布的类或接口上
*/
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE})
public @interface WebService {
//服务端口类型名,修改<wsdl:portType>的name属性
String name() default "";
//命名空间,修改targetNamespaces属性
String targetNamespace() default "";
//服务名,修改<wsdl:service>的name属性
String serviceName() default "";
//端口服务名,修改<wsdl:service>下<wsdl:port>的name属性
String portName() default "";
//wsdl地址,修改wsdl:service>下<*:address>的location属性
String wsdlLocation() default "";
//服务接口全路径, 指定做SEI(Service EndPoint Interface)服务端点接口
String endpointInterface() default "";
}
@WebMethod
/**
* 注释表示作为一项 WebService 操作的方法
*/
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD})
public @interface WebMethod {
//操作名,修改<wsdl:operation>的name属性
String operationName() default "";
//义此操作的行为。对于 SOAP 绑定,此值将确定 SoapAction属性的信息。缺省值为 Java 方法的名称
String action() default "";
//如果为true,方法将不会被发布
boolean exclude() default false;
}
@WebParam
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.PARAMETER})
public @interface WebParam {
//请求参数名,修改<s:sequence>下<xs:element>的name属性
String name() default "";
//修改<wsdl:part>的name属性
String partName() default "";
//指定返回值的 XML 名称空间
String targetNamespace() default "";
//此值表示此方法的参数流的方向
WebParam.Mode mode() default WebParam.Mode.IN;
//指定参数是在Http请求头还是请求体中
boolean header() default false;
public static enum Mode {
IN,
OUT,
INOUT;
private Mode() {
}
}
}
@WebResult
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD})
public @interface WebResult {
//返回参数名,修改<s:sequence>下<xs:element>的name属性
String name() default "";
//指定 RPC 或 DOCUMENT/BARE 操作的结果的部件名称。缺省值为@WebResult.name。(字符串)
String partName() default "";
//指定返回值的 XML 名称空间
String targetNamespace() default "";
//指定响应头中是否附带结果
boolean header() default false;
}
2.2.3 发布示例
@WebService
public interface JobService {
public String getJob(String username);
}
@WebService(
serviceName = "jobServiceWS", //服务名
portName = "jobServiceWsSoap", //服务端口名
name = "jobServiceWSSoapService", //portType名
targetNamespace = "http://job.ws.com" //命名空间 ,默认包名com.ws.job
// endpointInterface = "com.ws.server.service.JobService" //服务端点接口(Service EndPoint Interface),只发布该接口的方法
)
public class JobServiceImpl implements JobService {
@Override
@WebMethod(exclude = false,operationName = "getUserJob")
public @WebResult(name = "job") String getJob(@WebParam(name = "user") String username) {
return "Java工程师";
}
@WebMethod(exclude = true)
public String getAddress() {
return "上海";
}
public static void main(String[] args) {
Endpoint.publish("http://localhost:9090/jobService",new JobServiceImpl());
}
}
2.2.3 CXF框架
Apache CXF 是一个开源的 Services 框架,CXF 帮助您来构建和开发 Services ,这些 Services 可以支持多种协议,比如:SOAP、POST/HTTP、RESTful HTTP, CXF 大大简化了 Service可以天然地和 Spring 进行无缝集成。Apache CXF是 Celtrix (ESB框架)和 XFire(webserivice) 合并而成。
特点:
与Spring、Servlet做了无缝对接,cxf框架里面集成了Servlet容器Jetty
支持注解的方式来发布webservice
能够显示一个webservice的服务列表
能够添加拦截器:输入拦截器、输出拦截器 :输入日志信息拦截器、输出日志拦截器、用户权限认证的拦截器
web.xml
<!-- 添加 CXF 的Servlet ,处理 webservice的请求,类似于SpringMVC的DispatcherServlet -->
<servlet>
<servlet-name>cxf</servlet-name>
<servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
<load-on-startup>0</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>cxf</servlet-name>
<url-pattern>/ws/*</url-pattern>
</servlet-mapping>
@WebService(serviceName="languageManager")
public interface LanguageService {
public @WebResult(name="language")String getLanguage(@WebParam(name="position")int position);
}
public class LanguageServiceImpl implements LanguageService {
/* (non-Javadoc)
* @see cn.it.ws.cxf.a.LanguageService#getLanguage(int)
*/
@Override
public String getLanguage(int position){
String language=null;
switch (position) {
case 1:
language="java";
break;
case 2:
language="C";
break;
case 3:
language="Objective-C";
break;
case 4:
language="C#";
break;
default:
break;
}
return language;
}
}
/**通过cxf框架发布webservice
* 1. ServerFactoryBean
* - 不设置注解也可以发布webservice服务, 不支持注解
* - 不支持拦截器的添加
* 2. JaxWsServerFactoryBean
* - 支持注解
* - 可以添加拦截器
* 3. webservice 访问流程:
* 1. 检测本地代理描述的wsdl是否与服务端的wsdl一致 ,俗称为握手
* 2. 通过soap协议实现通信 ,采用的是post请求 , 数据封装在满足soap规约的xml中
* 3. 返回数据 同样采用的是soap通信, 数据封装在满足soap规约的xml中
*/
public class PubsherWS {
public static void main() {
LanguageService languageService=new LanguageServiceImpl();
//ServerFactoryBean bean=new ServerFactoryBean();
JaxWsServerFactoryBean bean=new JaxWsServerFactoryBean();
//Endpoint :地址 , 实现对象
bean.setAddress("http://192.168.114.10:9999/ws/cxf/languangeService");
bean.setServiceClass(LanguageService.class);//对外提供webservcie的业务类或者接口
bean.setServiceBean(languageService);//服务的实现bean
//添加输入拦截器 :输入显示日志信息的拦截器,ServerFactoryBean 不支持
bean.getInInterceptors().add(new LoggingInInterceptor());
//添加输出拦截器 :输出显示日志信息的拦截器,ServerFactoryBean 不支持
bean.getOutInterceptors().add(new LoggingOutInterceptor());
bean.create();//创建,发布webservice
}
}
实际使用中,WebService都应用于Web项目,需要在Tomcat服务器启动后发布。可以将bean注册到Spring IOC容器中:
<!-- 配置cxf
地址: http://192.168.43.185:8080/CXF_Server/ws/languageOder
组成 : http://192.168.43.185:8080 +CXF_Server( 项目名)+ws(过滤的路径)+/languageOder(自定义部分)
服务类 :
服务的实现类:
拦截器
-->
<bean id="languageService" class="com.ws.cxf.LanguageServiceImpl"></bean>
<jaxws:server serviceName="languageService" address="languageOder" serviceClass="com.ws.cxf.LanguageService">
<jaxws:serviceBean>
<ref bean="languageService"></ref>
</jaxws:serviceBean>
<!-- 配置输入显示日志信息的拦截器 -->
<jaxws:inInterceptors>
<bean class="org.apache.cxf.interceptor.LoggingInInterceptor"></bean>
</jaxws:inInterceptors>
<!-- 配置输出显示日志信息的拦截器 -->
<jaxws:outInterceptors>
<bean class="org.apache.cxf.interceptor.LoggingOutInterceptor"></bean>
</jaxws:outInterceptors>
</jaxws:server>
---------------------
作者:yutao_Struggle
来源:CSDN
原文:https://blog.csdn.net/yutao_struggle/article/details/80829770
版权声明:本文为博主原创文章,转载请附上博文链接!