SpringBoot1.5以上版本自定义配置文件

最近在学习SpringBoot方面的知识,基本的框架已经了解的差不多了,今天在搭框架的时候,想到了一个使用场景:在一个Web平台上,如果没有登录该平台,那么访问的界面是有限的,这样我就需要做一个白名单,未登录的用户如果访问的是白名单中的页面,是可以不需要验证其登陆的。
这样问题的解决思路是我需要一个List来放置我的白名单路径,但是我有又不想将这个白名单放置在静态变量中,所以想到了SpringBoot支持自定义配置文件,而我只要维护一个配置文件,在每次过滤器调用的时候将白名单读出来就可以了,这样项目中的开发人员只要维护一个配置文件即可,既然有了思路,那么就可以开始实现了。

读取自定义配置文件

学习过SpringBoot的朋友们应该都知道,Spb的项目配置文件主要是application.properties,当然你也可以自定义生产环境和开发环境的配置文件,具体的方法可以百度,这里不是讨论的重点,现在我们讨论的是在自定义的配置文件中读取配置信息的方法:

  1. 创建配置文件
    在resources/目录下创建config文件夹,并在该文件夹下创建”visit_white_list.properties”文件。
  2. 填写配置文件内容
    既然是一个白名单,那肯定用List来存放数据是最合适不过得了,配置文件中,创建List的方法很简单,其配置文件的内容如下:
1
2
3
web.whitelist[0]=/hello 
web.whitelist[1]=/hello1
web.whitelist[2]=/hello2

先不说具体的意义,单从语法来看,这段代码就是一个数组形式的定义,当然你也可以定义字符串类型或者数字类型的属性值,这里我就不多做赘述了,现在进入下一步。

  1. 创建管理配置的实体类
    其实这篇文章存在的意义就在于,1.5之后和1.5之前,管理配置的实体类是有变化的
    首先我们来看看1.5之前实体类的写法:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    @ConfigurationProperties(locations = "classpath:config/visit_white_list.properties", prefix = "web")
    @Component
    public class WhiteListConfig {

    public List<String> getWhitelist() {
    return whitelist;
    }

    public void setWhitelist(List<String> whitelist) {
    this.whitelist = whitelist;
    }

    private List<String> whitelist;
    }

再看看1.5之后的写法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

@Component
@PropertySource(value = "classpath:config/visit_white_list.properties")
@ConfigurationProperties(prefix = "web")
public class WhiteListConfig {

public List<String> getWhitelist() {
return whitelist;
}

public void setWhitelist(List<String> whitelist) {
this.whitelist = whitelist;
}

private List<String> whitelist;
}

在@ConfigurationProperties注释中有两个属性:

locations:指定配置文件的所在位置
prefix:指定配置文件中键名称的前缀(我这里配置文件中所有键名都是以web.开头)

使用@Component是让该类能够在其他地方被依赖使用,即使用@Autowired注释来创建实例。
但是1.5之后取消了 @ConfigurationProperties 的 locations属性,所以在1.5之后 需要加入@PropertySource 属性来指定自定义配置文件的相对路径,以便系统加载。

  1. 创建过滤器
    过滤器的内容:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    /**
    * 使用注解标注过滤器
    *
    * @version v.0.1
    * @WebFilter将一个实现了javax.servlet.Filter接口的类定义为过滤器 属性filterName声明过滤器的名称, 可选
    * 属性urlPatterns指定要过滤的URL模式,也可使用属性value来声明.(指定要过滤的URL模式是必选属性)
    */

    @WebFilter(filterName = "AuthFilter", urlPatterns = "/*")
    public class AuthFilter implements Filter {
    @Autowired
    private WhiteListConfig myWebConfig;
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {

    System.out.println("访问路径权限过滤器初始化");
    }

    @Override
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
    System.out.println("访问路径权限开始执行过滤器");
    HttpServletRequest request = (HttpServletRequest) servletRequest;
    HttpServletResponse response = (HttpServletResponse) servletResponse;
    HttpSession session = request.getSession(true);
    String usercode = (String) request.getRemoteUser();// 登录人
    String user_role = (String) session.getAttribute("role");//登录人角色
    String url = request.getRequestURI();

    if (usercode == null || "".equals(usercode) || user_role == null || "".equals(user_role)) {
    //判断获取的路径不为空且不是访问登录页面或执行登录操作时跳转
    if (!myWebConfig.getWhitelist().contains(url) &&url != null && !url.equals("") && (url.indexOf("Login") < 0 && url.indexOf("login") < 0)) {
    //无权限时跳转到登录界面
    response.sendRedirect(request.getContextPath() + "/login.dhcc");
    return;
    }
    }
    filterChain.doFilter(servletRequest, servletResponse);
    return;


    }

    @Override
    public void destroy() {
    System.out.println("访问路径权限过滤器销毁");
    }
    }

使用

1
2
@Autowired
private WhiteListConfig myWebConfig;

获取到白名单配置文件并获取其list对象来判断当前Url是否在白名单范围内即可。

总结

网上查了很多资料,关于SpringBoot读取自定义配置文件的方法都是属于1.5之前的读取方式,而我的项目属于1.5之后的,于是搜了很多资料才找到1.5之后的配置方式,在此分享给大家,希望大家少走弯路吧。

相关资料

  1. Springboot 之 自定义配置文件及读取配置文件
  2. spring boot1.5以上版本@ConfigurationProperties取消location注解后的替代方案

热评文章