WebService
一 什么是webservice
1.1 webservice简介
webservice是系统与系统之间调用的技术,也就是一种远程调用技术
1.2 webservice 工作原理
l Webservice是使用Http发送SOAP协议的数据的一种远程调用技术
l Webservice要开发服务端
l Webservice要开发客户端
l Webservice客户端开发需要阅读服务端的使用说明书(WSDL)
1.3 webservice入门程序
1.3.1 接口
public interface WeatherInterface { public String queryWeather(String cityName); }
1.3.2 接口实现类
@WebService//@WebService表示该类是一个服务类,需要发布其中的public的方法 public class WeatherInterfaceImpl implements WeatherInterface { @Override public String queryWeather(String cityName) { System.out.println("from client..."+cityName); String weather = "晴"; return weather; } }
1.3.3 发布
public class WeatherServer { public static void main(String[] args) { Endpoint.publish("http://127.0.0.1:12345/weather", new WeatherInterfaceImpl()); } }
1.3.4 测试服务
l 第四步:测试服务是否发布成功,通过阅读使用说明书,确定客户端调用的接口、方法、参数和返回值存在,证明服务发布成功。
Ø WSDL地址:服务地址+”?wsdl”
Ø WSDL阅读方式:从下往上
1.3.5 客户端生成
开发步骤
l 第一步:wsimport命令生成客户端代码
wsimport -s . http://127.0.0.1:12345/weather?wsdl
l 第二步:根据使用说明书,使用客户端代码调用服务端
Ø 第一步:创建服务视图,视图是从service标签的name属性获取
Ø 第二步:获取服务实现类,实现类从portType的name属性获取
Ø 第三步:获取查询方法,从portType的operation标签获取
1.3.6 客户端调用
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); } }
1.4 webService 优缺点
优点:
l 发送方式采用http的post发送,http的默认端口是80,防火墙默认不拦截80,所以跨防火墙
l 采用XML格式封装数据,XML是跨平台的,所以webservice也可以跨平台。
l Webservice支持面向对象
缺点:
l 采用XML格式封装数据,所以在传输过程中,要传输额外的标签,随着SOAP协议的不断完善,标签越来越大,导致webservice性能下降
1.5 技术场景
1.5.1适用场景
l 发布一个服务(对内/对外),不考虑客户端类型,不考虑性能,建议使用webservice
l 服务端已经确定使用webservice,客户端不能选择,必须使用webservice
1.5.2 不适用场景
l 考虑性能时不建议使用webservice
l 同构程序下不建议使用webservice,比如java 用RMI,不需要翻译成XML的数据
二 Webservice 二要素
2.1 wsdl
2.1.1 什么是wsdl
WSDL及web服务描述语言,他是webservice服务端使用说明书,说明服务端接口、方法、参数和返回值,WSDL是随服务发布成功,自动生成,无需编写
2.1.2 wsdl文档结构
l <service> 服务视图,webservice的服务结点,它包括了服务端点
l <binding> 为每个服务端点定义消息格式和协议细节
l <portType> 服务端点,描述 web service可被执行的操作方法,以及相关的消息,通过binding指向portType
l <message> 定义一个操作(方法)的数据参数(可有多个参数)
l <types> 定义 web service 使用的全部数据类型
2.1.3 详细结构
2.1.4 修改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注解之后,会影响客户端生成的代码。调用的方法名和参数名也发生了变化
2.2 soap
2.2.1 什么是soap
l SOAP即简单对象访问协议,他是使用http发送的XML格式的数据,它可以跨平台,跨防火墙,SOAP不是webservice的专有协议。
l SOAP=http+xml
2.2.3 协议获取方式
2.2.3.1 打开视图
2.2.2 协议的格式
l 必需有 Envelope 元素,此元素将整个 XML 文档标识为一条 SOAP 消息
l 可选的 Header 元素,包含头部信息
l 必需有Body 元素,包含所有的调用和响应信息
l 可选的 Fault 元素,提供有关在处理此消息所发生错误的信息
2.2.3.2 配置代理
2.2.3.3 测试地址
2.2.3.4 修改client的调用端口
修改调用把12345修改成54321
2.2.3.5执行调用获取报文
执行客户端调用 获取报文
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>
三 webservice客户端四种调用方式
3.1 生成客户端调用方式
Wsimport命令介绍
l Wsimport就是jdk提供的的一个工具,他作用就是根据WSDL地址生成客户端代码
l Wsimport位置JAVA_HOME/bin
l Wsimport常用的参数:
Ø -s,生成java文件的
Ø -d,生成class文件的,默认的参数
Ø -p,指定包名的,如果不加该参数,默认包名就是wsdl文档中的命名空间的倒序
l Wsimport仅支持SOAP1.1客户端的生成
调用公网手机号归属地查询服务
第一步:wsimport生成客户端代码
wsimport -p cn.itcast.mobile -s . http://webservice.we bxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl
l 第二步:阅读使用说明书,使用生成客户端代码调用服务端
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); } }
公网天气服务端查询
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); } } }
特点
该种方式使用简单,但一些关键的元素在代码生成时写死到生成代码中,不方便维护,所以仅用于测试。
3.2 service编程调用方式
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); } }
特点
该种方式可以自定义关键元素,方便以后维护,是一种标准的开发方式
3.3 HttpURLConnection调用方式
开发步骤:
第一步:创建服务地址
第二步:打开一个通向服务地址的连接
第三步:设置参数
设置POST,POST必须大写,如果不大写,报如下异常
如果不设置输入输出,会报如下异常
第四步:组织SOAP数据,发送请求
第五步:接收服务端响应,打印
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; } }
3.4 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://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>
四 CXF
4.1 什么是cxf
l CXF是一个开源的webservice框架,提供很多完善功能,可以实现快速开发
l CXF支持的协议:SOAP1.1/1.2,REST
l CXF支持数据格式:XML,JSON(仅在REST方式下支持)
4.2 cxf 安装配置与搭建
l 下载地址
http://cxf.apache.org/download.html
l 包结构介绍
l 安装和配置
Ø 第一步:安装JDK,建议1.7
Ø 第二步:解压apache-cxf-2.7.11.zip到指定目录,创建CXF_HOME
Ø 第三步:把CXF_HOME加入到Path路径下
Ø 第四步:测试,在cmd下加入wsdl2java –h
Ø 如果不想使用IDE(比如Eclipse),需要在环境变量下配置如下信息
项目中build path..引入包的时候,只引入mainifast包。
4.3 cxf创建服务
开发步骤:
第一步:导入Jar包
第二步:创建SEI接口,要加入@WebService
@WebService public interface WeatherInterface { public String queryWeather(String cityName); }
第三步:创建SEI实现类
public class WeatherInterfaceImpl implements WeatherInterface { @Override public String queryWeather(String cityName) { System.out.println("from client..."+cityName); if("北京".equals(cityName)){ return "冷且霾"; } else { return "暖且晴"; } } }
第四步:发布服务, JaxWsServerFactoryBean发布,设置3个参数,1.服务接口;2.服务实现类;3.服务地址;
endpoint仅支持发布实现类,JaxWsServerFactoryBean支持发布接口
public class WeatherServer { public static void main(String[] args) { JaxWsServerFactoryBean jaxWsServerFactoryBean = new JaxWsServerFactoryBean(); jaxWsServerFactoryBean.setServiceClass(WeatherInterface.class); jaxWsServerFactoryBean.setServiceBean(new WeatherInterfaceImpl()); jaxWsServerFactoryBean.setAddress("http://127.0.0.1:12345/weather"); jaxWsServerFactoryBean.create(); } }
第五步:测试服务是否发布成功,阅读使用说明书,确定关键点
如果在CXF发布的服务下,直接访问服务地址,会如下异常
此时直接访问使用说明书地址即可http://127.0.0.1:12345/weather?wsdl
4.4 创建客户端
第一步:生成客户端代码
l Wsdl2java命令是CXF提供的生成客户端的工具,他和wsimport类似,可以根据WSDL生成客户端代码
l Wsdl2java常用参数:
-d,指定输出目录
-p,指定包名,如果不指定该参数,默认包名是WSDL的命名空间的倒序
l Wsdl2java支持SOAP1.1和SOAP1.2
wsdl2java -p com.charles.client http://localhost:8080/queryUser?wsdl
第二步:使用说明书,使用生成代码调用服务端
JaxWsProxyFactoryBean调用服务端,设置2个参数,1.设置服务接口;2.设置服务地址
此时直接访问使用说明书地址即可http://127.0.0.1:12345/weather?wsdl
4.4 创建客户端
第一步:生成客户端代码
l Wsdl2java命令是CXF提供的生成客户端的工具,他和wsimport类似,可以根据WSDL生成客户端代码
l Wsdl2java常用参数:
-d,指定输出目录
-p,指定包名,如果不指定该参数,默认包名是WSDL的命名空间的倒序
l Wsdl2java支持SOAP1.1和SOAP1.2
wsdl2java -p com.charles.client http://localhost:8080/queryUser?wsdl
第二步:使用说明书,使用生成代码调用服务端
JaxWsProxyFactoryBean调用服务端,设置2个参数,1.设置服务接口;2.设置服务地址
public class WeatherClient { public static void main(String[] args) { JaxWsProxyFactoryBean jaxWsProxyFactoryBean = new JaxWsProxyFactoryBean(); jaxWsProxyFactoryBean.setServiceClass(WeatherInterface.class); jaxWsProxyFactoryBean.setAddress("http://127.0.0.1:12345/weather"); WeatherInterface weatherInterface = jaxWsProxyFactoryBean.create(WeatherInterface.class); String weather = weatherInterface.queryWeather("北京"); System.out.println(weather); } }
五 spring整合cxf发布soap
5.1 服务端开发
第一步:创建web项目(引入jar包)
<dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-frontend-jaxws</artifactId> <version>${cxf.version}</version> </dependency> <dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-transports-http</artifactId> <version>${cxf.version}</version> </dependency> <dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-transports-http-jetty</artifactId> <version>${cxf.version}</version> <scope>provided</scope> </dependency>
第二步:创建SEI接口
@WebService public interface IWeatherService { @WebResult(name="result") public String getA(String a); }
第三步:创建SEI实现类
public class WeatherServiceIm implements IWeatherService { public String getA(String a) { return "fsa"; } }
第四步:配置spring配置文件,applicationContext.xml,用<jaxws:server标签发布服务,设置1.服务地址;2.设置服务接口;3设置服务实现类
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context" xmlns:aop="http://www.springframework.org/schema/aop" xmlns:cxf="http://cxf.apache.org/core" xmlns:jaxws="http://cxf.apache.org/jaxws" xmlns:jaxrs="http://cxf.apache.org/jaxrs" xmlns:jpa="http://www.springframework.org/schema/data/jpa" xmlns:tx="http://www.springframework.org/schema/tx" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.2.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.2.xsd http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd http://cxf.apache.org/jaxrs http://cxf.apache.org/schemas/jaxrs.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.2.xsd "> <bean id="ps" class="yonyon.xiao.serviceIm.WeatherServiceIm"></bean> <!-- 服务 --> <jaxws:server address="/weather" serviceClass="yonyon.xiao.worn.IWeatherService"> <jaxws:serviceBean> <ref bean="ps"/> </jaxws:serviceBean> </jaxws:server> </beans>
第五步:配置web.xml,配置spring配置文件地址和加载的listener,配置CXF的servlet
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5"> <display-name>yonyou--webservice</display-name> <context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:spring/spring-*.xml</param-value> </context-param> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <!-- cxf的地址映射 --> <servlet> <servlet-name>CXF</servlet-name> <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>CXF</servlet-name> <url-pattern>/ws/*</url-pattern> </servlet-mapping> </web-app>
第六步:部署到tomcat下,启动tomcat
第七步:测试服务,阅读使用说明书
WSDL地址规则:http://ip:端口号/项目名称/servlet拦截路径/服务名称?wsdl
http://localhost:8080/yon-webservice/ws/weather?wsdl
拦截器配置
发布方式二
实现类
@WebService public class SayHelloClas { public String SayHello(){ return "haha"; } }
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context" xmlns:aop="http://www.springframework.org/schema/aop" xmlns:cxf="http://cxf.apache.org/core" xmlns:jaxws="http://cxf.apache.org/jaxws" xmlns:jaxrs="http://cxf.apache.org/jaxrs" xmlns:jpa="http://www.springframework.org/schema/data/jpa" xmlns:tx="http://www.springframework.org/schema/tx" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.2.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.2.xsd http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd http://cxf.apache.org/jaxrs http://cxf.apache.org/schemas/jaxrs.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.2.xsd "> <bean id="ps" class="yonyon.xiao.serviceIm.WeatherServiceIm"></bean> <!-- 服务 --> <jaxws:server address="/weather" serviceClass="yonyon.xiao.worn.IWeatherService"> <jaxws:serviceBean> <ref bean="ps"/> </jaxws:serviceBean> </jaxws:server> <jaxws:endpoint address="/hello" implementor="yonyon.xiao.serviceIm.SayHelloClas"></jaxws:endpoint> </beans> <?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5"> <display-name>yonyou--webservice</display-name> <context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:spring/spring-*.xml</param-value> </context-param> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <servlet> <servlet-name>CXF</servlet-name> <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>CXF</servlet-name> <url-pattern>/ws/*</url-pattern> </servlet-mapping> </web-app>
测试地址 http://localhost:8080/yon-webservice/ws
5.2 客户端开发
第一步:引入jar包
第二步:生成客户端代码
第三步:配置spring配置文件,applicationContent.xml
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:jaxws="http://cxf.apache.org/jaxws" xmlns:jaxrs="http://cxf.apache.org/jaxrs" xmlns:cxf="http://cxf.apache.org/core" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://cxf.apache.org/jaxrs http://cxf.apache.org/schemas/jaxrs.xsd http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd http://cxf.apache.org/core http://cxf.apache.org/schemas/core.xsd"> <!-- <jaxws:client实现客户端 ,对JaxWsProxyFactoryBean类封装--> <jaxws:client id="weatherClient" address="http://127.0.0.1:8080/yon-webservice/ws/weather" serviceClass="cn.itcast.cxf.weather.WeatherInterface"/> </beans>
第四步:从spring上下文件获取服务实现类
第五步:调用查询方法,打印
public class WeatherClient { public static void main(String[] args) { ApplicationContext context = new ClassPathXmlApplicationContext("classpath:applicationContext.xml"); WeatherInterface weatherInterface = (WeatherInterface) context.getBean("weatherClient"); String weather = weatherInterface.queryWeather("保定"); System.out.println(weather); } }
六 cxf发布rest服务
第一步:导入jar包
第二步:创建学生pojo类,要加入@ XmlRootElement
第三步:创建SEI接口
第四步:创建SEI实现类
public class Student { private String id; private String name; public String getId() { return id; } public void setId(String id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; }}
@WebService @Path(value="/student") public interface IStudentService { @Path(value="/query/{id}") @Produces(MediaType.APPLICATION_ATOM_XML) @GET public Student queryById(@PathParam("id") String id); @Path(value="/querylist/{name}") @Produces("application/json;charset=utf-8") @GET public List<Student> queryByName(@PathParam("name") String name); }
第四步:创建SEI实现类
public class StudentServiceIm implements IStudentService{ @Override public Student queryById(String id) { // TODO Auto-generated method stub Student s=new Student(); s.setId("111111"); s.setName("张三"); return s; } @Override public List<Student> queryByName(String name) { // TODO Auto-generated method stub Student s=new Student(); s.setId("111111"); s.setName("张三"); Student s1=new Student(); s1.setId("111111"); s1.setName("张三"); List li=new ArrayList(); li.add(s); li.add(s1); return li; }
第五步:发布服务, JAXRSServerFactoryBean发布服务,3个参数,1:服务实现类;2.设置资源类;3.设置服务地址
public static void main(String[] args) { JAXRSServerFactoryBean refa=new JAXRSServerFactoryBean(); refa.setServiceBean(StudentServiceIm.class); refa.setResourceClasses(Student.class,StudentServiceIm.class); refa.setAddress("http://127.0.0.1:12345/user"); refa.create(); }
测试地址
地址1:http://127.0.0.1:12345/user/student/query/1
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><student><id>111111</id><name>寮犱笁</name></student>
地址2 http://127.0.0.1:12345/user/student/querylist/1
{"student":[{"id":111111,"name":"张三"},{"id":111111,"name":"张三"}]}
如果服务端发布时指定请求方式是GET(POST),客户端必须使用GET(POST)访问服务端,否则会报如下异常
如果在同一方法上同时指定XML和JSON媒体类型,在GET请求下,默认返回XML,在POST请求下,默认返回JSON
如果在同一方法上同时指定XML和JSON媒体类型,在GET请求下,默认返回XML,在POST请求下,默认返回JSON
七 spring整合cxf发布rest
开发步骤:
第一步:创建web项目(引入jar包)
第二步:创建POJO类
@XmlRootElement public class Student { private String id; private String name; public String getId() { return id; } public void setId(String id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } }
第三步:创建SEI接口
@WebService @Path(value="/student") public interface IStudentService { @Path(value="/query/{id}") @Produces(MediaType.APPLICATION_ATOM_XML) @GET public Student queryById(@PathParam("id") String id); @Path(value="/querylist/{name}") @Produces({"application/json;charset=utf-8",MediaType.APPLICATION_ATOM_XML}) @GET public List<Student> queryByName(@PathParam("name") String name); }
第四步:创建SEI实现类
public class StudentServiceIm implements IStudentService{ @Override public Student queryById(String id) { // TODO Auto-generated method stub Student s=new Student(); s.setId("111111"); s.setName("张三"); return s; } @Override public List<Student> queryByName(String name) { // TODO Auto-generated method stub Student s=new Student(); s.setId("111111"); s.setName("张三"); Student s1=new Student(); s1.setId("111111"); s1.setName("张三"); List li=new ArrayList(); li.add(s); li.add(s1); return li; } }
第五步:配置Spring配置文件,applicationContext.xml,<jaxrs:server,设置1.服务地址;2.服务实现类
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context" xmlns:aop="http://www.springframework.org/schema/aop" xmlns:cxf="http://cxf.apache.org/core" xmlns:jaxws="http://cxf.apache.org/jaxws" xmlns:jaxrs="http://cxf.apache.org/jaxrs" xmlns:jpa="http://www.springframework.org/schema/data/jpa" xmlns:tx="http://www.springframework.org/schema/tx" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.2.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.2.xsd http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd http://cxf.apache.org/jaxrs http://cxf.apache.org/schemas/jaxrs.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.2.xsd "> <jaxrs:server address="/student" > <jaxrs:serviceBeans> <ref bean="studentservice"/> </jaxrs:serviceBeans> </jaxrs:server> <bean name="studentservice" class="yonyon.xiao.serviceIm.StudentServiceIm"></bean> </beans>
第六步:配置web.xml
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5"> <display-name>yon-webservice</display-name> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> <context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:spring/spring-*.xml</param-value> </context-param> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <!-- cxf的地址映射 --> <servlet> <servlet-name>CXF</servlet-name> <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>CXF</servlet-name> <url-pattern>/ws/*</url-pattern> </servlet-mapping> </web-app>
第七步:部署到tomcat下,启动tomcat
第八步:测试服务
REST服务的使用说明书地址:
http://localhost:8080/yon-webservice/ws/student?_wadl