SpringBoot集成WebService

由于项目要用到webservice，我自己用springboot来整合试了下，遂有了下述的记录。

1.什么是webservice

简单来说,webservice就是远程调用技术,也叫XML Web Service. WebService是一种可以接收从Internet上其它系统中传递过来的请求，轻量级的独立的通讯技术。

XML：(Extensible Markup Language)扩展型可标记语言。面向短期的临时数据处理、面向万维网络，是SOAP的基础。

SOAP：(Simple Object Access Protocol)简单对象存取协议。是XML Web Service 的通信协议。当用户通过UDDI找到你的WSDL描述文档后，他通过可以SOAP调用你建立的Web服务中的一个或多个操作。SOAP是XML文档形式的调用方法的规范，它可以支持不同的底层接口，像HTTP(S)或者SMTP。

WSDL：(Web Services Description Language) WSDL 文件是一个 XML 文档，用于说明一组 SOAP 消息以及如何交换这些消息。大多数情况下由软件自动生成和使用。

我们一般是在具体平台开发 webservice 接口，以及调用 webservice 接口，每种开发语言都有自己的 webservice 实现框架。比如 Java 就有 Apache Axis1、Apache Axis2、Codehaus XFire、Apache CXF、Apache Wink、Jboss RESTEasyd 等等。其中 Apache CXF 用的比较多，它也可以和 Spring Boot 整合。

2、集成webservice

1、新建一个springboot项目，引入相关依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web-services</artifactId>
</dependency>

<dependency>
    <groupId>org.apache.cxf</groupId>
    <artifactId>cxf-rt-frontend-jaxws</artifactId>
    <version>3.1.6</version>
</dependency>
<dependency>
    <groupId>org.apache.cxf</groupId>
    <artifactId>cxf-rt-transports-http</artifactId>
    <version>3.1.6</version>
</dependency>

<!--lombok-->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

2、服务端接口定义

/**
 * 本地访问的地址为：http://localhost:8088/ContentDeployResult
 */
@WebService(name = "ContentDeployResult")
public interface CDNResponse {
    @WebMethod
    CommonXmlResponse ContentDeployResult(@WebParam(name = "CMSID", targetNamespace = "iptv") String CMSID,
                                          @WebParam(name = "SOPID", targetNamespace = "iptv") String SOPID,
                                          @WebParam(name = "CorrelateID", targetNamespace = "iptv") String CorrelateID,
                                          @WebParam(name = "ResultCode", targetNamespace = "iptv") Integer ResultCode,
                                          @WebParam(name = "ErrorDescription", targetNamespace = "iptv") String ErrorDescription,
                                          @WebParam(name = "ResultFileURL", targetNamespace = "iptv") String ResultFileURL,
                                          @WebParam(name = "XMLURLQC", targetNamespace = "iptv") String XMLURLQC, //xml MD5摘要
                                          @WebParam(name = "Encrypt", targetNamespace = "iptv") String Encrypt); //加密校验字符串// );
}

3、服务端接口的实现

@Slf4j
public class CDNResponseImpl implements CDNResponse {

    @Override
    public CommonXmlResponse ContentDeployResult(String CMSID,
                                                 String SOPID,
                                                 String CorrelateID,
                                                 Integer ResultCode,
                                                 String ErrorDescription,
                                                 String ResultFileURL,
                                                 String XMLURLQC,
                                                 String Encrypt) {
        //1、封装传递进来的参数

        //2、对参数进行校验

        //3、处理CDN回调的逻辑
        return null;
    }
}

4、cxf 服务配置

package com.zhjt.cms.config;

import com.zhjt.cms.intf.webservice.cdn.CDNResponse;
import org.apache.cxf.Bus;
import org.apache.cxf.bus.spring.SpringBus;
import org.apache.cxf.jaxws.EndpointImpl;
import org.apache.cxf.transport.servlet.CXFServlet;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.web.servlet.ServletRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import javax.xml.ws.Endpoint;


@Configuration
public class CxfConfig {
    @Autowired
    private CDNResponse cdnResponse;

    /**
     * 注入servlet  bean name不能dispatcherServlet 否则会覆盖dispatcherServlet
     * @return
     */
    @Bean(name = "cxfServlet")
    public ServletRegistrationBean<CXFServlet> cxfServlet() {
        return new ServletRegistrationBean<>(new CXFServlet(),"/*");
    }


    @Bean(name = Bus.DEFAULT_BUS_ID)
    public SpringBus springBus() {
        return new SpringBus();
    }

    /**
     * 注册WebServiceDemoService接口到webservice服务
     * @return
     */
    @Bean(name = "ContentDeployResult")
    public Endpoint sweptPayEndpoint() {
        EndpointImpl endpoint = new EndpointImpl(springBus(), cdnResponse);
        endpoint.publish("/ContentDeployResult");
        return endpoint;
    }

}

5、启动项目，用soapui来模拟请求即可。