Spring Boot 基础骨架

项目可以打成jar部署,也可以打成war部署,默认使用jar

<groupId>com.aidijing</groupId>
    <artifactId>aidijing-restful-client</artifactId>
    <!--<packaging>war</packaging>-->
<packaging>jar</packaging>

也可以用Docker部署,要求

本地含有Docker,启动状态
Docker包含JDK1.8,如没有安装即可

docker pull java

maven打包命令 : mvn clean package docker:build

docker运行命令 : docker run -p 8080:8080 -t com.aidijing/aidijing-restful-client # (默认情况打包后的docker镜像名称是这样)

项目所用技术

Spring
Spring Boot
Spring MVC
Spring Session(已不使用,项目无状态)
Spring Security
Spring Cache
Spring Boot Admin
Hibernate Validator
Mybatis Plus
Redis
Swagger(已废弃)
Pagehelper
Druid
Log4j2
WebSocket
JWT(JSON Web Tokens)
WebSocket

项目包含了

分布式锁
分布式唯一code构建
分布式session共享(已不使用,项目无状态)
异步处理
Aop缓存
基础CRUD
物理分页
异步日志,多线程下用户的会话跟踪
Swagger restful api
异常统一处理
Cors解决跨域
注入攻击拦截器
多环境配置
基本工具类
jwt认证
Spring Security基础权限管理
细粒度权限控制(粒度控制到字段)
验证码
Spring Boot Admin 管理和监视
极简分布式任务调度
WebSocket 简单示例

要求 :

JDK 1.8
redis 默认使用 127.0.0.1:6379
mysql root/root 127.0.0.1:3306 数据库名称 : blog,基础sql见init.sql
lombok 插件(eclipse IntelliJ IDEA),不然项目可能会报错,但是不影响运行

aidijing-parent

版本管理

aidijing-common

工具

aidijing-service

pom.xml中所有的依赖都是

<scope>provided</scope>

服务接口

aidijing-dao

pom.xml中所有的依赖都是

<scope>provided</scope>

dao与数据库交互

aidijing-basic-config

基础配置(暂时未用到)

aidijing-restful-client

控制器,发布http restful接口

项目无状态

不要使用session(项目也禁用了)

com.aidijing.ContextUtils

用户相关数据从 ContextUtils 中获取

数据交互

org.springframework.http.ResponseEntity

使用ResponseEntity对数据进行封装

代码生成器

aidijing-generator
|---src
|   |---test
         |---com
              |---aidijing
                   |---generator
                       |---...

注意,所有状态,类型等字段,请使用枚举

比如 : String resourceType(API:接口,MENU:菜单,BUTTON:按钮)
这样的字段在实体中使用枚举类型

创建枚举

相应的枚举,注释必须完整注:

枚举请实现 BaseEnumInterface 接口,方便之后操作
枚举放入domain.enum包下

/**
 * 资源类型(API:接口,MENU:菜单,BUTTON:按钮)
 * <p>
 * 对应字段 {@link com.aidijing.domain.PermissionResource#resourceType}
 */
@Getter
public enum ResourceType implements IEnum {
    
    API( "API" , "接口" ),
    MENU( "MENU" , "菜单" ),
    BUTTON( "BUTTON" , "按钮" );

    /** 数据库存储值 **/
    private String value;
    /** 相应注释 **/
    private String comment;

    ResourceType ( String value , String comment ) {
        this.value = value;
        this.comment = comment;
    }

    /**
     * {@link JsonValue} 指定序列化为该字段,也就是显示时以该字段显示
     */
    @JsonValue
    public String getComment () {
        return comment;
    }
}

实体中声明

public class PermissionResource {
    private Long id;
    private ResourceType resourceType;
    // ... ... 
}

配置枚举包位置

mybatis-plus:
  type-enums-package: com.aidijing.manage.bean.domain.enums

使用 mybatis plus

文档 http://mp.baomidou.com

注意 : 分页不适用mybatis plus的分页,使用PageHelper,mybatis plus分页对多表查询的分页支持不够

查询分页(PageHelper)

https://pagehelper.github.io

示例 :

// controller
@GetMapping
public ResponseEntity< PageInfo > listPage ( PageRowBounds pageRowBounds ) {
    return ResponseEntityPro.ok(userService.listPage( pageRowBounds ) );
}

// service
public PageInfo listPage ( PageRowBounds pageRowBounds ) {
    PageHelper.startPage( pageRowBounds.getOffset(), pageRowBounds.getLimit() );
    return new PageInfo( super.selectList( null ) );
}

api返回指定/排除字段