Spring Boot | 静态资源访问与拦截器

一、静态资源访问与首页定制

在 Spring Boot 中，静态资源主要存放在以下 4 个位置：

1. src / main / java / resources / META-INF / resources
2. src / main / java / resources / public
3. src / main / java / resources / resources
4. src / main / java / resources / static

它们的访问优先级为：1 > 3 > 4 > 2
一般情况下，可在 public 下放一些公共的资源（如 js 等），static 下放一些图片等，resources 下放一些上传的文件等
当我们的静态资源文件名为 index.html 时，默认作为首页，所以只需通过 localhost:8080 即可访问到该页面，同时也覆盖了 Spring Boot 的默认首页
此时，通过 localhost:8080 即可显示首页内容：

由于 META-INF / resources 下的静态资源访问优先级最高，因而最终显示的是该目录下的 index.html 的内容

二、拦截器的使用

拦截器在登录验证时经常用到，Spring Boot 中添加拦截器十分简单
首先，自定一个拦截器类实现 HandlerInterceptor接口，并重写 preHandle 方法，该方法会在请求发送至 Controller 前执行，返回 false 则拦截，拦截后请求失效；返回 true 则放行，放行后请求进入到 Controller 中
以登录验证为例，用户登录后信息存入至 Session 中，然后在拦截器的 preHandle 方法中取出 Session 中的用户信息，若为空则拦截请求，并重定向至登录页，不为空则 return true 放行

public class LoginHandlerInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        Object loginUser = request.getSession().getAttribute("loginUser");
        if (loginUser == null) {
            // 用户未登录，拦截  redirect重定向至登录界面 
            return false;
        } else {
            // 用户已登录，放行
            return true;
        }
    }
}

定义好拦截器之后，自然就是对 MVC 进行配置，将拦截器添加到配置中
定义一个类实现 WebMvcConfigurer 接口，重写 addInterceptors 方法，在其中添加上方定义好的拦截器

@Configuration
public class MyMvcConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new LoginHandlerInterceptor()).addPathPatterns("/**").
                 excludePathPatterns("/index.html","/","/user/login","/css/**","/js/**","/img/**");
    }
}

addPathPatterns 表示添加需拦截的请求路径，excludePathPatterns 表示排除拦截的路径（一般在这里放行静态资源，如 css, js 等, /** 表示其下的所有请求 ）
显然，首页请求、登录验证请求以及静态资源的请求路径都是要排除在外的
最后的效果就是：如果我们没有进行登录操作，直接在浏览器地址栏中访问登录后的主页（如 / user / main ），此时便会重定向至登录页，登录后则不进行拦截

三、自定义出错页面跳转

当我们请求出错时（如 404），一般会跳转到一个错误页面。在 Spring Boot 中，这点也十分容易实现。只需要在 static 目录下新建一个 error 目录，然后在其中定义错误界面（如 404 错误就定义 404.html）
当我们访问一个不存在的请求时，会自动显示 404.html 中的内容：

不过，这种方式返回的只是静态页面，如需返回动态页面，可以整合 Thymeleaf 模板引擎，然后在 template 目录下新建 error 目录，并在其中定义错误页面（如 404.html、500.html 等），便可以动态显示服务端返回的错误信息