webService速通教学（送源码）

什么是WebService

webService是一种古老的互联网通讯方法。通过http通讯，将数据封装成XML的形式在网络中传输。习惯Java开发的伙伴肯定会对其嗤之以鼻，为什么不用Json传输，为什么不直接通过url拼参数？最大的两个因素是：
1，兼顾老系统，总所周知，在事业单位中几十年的老系统屡见不鲜。他们直接的通讯方式肯定是webService，所以为了而兼容他们沿用旧技术。
2，兼顾不同语言编写的计算机系统。银行柜台机，工厂车床等。很多是.net开发计算机系统。对于他们Java习惯的方式，他们可能不适配，所以通过webService将数据转换成XML的形式。大家都可以接受。

创建服务端

导包

 		 <dependency>
            <groupId>org.apache.cxf</groupId>
            <artifactId>cxf-rt-frontend-jaxws</artifactId>
            <version>3.1.12</version>
        </dependency>

        <dependency>
            <groupId>org.apache.cxf</groupId>
            <artifactId>cxf-rt-transports-http</artifactId>
            <version>3.1.12</version>
        </dependency>

先写接口

package com.zxl.online.api;

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

@WebService
public interface WSAPI {
    @WebMethod
    String getInfo();
}

再写实现类

package com.zxl.online.api.impl;

import com.zxl.online.api.NumberConstant;
import com.zxl.online.api.ResponseMessage;
import com.zxl.online.api.WSAPI;
import com.zxl.online.api.phoneEntity;

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

@WebService(targetNamespace = "http://api.online.zxl.com/", endpointInterface = "com.zxl.online.api.WSAPI")
public class WSImp implements WSAPI {


    public WSImp(){

    }
    @Override
    public String getInfo() {
       
        return "成功调用！";
    }

    
}

注意！

这里一定要填对，不然客户端会调用失败！

最后是配置类

package com.zxl.online.api;

import com.zxl.online.api.impl.WSImp;
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.boot.web.servlet.ServletRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class WSConfig {

    //默认servlet路径/*,如果覆写则按照自己定义的来
    @Bean
    public ServletRegistrationBean cxfServlet() {
        return new ServletRegistrationBean(new CXFServlet(),
        "/webservice/*");
    }

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

    //把实现类交给spring管理
    @Bean
    public WSAPI webService() {
        return new WSImp();
    }

    //终端路径
    @Bean
    public EndpointImpl endpoint() {
        EndpointImpl endpoint = new EndpointImpl(springBus(),webService());
        endpoint.publish("/test");
        return  endpoint;
    }
}

成功启动

创建客户端

SOAPUI进行测试

下载地址
soapui是一款成熟的，受欢迎的网络请求测试工具。用来测试webService非常方便！

填入链接

自动解析

进行测试

代码测试

简单测试

//测试本地服务端
    @GetMapping("/testWebService")
    public void testSend1() {
        // 创建动态客户端
        JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
        Client client =
                dcf.createClient("http://127.0.0.1:1000/webservice/test?wsdl");

        // 需要密码的情况需要加上用户名和密码
        // client.getOutInterceptors().add(new ClientLoginInterceptor(USER_NAME,PASS_WORD));
        Object[] objects = new Object[0];
        try {
            // invoke("方法名",参数1,参数2,参数3....);
            objects = client.invoke("getInfo");
            System.out.println("返回数据:" + objects[0]);
        } catch (java.lang.Exception e) {
            e.printStackTrace();
        }
    }

这种测试方法是不成熟的，自己玩玩可以。放在工作中是不成熟的行为

生成客户端

这里我们就不测自己的了，测一个通过电话获取位置信息的网络接口，以模拟实战。

生成代码

我们在idea中的控制台，使用jdk自带的方法，进行生成（避免编译器产生的版本问题）

wsimport  -encoding utf-8 -s . http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl

将他拉入咱们的工程中，
可能会出现拉不动的情况，我们在idea中右键点击“open in explorer”在windows文件管理器中自由拖动

测试

 //测试网上的
    @GetMapping("/getWether")
    public void getWether() {
        MobileCodeWS mobileCodeWS = new MobileCodeWS();//MobileCodeWS 在wsdl中找的

        MobileCodeWSSoap port = mobileCodeWS.getPort(MobileCodeWSSoap.class);

        String mobileCodeInfo = port.getMobileCodeInfo("18000000654", null);

        System.out.println(mobileCodeInfo);
    }

好了，现在我们服务端，客户端都已生成并测试成功！

优化代码

将实体类转为xml

在现实工作中，我们通过webService接口肯定是要将数据转为xml形式的

定义一个类

package com.zxl.online.api;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.experimental.Accessors;

@Data
@AllArgsConstructor
@NoArgsConstructor
@Accessors(chain = true)
public class phoneEntity {

    private String province;

    private String city;

    private String regign;
}

转换方法

/**
     * @param message
     * @return
     * @Title: entity2Xml
     * @Description: 实体转换为xml
     * @return: String
     */
    public String entity2Xml(ResponseMessage message) {
        StringBuffer xml = new StringBuffer("<?xml version=\"1.0\" encoding=\"UTF-8\"?>");
        xml.append("<responseMessage>");
        xml.append("<status>" + message.getStatus() + "</status>");
        xml.append("<message>" + message.getMessage() + "</message>");
        List<phoneEntity> list = message.getInfos();
        if (list != null) {
            xml.append("<infos>");
            for (int i = 0; i < list.size(); i++) {
                phoneEntity vo = list.get(i);
                xml.append("<info>");
                xml.append("<province>" + vo.getProvince() + "</province>");
                xml.append("<city>" + vo.getCity() + "</city>");
                xml.append("<regign>" + vo.getRegign() + "</regign>");
                xml.append("</info>");
            }
            xml.append("</infos>");
        }
        xml.append("</responseMessage>");
        return xml.toString();
    }

改造原方法

@Override
    public String getInfo() {

        //new一个实体类
        phoneEntity phoneEntity = new phoneEntity();
        phoneEntity.setProvince("湖北省").setCity("武汉市").setRegign("洪山区");

        //new一个返回类
        ResponseMessage message = new ResponseMessage();
        message.setStatus(NumberConstant.ZERO);
        message.setMessage("SUCCESS");
        List<phoneEntity> list = new ArrayList<>();
        list.add(phoneEntity);
        message.setInfos(list);

        // 转换成xml
        String xml = entity2Xml(message);
        return xml;

    }

测试

成功！