SpringBoot整合jwt和mybatis-plus的脚手架项目-低调大师

SpringBoot整合jwt和mybatis-plus的脚手架项目

2019-09-26 998

近期给公司弄了个脚手架项目，打算以后后台开发就用这个了，希望留下您宝贵的建议，同时求star~

点击跳转到github地址

概述
Volcano是一个基于springboot后台开发简易脚手架。能实现当作一个单独项目或者作为微服务的一个节点进行快速开发和部署。

概述

Volcano是一个基于springboot后台开发简易脚手架。能实现当作一个单独项目或者作为微服务的一个节点进行快速开发和部署。

项目结构

javasea-volcano 父项目, 用于springcloud和springboot的版本管控, maven插件, 仓库统一管控等.

|--javasea-volcano-base: 测试类和相关业务配置，依赖common项目中的组件，开发的时候在该项目的基础上添加添加业务代码即可。

|--javasea-volcano-common:常用组件和工具类

项目环境

中间件	版本	备注
JDK	1.8+	JDK1.8及以上
MySQL	5.6+	5.6及以上
Redis	3.2+

基本功能

参考包com.zhirui.lmwy.wms.demo下的配置

参数校验

JSR校验

spring-boot-starter-web已经默认集成了JSR303校验，只需要直接使用注解校验即可。

参考测试类： com.zhirui.lmwy.wms.demo.web.controller.TestCheckParamController

手动校验

Assert类定义了不满足条件后快速断言的方式，可以在校验参数中使用。

还可以采用Spring的Assert进行校验

//第一个参数为false则抛出IllegalArgumentException异常
Assert.isTrue(concurrentConsumers > 0, "'concurrentConsumers' value must be at least 1 (one)");
Assert.isTrue(!this.exclusive || concurrentConsumers == 1,"When the consumer is exclusive, the concurrency must be 1");

也可以采用Optional进行校验

ZOrder order = this.getOrderByOrderNum(orderNum);
Optional.ofNullable(order).filter(o -> {
    return null != o && (0 == o.getStatus() || 3 == o.getStatus() || 9 == o.getStatus());
}).orElseThrow(() -> new ParamException("获取数据异常,订单号有误或者订单状态异常!"));

还可以通过guava的Preconditions类来进行参数检查。有需要请自行百度。

参数转换

参考测试类：TestDateConverterAndJson

URL方式传值到后端转换

URL传参到后端包括如下三种方式传参：

@GetMapping("testDateConverter")
public Student testDateConverter(@RequestParam Student student){...}

@GetMapping("testDateConverter")
public Student testDateConverter(Student student){...}

@GetMapping("testDateConverter/{id}")
public Student testDateConverter(@PathVariable Integer id){...}

com.zhirui.lmwy.common.converter包下定义了很多转换类：

StringToDateConverter

如果实体属性是Date，通过该转换器将String转Date类型。效果和日期属性上的注解@DatetimeFormat相同。但是启用该转换器的时候，实体属性上的注解@DatetimeFormat不再生效。

StringToDoubleConverter

如果实体属性是Double，通过该转换器将String转Double类型。

StringToIntegerConverter

如果实体属性是Integer，通过该转换器将String转Integer类型。

请求体方式传值到后端转换

请求体方式传参到后端包括如下方式：
@PostMapping("testDateConverter2")
public Student testDateConverter2(@RequestBody Student student){...}

com.zhirui.lmwy.common.json.jackson包下定义了JSON的序列化和反序列化方式：

deserializer 包下的序列化类

在@RequestBody接参时候，会调用该包中的序列化类将JSON转换成实体接参。

serializer 包下的序列化类

用于后端传值给前端。

后端传值给前端

com.zhirui.lmwy.common.json.jackson.serializer包下的定义了序列化类。

在Controller类上添加注解@ResponseBody或者@RestController，那么后端传值给前端是JSON方式。

如果是返回值是对象或者集合，会用序列化类进行参数类型转换。

如下列子中，Student中的两个属性日期会转换成serializer 定义的格式“yyyy-MM-dd HH:mm:ss”。

序列化类`JacksonDateSerializer的作用相当于在属性上添加了@JsonFormat(pattern="yyyy-MM-dd")，实现将Date类型转换成String，但是添加JacksonDateSerializer后 @JsonFormat(pattern="yyyy-MM-dd")`失效。

    @PostMapping("testDateConverter2")
    public Student testDateConverter2(@RequestBody Student student){
        System.out.println(student);
        Student s = new Student();
        s.setBirth(new Date());
        s.setCreateTime(LocalDateTime.now());
        return s;
    }

异常处理

在com.zhirui.lmwy.common.exception.impl中定义了三大类异常：

BusinessException： 通用业务异常
ParamException：参数校验异常
AuthenticationException：认证失败异常

Exceptions类定义了快捷抛出异常的一些通用方法，在需要抛出异常时请不要去throw new XXXException()，而是用Exceptions类的方法进行操作。

已经定义了全局异常处理器GlobalExceptionHandler对各种异常可以进行处理，请不要在controller和service中try..catch。

返回值处理

controller的返回前端使用ResultModel类进行封装，里面有code，msg，data等字段。

各种场景下的ResultModel返回：

    //插入后返回方式， msg：插入成功；插入失败
    public ResultModel resultInsert(){
        boolean flag = false;
        return ResultModel.resultInsert(flag);
    }

    //更新后返回方式， msg：更新成功；更新失败
    public ResultModel resultUpdate(){
        boolean flag = false;
        return ResultModel.resultUpdate(flag);
    }

    //删除后返回方式， msg：删除成功；删除失败
    public ResultModel resultDelete(){
        boolean flag = false;
        return ResultModel.resultDelete(flag);
    }

    //删除后返回方式， msg：操作成功；操作失败
    public ResultModel result(){
        boolean flag = false;
        return ResultModel.result(flag);
    }

    //认证失败返回方式， msg：认证信息异常
    public ResultModel errorTokenMsg(){
        boolean flag = false;
        //如果msg参数为null，那么是默认的msg：认证信息异常
        return ResultModel.errorTokenMsg(null);
    }

推荐优先上面的放回方式，如果不能满足，还可以使用如下通用的失败、成功的返回方式：
ResultModel.error();  //失败返回方式
ResultModel.ok();       //成功返回方式

AOP 日志输出

添加坐标

<!-- AOP -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aop</artifactId>
</dependency>
<!-- console彩色日志 -->
<dependency>
    <groupId>org.fusesource.jansi</groupId>
    <artifactId>jansi</artifactId>
    <version>1.18</version>
</dependency>

定义AOP类实现彩色日志输出

参考：com.zhirui.lmwy.common.aop.LogAop

集成丝袜哥

在common项目中集成了swagger

pom中添加注解

        <!-- swagger start -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.9.2</version>
        </dependency>
        <!-- swagger end -->

添加配置

两个配置类：

com.zhirui.lmwy.common.swagger.SwaggerConfiguration

com.zhirui.lmwy.common.swagger.SwaggerProperties

设置自定义显示参数

在base项目的application.yaml中添加如下配置进行设置：

swagger:
  #  open: true              #是否开启swagger,在生产环境下需要关闭
  protocol: http          #协议，http或https
  base-package: com.zhirui.lmwy.wms   #一定要写对，会在这个路径下扫描controller定义
  title: volcano-base项目
  version: 1.0
  description: volcano-base项目丝袜哥测试

在controller和model中使用swagger

controller类中使用参考：com.zhirui.lmwy.wms.demo.web.controller.TestCurdController

model类中使用参考：com.zhirui.lmwy.wms.demo.web.entity.User

通过swagger进行http请求
- http://localhost:8080/swagger-ui.html#/
丝袜哥默认的访问方式
- http://localhost:8080/docs
通过controller 重定向后的访问方式

集成 mybatis-plus（下文中称为MP）

ORM框架使用mybatis-plus，简便了CURD操作

添加pom

        <!-- mybatis-plus -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.2.0</version>
        </dependency>
        <!-- 代码生成器  start -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-generator</artifactId>
            <version>3.2.0</version>
        </dependency>
        <!-- 代码生成器需要的引擎模板 -->
        <dependency>
            <groupId>org.apache.velocity</groupId>
            <artifactId>velocity-engine-core</artifactId>
            <version>2.0</version>
        </dependency>
        <!-- 代码生成器  end -->

在yml中进行配置

mybatis-plus:
  mapper-locations: classpath:mapper/**/*.xml
  global-config:
    db-config:
      id-type: AUTO  #主键自增长

添加配置类配置

下列代码中使用了租户模式，如果只是单纯需要添加分页插件，只需要如下方式即可：
@Bean
public PaginationInterceptor paginationInterceptor() {
 PaginationInterceptor paginationInterceptor = new PaginationInterceptor();
 return paginationInterceptor;
}

/** 分页插件: 实现物理分页 */
@Bean
public PaginationInterceptor paginationInterceptor() {
    PaginationInterceptor paginationInterceptor = new PaginationInterceptor();
    ArrayList<ISqlParser> iSqlParsers = new ArrayList<>();
    TenantSqlParser tenantSqlParser = new TenantSqlParser();
    tenantSqlParser.setTenantHandler(new TenantHandler() {
        @Override
        public Expression getTenantId(boolean where) {
            return new StringValue(tenantId);
        }

        @Override
        public String getTenantIdColumn() {
            //指定表中的租户列
            return "tenant_id";
        }
        @Override
        public boolean doTableFilter(String tableName) {
            return false;
        }
    });
    iSqlParsers.add(tenantSqlParser);
    paginationInterceptor.setSqlParserList(iSqlParsers);
    return paginationInterceptor;
}

通过MP进行CRUD操作

参考测试类和官网：com.zhirui.lmwy.wms.demo.web.controller.TestCurdController

代码生成器

采用了MP的代码生成器，实现了两个代码生成器。

在javasea-volcano-base项目的src/test/java目录的 com.zhirui.lmwy.wms包下，按照注释修改为自己需要的配置运行即可。看个人习惯，推荐用PrimaryCodeGenerator 。

SencondCodeGenerator

通过数据库表生成基本的entity，mapper，controller和service类等基本类。

PrimaryCodeGenerator

在 SencondCodeGenerator 功能的基础上，controller，entity中生成swagger的注解。controller、service生成常用的crud方法。

集成redis

添加pom坐标

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

yml中进行配置

spring:
    redis:
      host: 127.0.0.1
      port: 6379
      password: zhirui888
      timeout: 2000
      database: 6
      lettuce:
        pool:
          max-active: 8
          max-wait: 1
          max-idle: 8
          min-idle: 0

配置类中进行配置
- 定义redis的RedisTemplate
详见：com.zhirui.lmwy.common.redis.RedisTemplateConfig
- 开启springcache
详见：com.zhirui.lmwy.common.redis.RedisCacheConfig
- redis工具类
详见：com.zhirui.lmwy.common.redis.RedisUtils

集成 JWT

添加jwt坐标

<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt</artifactId>
    <version>0.9.1</version>
    <scope>compile</scope>
</dependency>

yml中配置jwt

custom:
    jwt:
      header: token
      secret: 666666          #密码，用于生成签名
      issuer: volcano         #签发人
      subject: volcano-jwt    #主题
      audience: web           #签发的目标
      expire-minutes: 20      #过期时间
    interceptor:
      jwt:
        exclude:
          path: /swagger-resources/**,/api-docs/**,/v2/api-docs/**,/login,/verificationCode,/doc/**,/error/**,/docs,/test/**
      permission:
        exclude:
          path: /swagger-resources/**,/api-docs/**,/v2/api-docs/**,/adminLogin,/sysLogin,/login.html,/verificationCode,/doc/**,/error/**,/docs
      token-timeout:
        exclude:
          path: /swagger-resources/**,/api-docs/**,/v2/api-docs/**,/docs

添加登陆接口

登陆后会将token信息保存到redis

详见登陆controller：com.zhirui.lmwy.wms.security.controller.LoginController

添加jwt拦截器

拦截到请求后会进行校验，校验方式如下：

// 验证token是否有效
Jws<Claims> jws = JwtUtil.verify(token);

token未过期且合法的才能校验通过，否则抛出401异常。

详见jwt拦截器：com.zhirui.lmwy.wms.security.interceptor.JwtInterceptor

在swagger进行token测试

执行登陆操作，token见返回值中

返回值为：

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "loginSysUser": {
      "id": "1",
      "userName": "admin"
    },
    "token": "eyJjdHkiOiJjdHkiLCJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2b2xjYW5vLWp3dCIsImF1ZCI6IndlYiIsImlzcyI6InZvbGNhbm8iLCJleHAiOjE1Njg3MTI0MDcsImlhdCI6MTU2ODcxMDYwNywianRpIjoiNDM4NjMwMDAwOTlmNDFkNDk1Y2FlOWVkNWUzNDZhOTgifQ.wVZOx-J2knqUxdnRjRXZqr2nf1S-Qwmap2-0nGXJDXM"
  },
  "time": "2019-09-17 16:56:51"
}

点击 Authorize按钮

将token设置到value中，后面丝袜哥所有的请求都会带一个叫做“Authorization”的请求头。

在jwt拦截器JwtInterceptor中会获取该请求头进行校验。

项目启动和部署

单独作为项目使用

javasea-volcano默认是一个独立的springboot项目，可以直接启动javasea-volcano-base项目，在base项目的基础上，直接编写业务代码即可。

集成到现有的springcloud中

默认是独立项目，但是也可以轻松的集成到现有的springcloud环境中，只需要放开部分注释即可。

启用bootstrap.yml的配置(放开注释)

#spring:
#  cloud:
#    config:
#      uri: ${WMS_CONFIG_SERVER_URL}
#      name: zhirui-lmwy2-wms${WMS_DEVELOPER_NAME:}
#      profile: ${config.profile:dev}
#

base项目的pom中开启对应eureka client的坐标，启动类WmsApplication通过注解@EnableDiscoveryClient启用eureka client。

<!-- springboot 1.X -->
<!--<dependency>-->
   <!--<groupId>org.springframework.cloud</groupId>-->
   <!--<artifactId>spring-cloud-starter-eureka</artifactId>-->
<!--</dependency>-->
<!-- springboot 2.X -->
<!--<dependency>-->
   <!--<groupId>org.springframework.cloud</groupId>-->
   <!--<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>-->
<!--</dependency>-->

IDE中配置vm参数，使用已经已经存在的eureka注册中心和配置中心

在IDE中配置VM参数只能是作为测试，如果需要部署后生效，那么需要配置到服务器的环境变量或者在启动的java -jar后添加配置。之后我会添加关于服务部署的文章。

-Dmultipart-location=D:/wms/temp
-DDiskLocation=D:/wms/
-DWMS_CONFIG_SERVER_URL=http://192.168.1.230:8861
-DWMS_EUREKA_SERVER_URL=http://192.168.1.230:8090/eureka/
-DWMS_DEVELOPER_NAME=-longxiaonan
-Dconfig.profile=dev

Maven方式打包

mvn clean package -Dmaven.test.skip=true

夯实Java基础系列5：Java文件和Java包结构

目录 Java中的包概念包的作用 package 的目录结构设置 CLASSPATH 系统变量常用jar包 java软件包的类型 dt.jar rt.jar *.java文件的奥秘 *.Java文件简介为什么一个java源文件中只能有一个public类？ Main方法外部类的访问权限 Java包的命名规则参考文章微信公众号 Java技术江湖个人公众号：黄小斜 - Java类本系列文章将整理到我在GitHub上的《Java面试指南》仓库，更多精彩内容请到我的仓库里查看 https://github.com/h2pl/Java-Tutorial 喜欢的话麻烦点下Star哈文章首发于我的个人博客： www.how2playlife.com 本文是微信公众号【Java技术江湖】的《夯实Java基础系列博文》其中一篇，本文部分内容来源于网络，为了把本文主题讲得清晰透彻，也整合了很多我认为不错的技术博客内容，引用其中了一些比较好的博客文章，如有侵权，请联系作者。该系列博文会告诉你如何从入门到进阶，一步步地学习Java基础知识，并上手进行实战，接着了解每个Java知识点背后的实...

2019-09-26

804

之前写了很多关于spring cloud的文章，今天我们对OAuth2.0的整合方式做一下笔记，首先我从网上找了一些关于OAuth2.0的一些基础知识点，帮助大家回顾一下知识点：一、oauth中的角色client：调用资源服务器API的应用 Oauth 2.0 Provider：包括Authorization Server和Resource Server （1）Authorization Server：认证服务器，进行认证和授权（2）Resource Server：资源服务器，保护受保护的资源user：资源的拥有者二、下面详细介绍一下Oauth 2.0 ProviderAuthorization Server:（1）AuthorizationEndpoint:进行授权的服务，Default URL: /oauth/authorize （2）TokenEndpoint：获取token的服务，Default URL: /oauth/token Resource Server:OAuth2AuthenticationProcessingFilter：给带有访问令牌的请求加载认证三、下...

2019-09-26

731

资源下载

更多资源

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Spring

Spring框架（Spring Framework）是由Rod Johnson于2002年提出的开源Java企业级应用框架，旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念，提供核心容器、应用上下文、数据访问集成等模块，支持整合Hibernate、Struts等第三方框架，其适用范围不仅限于服务器端开发，绝大多数Java应用均可从中受益。

Rocky Linux

Rocky Linux（中文名：洛基）是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版，作为CentOS稳定版停止维护后与RHEL（Red Hat Enterprise Linux）完全兼容的开源替代方案，由社区拥有并管理，支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性，采用模块化包装和SELinux安全架构，默认包含GNOME桌面环境及XFS文件系统，支持十年生命周期更新。