likes
comments
collection
share

从零搭建微服务-认证中心（三）

作者站长头像
站长
· 阅读数 39

写在最前

如果这个项目让你有所收获，记得 Star 关注哦，这对我是非常不错的鼓励与支持。

源码地址：gitee.com/csps/mingyu…

文档地址：gitee.com/csps/mingyu…

目录规划

截止目前，项目可以规划如下：

mingyue
├── mingyue-auth -- 认证中心[9000]
└── mingyue-common -- 公共模块
     ├── mingyue-common-bom -- 全局依赖管理控制
     ├── mingyue-common-core -- 公共工具类核心包
     ├── mingyue-common-satoken -- Sa-Token
     └── mingyue-common-security -- 认证工具类

什么是 BOM?

BOM全称是Bill Of Materials，译作材料清单。BOM本身并不是一种特殊的文件格式，而是一个普通的POM文件，只是在这个POM中，我们罗列的是一个工程的所有依赖和其对应的版本。该文件一般被其它工程使用，当其它工程引用BOM中罗列的jar包时，不用显示指定具体的版本，会自动使用BOM对应的jar版本。

所以BOM的好处是用来管理一个工程的所有依赖版本信息。

结构优化

创建 mingyue-common

Idea mingyue 右击 -> New -> Module -> mingyue-common

只保留 pom.xml 其余文件删除

<artifactId>mingyue-common</artifactId>
<packaging>pom</packaging>

<description>mingyue 公共聚合模块</description>

<modules>
  <module>mingyue-common-bom</module>
  <module>mingyue-common-security</module>
  <module>mingyue-common-satoken</module>
</modules>

创建 mingyue-common-satoken

<?xml version="1.0" encoding="UTF-8"?>
<artifactId>mingyue-common-satoken</artifactId>

<dependencies>
  <!-- Sa-Token 权限认证, 在线文档：https://sa-token.cc/ -->
  <dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-spring-boot-starter</artifactId>
    <version>${sa-token.version}</version>
  </dependency>

  <!-- Sa-Token-OAuth2.0 模块 -->
  <dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-oauth2</artifactId>
    <version>${sa-token.version}</version>
  </dependency>

  <!-- Sa-Token 整合redis (使用jackson序列化方式) -->
  <dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-dao-redis-jackson</artifactId>
    <version>${sa-token.version}</version>
  </dependency>

  <!-- 提供Redis连接池 -->
  <dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-pool2</artifactId>
  </dependency>

  <!-- 视图引擎（在前后端不分离模式下提供视图支持） -->
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
  </dependency>
</dependencies>

创建 mingyue-common-security

<artifactId>mingyue-common-security</artifactId>

<dependencies>
  <!-- Sa-Token 权限认证, 在线文档：https://sa-token.cc/ -->
  <dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-spring-boot-starter</artifactId>
    <version>${sa-token.version}</version>
  </dependency>

  <!-- Sa-Token-OAuth2.0 模块 -->
  <dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-oauth2</artifactId>
    <version>${sa-token.version}</version>
  </dependency>

  <!-- Sa-Token 整合redis (使用jackson序列化方式) -->
  <dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-dao-redis-jackson</artifactId>
    <version>${sa-token.version}</version>
  </dependency>

  <!-- 提供Redis连接池 -->
  <dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-pool2</artifactId>
  </dependency>

  <!-- 视图引擎（在前后端不分离模式下提供视图支持） -->
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
  </dependency>
</dependencies>

创建 mingyue-common-bom

只保留 pom.xml 其余文件删除

<artifactId>mingyue-common-bom</artifactId>
<packaging>pom</packaging>

<description>
  mingyue-common-bom common 依赖项
</description>

<dependencyManagement>
  <dependencies>
    <!-- 安全模块 -->
    <dependency>
      <groupId>com.csp.mingyue</groupId>
      <artifactId>mingyue-common-security</artifactId>
      <version>${project.version}</version>
    </dependency>
    <!-- Sa-Token -->
    <dependency>
      <groupId>com.csp.mingyue</groupId>
      <artifactId>mingyue-common-satoken</artifactId>
      <version>${project.version}</version>
    </dependency>
  </dependencies>
</dependencyManagement>

引入依赖

mingyue 引入 mingyue-common-bom

<dependencyManagement>
        <dependencies>
            ...

            <!-- common 的依赖配置-->
            <dependency>
                <groupId>com.csp.mingyue</groupId>
                <artifactId>mingyue-common-bom</artifactId>
                <version>${mingyue.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

启动 mingyue-auth 测试

参考【认证中心（二）】测试接口

全局异常处理

/**
 * 全局异常处理器
 *
 * @author ruoyi
 */
@Slf4j
@RestControllerAdvice
public class GlobalExceptionHandler {

    /**
     * Sa-Token 框架内部逻辑发生错误抛出的异常
     */
    @ExceptionHandler(SaTokenException.class)
    public R<Void> handlerException(SaTokenException e, HttpServletRequest request) {
        String requestURI = request.getRequestURI();
        log.error("请求地址'{}',Sa-Token 框架内部逻辑发生错误抛出的异常 '{}'", requestURI, e.getMessage());
        return R.fail(e.getMessage());
    }

    /**
     * 认证失败
     */
    @ExceptionHandler(NotLoginException.class)
    public R<Void> handleNotLoginException(NotLoginException e, HttpServletRequest request) {
        String requestURI = request.getRequestURI();
        log.error("请求地址'{}',认证失败'{}',无法访问系统资源", requestURI, e.getMessage());
        return R.fail(HttpStatus.UNAUTHORIZED, "认证失败，无法访问系统资源");
    }

    /**
     * 请求方式不支持
     */
    @ExceptionHandler(HttpRequestMethodNotSupportedException.class)
    public R<Void> handleHttpRequestMethodNotSupported(HttpRequestMethodNotSupportedException e,
                                                          HttpServletRequest request) {
        String requestURI = request.getRequestURI();
        log.error("请求地址'{}',不支持'{}'请求", requestURI, e.getMethod());
        return R.fail(e.getMessage());
    }

    /**
     * 拦截未知的运行时异常
     */
    @ExceptionHandler(RuntimeException.class)
    public R<Void> handleRuntimeException(RuntimeException e, HttpServletRequest request) {
        String requestURI = request.getRequestURI();
        log.error("请求地址'{}',发生未知异常.", requestURI, e);
        return R.fail(e.getMessage());
    }

    /**
     * 系统异常
     */
    @ExceptionHandler(Exception.class)
    public R<Void> handleException(Exception e, HttpServletRequest request) {
        String requestURI = request.getRequestURI();
        log.error("请求地址'{}',发生系统异常.", requestURI, e);
        return R.fail(e.getMessage());
    }

    /**
     * 自定义验证异常
     */
    @ExceptionHandler(BindException.class)
    public R<Void> handleBindException(BindException e) {
        log.error(e.getMessage(), e);
        String message = e.getAllErrors().get(0).getDefaultMessage();
        return R.fail(message);
    }

    /**
     * 自定义验证异常
     */
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public R<Void> handleMethodArgumentNotValidException(MethodArgumentNotValidException e) {
        log.error(e.getMessage(), e);
        String message = e.getBindingResult().getFieldError().getDefaultMessage();
        return R.fail(message);
    }

}

小结

优化了一下结构，下一节预计接入前端框架（前后端分离模式），实现登录与登出

转载自:https://juejin.cn/post/7237441033491562551
评论
请登录