webservice之jax-ws实现方式(服务端)

1.什么是webservice?

webservice是一种远程资源调用技术，它的实现方式主要分为两种，

第一种是jaxws方式,它是面向方法的，它的数据类型是xml是基于soap实现传输；

第二种是jaxrs方式,它是面向资源的，它的数据类型是xml或json是基于http协议实现传输。

2.jaxws简单应用

  服务端：

第一步：创建一个简单的web项目，略 

第二步：添加webService的依赖jar包，配置web.xml

 <dependency>
        <groupId>org.apache.cxf</groupId>
        <artifactId>cxf-rt-frontend-jaxws</artifactId>
        <version>3.0.1</version>
    </dependency>
注：版本需与springboot对应 否则启动就会报错
在https://mvnrepository.com/artifact/org.apache.cxf/cxf-spring-boot-starter-jaxws查找到jaxws的各种版本，进入之后可以看到对应的springboot版本

问题详情：
Description:

Parameter 1 of constructor in org.springframework.boot.autoconfigure.web.servlet.error.ErrorMvcAutoConfiguration required a bean of type ‘org.springframework.boot.autoconfigure.web.servlet.DispatcherServletPath’ that could not be found.

The following candidates were found but could not be injected:
- Bean method ‘dispatcherServletRegistration’ in ‘DispatcherServletAutoConfiguration.DispatcherServletRegistrationConfiguration’ not loaded because DispatcherServlet Registration found non dispatcher servlet dispatcherServlet

Action:

Consider revisiting the entries above or defining a bean of type ‘org.springframework.boot.autoconfigure.web.servlet.DispatcherServletPath’ in your configuration.

Process finished with exit code 1
 

第三步：编写代码

import com.test.demo.service.IDataReceiverService;
import org.apache.cxf.Bus;
import org.apache.cxf.jaxws.EndpointImpl;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import javax.xml.ws.Endpoint;

/**
 * 〈cxf配置〉
 * 默认:services
 * http://127.0.0.1:6689/services/receiveData
 * cxf-path配置路径：
 * http://127.0.0.1:6689/soap/receiveData
 */
@Configuration
public class CxfConfig {

    @Autowired
    private Bus bus;

    @Autowired
    private IDataReceiverService dataReceiverService;


    /**
     * 数据站点服务（总入口）
     *
     * @return
     */
    @Bean
    public Endpoint getReceiveData() {
        EndpointImpl endpoint = new EndpointImpl(bus, dataReceiverService);
        endpoint.publish("/receiveData");
        return endpoint;
    }

}

package com.test.demo.service;


import com.test.demo.entity.ReceiveMsg;

import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;

/**
 * 接收数据处理服务类
 *
 * @Author: zhangt
 * @Date: 2021/9/11 11:46
 */

@WebService
public interface IDataReceiverService {


    /**
     * 接收数据接口
     *
     * @param receiveMsg 数据
     * @return
     */
    @WebMethod
    String getReceiveMsg(@WebParam(name = "ROOT") ReceiveMsg receiveMsg);

}

package com.test.demo.service.impl;

import cn.hutool.core.collection.CollUtil;
import cn.hutool.core.convert.Convert;
import com.test.demo.entity.ReceiveMsg;
import com.test.demo.entity.ResultMsg;
import com.test.demo.entity.UploadData;
import com.test.demo.service.IDataReceiverService;
import com.test.demo.util.ReceiveMsgUtil;
import lombok.extern.slf4j.Slf4j;
import org.dom4j.DocumentException;
import org.springframework.stereotype.Component;

import javax.jws.WebService;
import java.util.List;
import java.util.Map;

@WebService(serviceName = "receiverService", // 与接口中指定的name一致
        targetNamespace = "http://service.demo.test.com", // 与接口中的命名空间一致,一般是接口的包名倒序排
        endpointInterface = "com.test.demo.service.IDataReceiverService"// 接口地址
)
@Slf4j
@Component
public class DataReceiverServiceImpl implements IDataReceiverService {

    /**
     * 接收数据接口
     *
     * @param receiveMsg 数据
     * @return
     */
    @Override
    public String getReceiveMsg(ReceiveMsg receiveMsg) {

        //解析报文，转化为需要写成文件的数据
        UploadData uploadData = new UploadData();
        String dataId = receiveMsg.getDATAID();
        uploadData.setDataId(dataId);
        //是否加密 （1 表示业务数据为密文传输，0 表示明文）
        int sec = Convert.toInt(receiveMsg.getSEC());
        uploadData.setHavePwd(sec);

        //数据为明文时
        if (1 == sec) {
            //解码业务报文
            try {
                //获取解密后的业务数据
                String data = ReceiveMsgUtil.decodeStr(receiveMsg.getBUSINESSCONTENT());
                List<Map<String, Object>> list = ReceiveMsgUtil.xmlToList(data);
                log.info("数据为list：{}", list);
                uploadData.setBusinessData(list);
                if (CollUtil.isEmpty(list)) {
                    return ResultMsg.getMessage(ResultMsg.BUSINESS_DATA_ANALYZE_ERROR);
                }
            } catch (DocumentException e) {
                log.info("xml数据格式不正确！", e);
                return ResultMsg.getMessage(ResultMsg.XML_ERROR);
            } catch (Exception e) {
                log.info("base64解码错!", e);
                return ResultMsg.getMessage(ResultMsg.BASE64_ERROR);
            }
        }

        return ResultMsg.getMessage(ResultMsg.SUCCESS);
//        return uploadData.getReplyData();
    }

}

server:
  port: 6689
spring:
  application:
    name: cxfDemo
#  profiles:
#    active: dev
cxf:
  path: /soap #默认services

 第四步：启动项目，查看wsdl说明书

 这里面的路径注意cxf在web中的配置：

 

参数说明：

@WebService：在接口上申明，表示该接口是一个webService服务；
@WebMethod：在接口方法上声明，表示该方法是一个webService服务方法；

@WebService(endpointInterface="cn.linc.cxf.interfaces.ServiceUI",serviceName="userService")：在该接口实现类定义；

endpointInterface：表示接口服务终端接口名；
serviceName:服务名称；
wsdl解读：有五个节点：服务视图，服务协议和参数的描述，服务实现，参数描述，参数类型描述。

调用展示：

原理解析：
　　可以分为三个角色：服务提供者，服务消费者，服务注册中心uddi
　　首先由服务提供者发布服务并且在注册中心uddi进行注册
　　然后由服务消费者订阅服务，在注册中心uddi上查询到符合条件的服务
　　服务注册中心返回服务条件服务的描述文件给服务订阅者
　　订阅者根据描述文件进行服务端的服务调用，并返回数据。

工具：

加解密：https://tool.oschina.net/encrypt

soapUI:https://www.soapui.org/downloads/soapui/

参考：

https://blog.csdn.net/qiaodaima0/article/details/100765613

https://www.cnblogs.com/xiechenglin/p/10500558.html

https://www.cnblogs.com/shuaijie/articles/5913750.html