【十四】springboot整合WebService(超详细)

导读:本篇文章讲解 【十四】springboot整合WebService(超详细),希望对大家有帮助,欢迎收藏,转发!站点地址:www.bmabk.com

 springboot篇章整体栏目: 


【一】springboot整合swagger(超详细

【二】springboot整合swagger(自定义)(超详细)

【三】springboot整合token(超详细)

【四】springboot整合mybatis-plus(超详细)(上)

【五】springboot整合mybatis-plus(超详细)(下)

【六】springboot整合自定义全局异常处理

【七】springboot整合redis(超详细)

【八】springboot整合AOP实现日志操作(超详细)

【九】springboot整合定时任务(超详细)

【十】springboot整合redis实现启动服务即将热点数据保存在全局以及redis(超详细)

【十一】springboot整合quartz实现定时任务优化(超详细)

【十二】springboot整合线程池解决高并发(超详细,保你理解)

【十三】springboot整合异步调用并获取返回值(超详细)

【十四】springboot整合WebService(超详细)

【十五】springboot整合WebService(关于传参数)(超详细)

【十六】springboot整合WebSocket(超详细)

【十七】springboot整合WebSocket实现聊天室(超详细)


 介绍:接下来我会把学习阶段学到的框架等知识点进行整合,每一次整合是在前一章的基础上进行的,所以后面的整合不会重复放前面的代码。每次的demo我放在结尾,本次是接着上一章的内容延续的,只增加新增的或者修改的代码。

上一章整合了异步调用,并获取了异步调用的返回值,本章将进行WebService的整合。

使用场景:在开发时,可能会使用到别的团队或者其他开放接口的数据,并不全是自己进行数据处理,这种情况下就需要访问别人的接口或者,将自己的接口开放给别人使用。

下面将开始进行webservice的整合以及讲解如何编写作为服务端以及客户端如何请求。

首先展示一下我的目录结构:

我是在前面13章整合的代码上进行添加的,所以我会框选出新增部分代码。

服务端:

【十四】springboot整合WebService(超详细)

 【十四】springboot整合WebService(超详细)

客户端:

【十四】springboot整合WebService(超详细)

 【十四】springboot整合WebService(超详细)

目录结构展示完毕(事实上,为了方便,客户端的代码我是复制的服务端的代码,都是简单的Springboot项目,也可以自己新建),可以看到我将服务端的端口号设置的8089,客户端的端口号是8090。

第一步:导入依赖

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

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <!--swagger        -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
        </dependency>
        <!--swagger的swagger-ui.html模式        -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.9.2</version>
        </dependency>
        <!--swagger的doc.html模式        -->
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>swagger-bootstrap-ui</artifactId>
            <version>1.9.2</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/com.auth0/java-jwt -->
        <dependency>
            <groupId>com.auth0</groupId>
            <artifactId>java-jwt</artifactId>
            <version>3.9.0</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/org.json/json -->
        <dependency>
            <groupId>org.json</groupId>
            <artifactId>json</artifactId>
            <version>20190722</version>
        </dependency>

        <!-- mybatis plus 代码生成器 -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.2.0</version>
        </dependency>
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-generator</artifactId>
            <version>3.2.0</version>
        </dependency>
        <dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.28</version>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.47</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.11</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-redis</artifactId>
            <version>2.5.1</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-aop</artifactId>
            <version>2.5.1</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web-services</artifactId>
            <version>2.5.1</version>
        </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>

    </dependencies>

其中,这三个依赖是本章新增的依赖:

【十四】springboot整合WebService(超详细)

第二步:编写服务端接口

【十四】springboot整合WebService(超详细)

注意:一定要加上WebService注解。

第三步:编写服务端接口实现类

【十四】springboot整合WebService(超详细)

注意:一定要加上WebService注解。

到此,该服务端接口已经形成, 现在要做的就是将该接口暴露出来,所以新建一个配置类,如下:

第四步:编写服务端暴露接口的配置类

package com.swagger.demo.config;

import com.swagger.demo.service.CodeService;
import com.swagger.demo.service.impl.CodeServiceImpl;
import javax.xml.ws.Endpoint;
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;

/**
 * @ClassName WebServiceConfig
 * @Description TODO
 * @Author zrc
 * @Date 15:08
 * @Version 1.0
 **/
@Configuration
public class WebServiceConfig {

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

     @Bean(name = Bus.DEFAULT_BUS_ID)
     public SpringBus springBus() {
                 return new SpringBus();
             }
     @Bean
     public Endpoint endpoint() {
                 // 参数二,是SEI实现类对象
                 EndpointImpl endpoint = new EndpointImpl(this.springBus(), this.codeService());
                 // 发布服务
                 endpoint.publish("/userService");
                 return endpoint;
             }

}

 注意:不要引错包。

【十四】springboot整合WebService(超详细)

1:注意不要忘记configuration注解

2:注意命名,不要命名成dispatcherServlet,不然会报错。

3:我觉得就固定写法嘛,反正请求时类似http://localhost:8089/webservice/userService?wsdl

4:就是你要开放的接口的接口类型。

5:就是你要开放的接口的接口类型的实现类。

6:就是你想要将你的接口暴露出来之后,别人使用时的名字,自己拟定一个。

服务端的编写到此就结束了,特别简单。

第五步:编写客户端controller

客户端的调用就更简单了,我为了方便,直接把调用写在controller了。

比如,我的一个接口需要使用到服务端(模拟的别人的接口)的接口返回的数据,我的接口编写如下:

package com.swagger.demo.controller;

import com.swagger.demo.model.entity.Code;
import com.swagger.demo.service.CodeService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

/**
 * UserController类
 *
 * <p>
 * <b>History:</b>
 * <table border="1">
 * <tr>
 * <th>Date</th>
 * <th>Operator</th>
 * <th>Memo</th>
 * </tr>
 * <tr>
 * <td>2021/8/25 17:51</td>
 * <td>zrc</td>
 * <td>Create</td>
 * </tr>
 * </table>
 *
 * @author zrc
 * @version 1.0.0
 * @since 1.0.0
 */
@Api(tags = "热点数据接口")
@RestController
@RequestMapping("codeController")
public class CodeController {

    @Autowired
    private CodeService codeService;

    /**
     * 静态变量:系统日志
     */
    private static final Log logger = LogFactory.getLog(CodeController.class);

    @ApiOperation(value = "测试webservice")
    @PostMapping("/testWebservice")
    public List<Code> testWebservice() throws InterruptedException {
                         // 接口地址
                         String address = "http://localhost:8089/webservice/userService?wsdl";
                         // 代理工厂
                         JaxWsProxyFactoryBean jaxWsProxyFactoryBean = new JaxWsProxyFactoryBean();
                         // 设置代理地址
                         jaxWsProxyFactoryBean.setAddress(address);
                         // 设置接口类型
                         jaxWsProxyFactoryBean.setServiceClass(CodeService.class);
                         // 创建一个代理接口实现
        codeService = (CodeService) jaxWsProxyFactoryBean.create();
                         // 调用代理接口的方法调用并返回结果
                         List<Code> codes = codeService.getCodes();
                         System.out.println("返回结果: " + codes);
                        return codes;
    }

}

【十四】springboot整合WebService(超详细)

注意:不要引错包。

服务端接口地址的使用如上。

第六步:编写客户端接口

特别注意:服务端的接口,在客户端也需要建立相同的接口,如下:

【十四】springboot整合WebService(超详细)

特别注意:

1、此处的方法名和返回值需要和服务端的一致。

2、两个注解都不要漏掉,漏掉一个都会报错。

第七步:演示

由于前面已经整合了swagger,所以我直接启动客户端和服务端,然后打开客户端的在线swagger进行演示,如下:

【十四】springboot整合WebService(超详细)

 从图中可以看到接口已经请求到了数据,但是从上面的客户端接口编写可以看到,其实我们并没有写该接口的具体业务,所以是调用的服务端的getCodes方法获取的数据,整合成功。

本期整合到此完毕,接下来会继续更新加强整合,尽情期待。

客户端访问地址:http://localhost:8090/swagger-ui.html或者http://localhost:8090/doc.html

demo地址:studydemo/整合swagger at main · zrc11/studydemo · GitHub

码字不易,若帮到各位,帮忙三连,感谢

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

文章由极客之音整理,本文链接:https://www.bmabk.com/index.php/post/12801.html

(0)
小半的头像小半

相关推荐

极客之音——专业性很强的中文编程技术网站,欢迎收藏到浏览器,订阅我们!