1 课程回顾

l 什么是webservice

远程调用技术：系统和系统之间的调用，获取远程系统里的业务数据
Webservice使用http传输SOAP协议的数据的一种远程调用技术

l Webservice入门程序

服务端

n 第一步：创建SEI接口

n 第二步：创建SEI实现类，加入@WebService

n 第三步：发布服务，用Endpoint的publish方法，两个参数，1.服务地址；2.实现类

n 第四步：测试服务，通过阅读使用说明书，确定接口、方法、参数和返回值存在，说明书服务发布成功

u WSDL地址：服务地址+?wsdl

u WSDL阅读方式：从下往上，service>binding>portType>方法、参数和返回值

客户端

n 第一步：使用wsimport命令生成客户端代码

n 第二步：创建服务视图，从service的name属性获取

n 第三步：获取服务类，从portType的name属性获取

n 第四步：调用查询方法，从operation标签的name属性获取

Webservice优缺点：

n 优点：使用http发送数据，跨防火墙；使用XML封装数据，跨平台；支持面向对象

n 缺点：使用XML封装，需要额外传输标签，性能较差

l Webservice应用场景

宏观

n 软件集成和复用

微观

n 适用场景：

u 不考虑性能，不考虑客户端类型，建议使用webservice

u 服务端已经确定webservice，客户端只能使用webservice

n 不适用：

u 考虑性能时，不建议使用webservice

u 同构程序不建议使用webservice。

l Webservice三要素

WSDL:

n 定义：web服务描述语言，他是webservice服务端的使用说明书，说明服务、接口、方法、参数和返回值，他是伴随服务发布成功，自动生成，无需编写

n 文档结构：

u Service

u Binding

u portType

u message

u types

n 阅读方式：从下往上

SOAP:

n 定义：SOAP即简单对象访问协议，他是使用http传输XML格式的数据，跨平台，跨防火墙，他不是webservice专有协议

n Soap=http+xml

n 协议格式：

u 必有：envelope和body

u 非必有：header和fault

n SOAP1.1和1.2区别

u 相同点：

都是用POST发送请求

协议格式都相同：都有envelope和body标签

u 不同点

Content-type不同：

SOAP1.1，text/xml;charset=utf-8;SOAP1.2,application/soap+xml;charset=utf-8

命名空间不同：

l Webservice的四种客户端调用方式

生成客户端的调用方式
Service编程调用方式
HttpURLConnecton调用方式
Ajax调用方式

l 深入开发：用注解修改WSDL内容

@Webservice
@WebMethod
@WebParam
@WebResult
修改完WSDL之后，需要重新生成客户端

CXF

2 课程安排：

l CXF的介绍、安装和配置

l CXF发布SOAP协议的服务

l CXF+Spring整合发布SOAP的服务

l CXF发布REST服务

什么是REST

l CXF+Spring整合发布REST服务

l 综合案例

3 CXF介绍、安装和配置

3.1 CXF介绍

l CXF是一个开源的webservice框架，提供很多完善功能，可以实现快速开发

l CXF支持的协议：SOAP1.1/1.2，REST

l CXF支持数据格式：XML，JSON（仅在REST方式下支持）

3.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），需要在环境变量下配置如下信息

4 CXF发布SOAP协议的服务

4.1 需求

服务端：发布服务，接收客户端的城市名，返回天气数据给客户端

客户端：发送城市名给服务端，接收服务端的响应信息，打印

4.2 实现

4.2.1 服务端

开发步骤：

第一步：导入Jar包

第二步：创建SEI接口，要加入@WebService

package cn.itcast.ws.cxf.server;

import javax.jws.WebService;

/**

* Title: WeatherInterface.java

* Description:SEI接口

* Company: www.itcast.com

* @author 传智.at

* @date 2015年11月27日上午9:47:43

* @version 1.0

@WebService

public interface WeatherInterface {

public String queryWeather(String cityName);

}

第三步：创建SEI实现类

package cn.itcast.ws.cxf.server;

/**

* Title: WeatherInterfaceImpl.java

* Description:SEI实现类

* Company: www.itcast.com

* @author 传智.at

* @date 2015年11月27日上午9:50:59

* @version 1.0

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支持发布接口。

package cn.itcast.ws.cxf.server;

import org.apache.cxf.jaxws.JaxWsServerFactoryBean;

import org.apache.cxf.tools.java2wsdl.processor.internal.jaxws.generator.JaxwsServerGenerator;

/**

* Title: WeatherServer.java

* Description:服务端

* Company: www.itcast.com

* @author 传智.at

* @date 2015年11月27日上午9:51:36

* @version 1.0

public class WeatherServer {

public static void main(String[] args) {

//JaxWsServerFactoryBean发布服务

JaxWsServerFactoryBean jaxWsServerFactoryBean = new JaxWsServerFactoryBean();

//设置服务接口

jaxWsServerFactoryBean.setServiceClass(WeatherInterface.class);

//设置服务实现类

jaxWsServerFactoryBean.setServiceBean(new WeatherInterfaceImpl());

//设置服务地址

jaxWsServerFactoryBean.setAddress("http://127.0.0.1:12345/weather");

//发布

jaxWsServerFactoryBean.create();

}

第五步：测试服务是否发布成功，阅读使用说明书，确定关键点

如果在CXF发布的服务下，直接访问服务地址，会如下异常

此时直接访问使用说明书地址即可

4.2.1.1 发布SOAP1.2的服务端

l 在接口上加入如下注解：

@BindingType(SOAPBinding.SOAP12HTTP_BINDING)

l 重新发布服务端

4.2.1.2 拦截器

l 原理：

拦截器可以拦截请求和响应
拦截器可以有多个
拦截器可以根据需要自定义

l 使用

拦截器必须加到服务端，在服务端发布之前

获取拦截器列表，将自己的拦截器加入列表中

4.2.2 客户端

第一步：生成客户端代码

l Wsdl2java命令是CXF提供的生成客户端的工具，他和wsimport类似，可以根据WSDL生成客户端代码

l Wsdl2java常用参数：

-d，指定输出目录

-p，指定包名，如果不指定该参数，默认包名是WSDL的命名空间的倒序

l Wsdl2java支持SOAP1.1和SOAP1.2

第二步：使用说明书，使用生成代码调用服务端

JaxWsProxyFactoryBean调用服务端，设置2个参数，1.设置服务接口；2.设置服务地址

package cn.itcast.cxf.client;

import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;

import cn.itcast.cxf.weather.WeatherInterface;

/**

* Title: WeatherClient.java

* Description:客户端

* Company: www.itcast.com

* @author 传智.at

* @date 2015年11月27日上午10:12:24

* @version 1.0

public class WeatherClient {

public static void main(String[] args) {

//JaxWsProxyFactoryBean调用服务端

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);

}

5 CXF+Spring整合发布SOAP协议的服务

5.1 服务端

开发步骤：

第一步：创建web项目（引入jar包）

第二步：创建SEI接口

第三步：创建SEI实现类

第四步：配置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: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:server address="/weather" serviceClass="cn.itcast.ws.cxf.server.WeatherInterface">

<jaxws:serviceBean>

</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" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0">

<display-name>ws_2_cxf_spring_server</display-name>

<context-param>

<param-name>contextConfigLocation</param-name>

<param-value>classpath:applicationContext.xml</param-value>

</context-param>

<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>

</listener>

<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>

<welcome-file-list>

<welcome-file>index.html</welcome-file>

<welcome-file>index.htm</welcome-file>

<welcome-file>index.jsp</welcome-file>

<welcome-file>default.html</welcome-file>

<welcome-file>default.htm</welcome-file>

<welcome-file>default.jsp</welcome-file>

</welcome-file-list>

</web-app>

第六步：部署到tomcat下，启动tomcat

第七步：测试服务，阅读使用说明书

WSDL地址规则：http://ip:端口号/项目名称/servlet拦截路径/服务名称?wsdl

5.1.1 拦截器配置

配置applicationContext.xml中。

5.1.2 Endpoint标签发布服务

<jaxws:endpoint>标签

package cn.itcast.ws.cxf.server;

import javax.jws.WebService;

/**

* Title: HelloWorld.java

* Description:简单类

* Company: www.itcast.com

* @author 传智.at

* @date 2015年11月27日上午11:11:10

* @version 1.0

@WebService

public class HelloWorld {

public String sayHello(String name){

return "hello,"+name;

}

5.2 客户端

开发步骤：

第一步：引入jar包

第二步：生成客户端代码

第三步：配置spring配置文件，applicationContent.xml