@Value的诸多用法
搬运地址:@Value用法
留存做学习用
再附上自己学习使用过程中的记录记录
相互印证,发现当初自己只是用到了功能中很小的一部分。。。
对于从事java开发工作的小伙伴来说,spring框架肯定再熟悉不过了。spring给开发者提供了非常丰富的api,满足我们日常的工作需求。
如果想要创建bean实例,可以使用@Controller、@Service、@Repository、@Component等注解。
如果想要依赖注入某个对象,可以使用@Autowired和@Resource注解。
如果想要开启事务,可以使用@Transactional注解。
如果想要动态读取配置文件中的某个系统属性,可以使用@Value注解。
等等,还有很多。。。
今天咱们重点聊聊@Value注解,因为它是一个非常有用,但极其容易被忽视的注解,绝大多数人可能只用过它的一部分功能,这是一件非常遗憾的事情。
所以今天有必要和大家一起,重新认识一下@Value。
1. 由一个例子开始
假如在UserService类中,需要注入系统属性到userName变量中。通常情况下,我们会写出如下的代码:
@Service
public class UserService {@Value("${susan.test.userName}")private String userName;public String test() {System.out.println(userName);return userName;}
}
通过@Value注解指定系统属性的名称susan.test.userName,该名称需要使用${}包起来。
这样spring就会自动的帮我们把对应的系统属性值,注入到userName变量中。
不过,上面功能的重点是要在applicationContext.properties文件(简称:配置文件)中配置同名的系统属性:
#张三
susan.test.userName=\u5f20\u4e09
那么,名称真的必须完全相同吗?
2. 关于属性名
这时候,有些朋友可能会说:在@ConfigurationProperties配置类中,定义的参数名可以跟配置文件中的系统属性名不同。
比如,在配置类MyConfig类中定义的参数名是userName:
@Configuration
@ConfigurationProperties(prefix = "susan.test")
@Data
public class MyConfig {private String userName;
}
而配置文件中配置的系统属性名是:
susan.test.user-name=\u5f20\u4e09
类中用的userName,而配置文件中用的user-name,不一样。但测试之后,发现该功能能够正常运行。
配置文件中的系统属性名用 驼峰标识 或 小写字母加中划线的组合,spring都能找到配置类中的属性名userName进行赋值。
由此可见,配置文件中的系统属性名,可以跟配置类中的属性名不一样。不过,有个前提,前缀susan.test必须相同。
那么,@Value注解中定义的系统属性名也可以不一样吗?
答案:不能。如果不一样,启动项目时会直接报错。
此外,如果只在@Value注解中指定了系统属性名,但实际在配置文件中没有配置它,也会报跟上面一样的错。
所以,@Value注解中指定的系统属性名,必须跟配置文件中的相同。
3. 乱码问题
不知道细心的小伙伴们有没有发现,我配置的属性值:张三,其实是转义过的。
susan.test.userName=\u5f20\u4e09
为什么要做这个转义?
假如在配置文件中配置中文的张三:
susan.test.userName=张三
最后获取数据时,你会发现userName竟然出现了乱码:
å¼ ä¸‰
what?
为什么会出现乱码?
答:在springboot的CharacterReader类中,默认的编码格式是ISO-8859-1,该类负责.properties文件中系统属性的读取。如果系统属性包含中文字符,就会出现乱码。
那么,如何解决乱码问题呢?
目前主要有如下三种方案:
手动将ISO-8859-1格式的属性值,转换成UTF-8格式。
设置encoding参数,不过这个只对@PropertySource注解有用。
将中文字符用unicode编码转义。
显然@Value不支持encoding参数,所以方案2不行。
假如使用方案1,具体实现代码如下:
@Service
public class UserService {@Value(value = "${susan.test.userName}")private String userName;public String test() {String userName1 = new String(userName.getBytes(StandardCharsets.ISO_8859_1), StandardCharsets.UTF_8);System.out.println();return userName1;}
}
确实可以解决乱码问题。
但如果项目中包含大量中文系统属性值,每次都需要加这样一段特殊转换代码。出现大量重复代码,有没有觉得有点恶心?
反转我被恶心到了。
那么,如何解决代码重复问题呢?
答:将属性值的中文内容转换成unicode。
类似于这样的:
susan.test.userName=\u5f20\u4e09
这种方式同样能解决乱码问题,不会出现恶心的重复代码。但需要做一点额外的转换工作,不过这个转换非常容易,因为有现成的在线转换工具。
推荐使用这个工具转换:http://www.jsons.cn/unicode/
在这里顺便告诉你一个小秘密:如果你使用的是.yml或.yaml格式的配置文件,并不会出现中文乱码问题。
这又是为什么?
因为.yml或.yaml格式的配置文件,最终会使用UnicodeReader类进行解析,它的init方法中,首先读取BOM文件头信息,如果头信息中有UTF8、UTF16BE、UTF16LE,就采用对应的编码,如果没有,则采用默认UTF8编码。
需要注意的是:乱码问题一般出现在本地环境,因为本地直接读取的.properties配置文件。在dev、test、生产等环境,如果从zookeeper、apollo、nacos等配置中心中获取系统参数值,走的是另外的逻辑,并不会出现乱码问题。
4.默认值
有时候,默认值是我们非常头疼的问题。
为什么这样说呢?
因为很多时候使用java的默认值,并不能满足我们的日常工作需求。
比如有这样一个需求:如果配置了系统属性,userName就用配置的属性值。如果没有配置,则userName用默认值susan。
有些朋友可能认为可以这样做:
@Value(value = "${susan.test.userName}")
private String userName = "susan";
在定义参数时直接给个默认值,但如果仔细想想这招是行不通的的。因为设置userName默认值的时机,比@Value注解依赖注入属性值要早,也就是说userName初始化好了默认值,后面还是会被覆盖。
那么,到底该如何设置默认值呢?
答:使用:。
例如:
@Value(value = "${susan.test.userName:susan}")
private String userName;
在需要设置默认值的系统属性名后,加:符号。紧接着,在:右边设置默认值。
建议大家平时在使用@Value时,尽量都设置一个默认值。如果不需要默认值,宁可设置一个空。比如:
@Value(value = "${susan.test.userName:}")
private String userName;
为什么这么说?
假如有这种场景:在business层中包含了UserService类,business层被api服务和job服务都引用了。但UserService类中@Value的userName只在api服务中有用,在job服务中根本用不到该属性。
对于job服务来说,如果不在.properties文件中配置同名的系统属性,则服务启动时就会报错。
这个坑,我之前踩过多次。所以,建议大家,使用@Value注解时,最好给参数设置一个默认值,以防止出现类似的问题。
5. static变量
前面我们已经见识过,如何使用@Value注解,给类的成员变量注入系统属性值。
那么,问题来了,静态变量可以自动注入系统属性值不?
我们一起看看,假如将上面的userName定义成static的:
@Value("${susan.test.userName}")
private static String userName;
程序可以正常启动,但是获取到userName的值却是null。
由此可见,被static修饰的变量通过@Value会注入失败。
作为好奇宝宝的你,此时肯定想问:如何才能给静态变量注入系统属性值呢?
答:这就需要使用如下的骚代码了:
@Service
public class UserService {private static String userName;@Value("${susan.test.userName}")public void setUserName(String userName) {UserService.userName = userName;}public String test() {return userName;}
}
提供一个静态参数的setter方法,在该方法上使用@Value注入属性值,并且同时在该方法中给静态变量赋值。
有些细心的朋友可能会发现,@Value注解在这里竟然使用在setUserName方法上了,也就是对应的setter方法,而不是在变量上。
有趣,有趣,这种用法有点高端喔。
不过,通常情况下,我们一般会在pojo实体类上,使用lombok的@Data、@Setter、@Getter等注解,在编译时动态增加setter或getter方法,所以@Value用在方法上的场景其实不多。
6.变量类型
上面的内容,都是用的字符串类型的变量进行举例的。其实,@Value注解还支持其他多种类型的系统属性值的注入。
6.1 基本类型
众所周知,在Java中的基本数据类型有4类8种,然我们一起回顾一下:
整型:byte、short、int、long
浮点型:float、double
布尔型:boolean
字符型:char
相对应地提供了8种包装类:
整型:Byte、Short、Integer、Long
浮点型:Float、Double
布尔型:Boolean
字符型:Character
@Value注解对这8中基本类型和相应的包装类,有非常良好的支持,例如:
@Value("${susan.test.a:1}")
private byte a;@Value("${susan.test.b:100}")
private short b;@Value("${susan.test.c:3000}")
private int c;@Value("${susan.test.d:4000000}")
private long d;@Value("${susan.test.e:5.2}")
private float e;@Value("${susan.test.f:6.1}")
private double f;@Value("${susan.test.g:false}")
private boolean g;@Value("${susan.test.h:h}")
private char h;@Value("${susan.test.a:1}")
private byte a1;@Value("${susan.test.b:100}")
private Short b1;@Value("${susan.test.c:3000}")
private Integer c1;@Value("${susan.test.d:4000000}")
private Long d1;@Value("${susan.test.e:5.2}")
private Float e1;@Value("${susan.test.f:6.1}")
private Double f1;@Value("${susan.test.g:false}")
private Boolean g1;@Value("${susan.test.h:h}")
private Character h1;
有了这些常用的数据类型,我们在定义变量类型时,可以非常愉快的玩耍了,不用做额外的转换。
6.2 数组
但只用上面的基本类型是不够的,特别是很多需要批量处理数据的场景中。这时候可以使用数组,它在日常开发中使用的频率很高。
我们在定义数组时可以这样写:
@Value("${susan.test.array:1,2,3,4,5}")
private int[] array;
spring默认使用逗号分隔参数值。
如果用空格分隔,例如:
@Value("${susan.test.array:1 2 3 4 5}")
private int[] array;
spring会自动把空格去掉,导致数据中只有一个值:12345,注意千万别搞错了。
顺便说一下,定义数组的时候,里面还是有挺多门道的。比如上面列子中,我的数据是:1,2,3,4,5。
如果我们把数组定义成:short、int、long、char、string类型,spring是可以正常注入属性值的。
但如果把数组定义成:float、double类型,启动项目时就会直接报错。
小伙伴们,下巴惊掉了没?
按理说,1,2,3,4,5用float、double是能够表示的呀,为什么会报错?
如果使用int的包装类,比如:
@Value("${susan.test.array:1,2,3,4,5}")
private Integer[] array;
启动项目时同样会报上面的异常。
此外,定义数组时一定要注意属性值的类型,必须完全一致才可以,如果出现下面这种情况:
@Value("${susan.test.array:1.0,abc,3,4,5}")
private int[] array;
属性值中包含了1.0和abc,显然都无法将该字符串转换成int。
6.3 集合类
有了基本类型和数组,的确让我们更加方便了。但对数据的处理,只用数组这一种数据结构是远远不够的,下面给大家介绍一下其他的常用数据结构。
6.3.1 List
List是数组的变种,它的长度是可变的,而数组的长度是固定的。
我们看看List是如何注入属性值的:
@Value("${susan.test.list}")
private List list;
最关键的是看配置文件:
susan.test.list[0]=10
susan.test.list[1]=11
susan.test.list[2]=12
susan.test.list[3]=13
当你满怀希望的启动项目,准备使用这个功能的时候,却发现竟然报错了。
what?
看来@Value不支持这种直接的List注入。
但是可以改变写法,
sun:test:list: 10,11,12,13
@Value("${sun.test.list}")private List<Integer> tl;
运行截图:
那么,如何解决这个问题呢?
有人说用@ConfigurationProperties。
需要定义一个MyConfig类:
@Configuration
@ConfigurationProperties(prefix = "susan.test")
@Data
public class MyConfig {private List list;
}
然后在调用的地方这样写:
@Service
public class UserService {@Autowiredprivate MyConfig myConfig;public String test() {System.out.println(myConfig.getList());return null;}
}
这种方法确实能够完成List注入。但是,只能说明@ConfigurationProperties注解的强大,跟@Value有半毛钱的关系?
答:没有。
那么,问题来了,用@Value如何实现这个功能呢?
答:使用spring的EL表达式。
List的定义改成:
@Value("#{'${susan.test.list}'.split(',')}")
private List list;
使用#号加大括号的EL表达式。
然后配置文件改成:
susan.test.list=10,11,12,13
跟定义数组时的配置文件一样。
6.3.2 Set
Set也是一种保存数据的集合,它比较特殊,里面保存的数据不会重复。
我们可以这样定义Set:
@Value("#{'${susan.test.set}'.split(',')}")
private Set set;
配置文件是这样的:
susan.test.set=10,11,12,13
Set跟List的用法极为相似。
但为了证明本节的独特之处,我打算说点新鲜的内容。
如何给List或者Set设置默认值空呢?
有些朋友可能会说:这还不简单,直接在@Value的$表达式后面加个:号不就行了。
具体代码如下:
@Value("#{'${susan.test.set:}'.split(',')}")
private Set set;
结果却跟想象中不太一样:
Set集合怎么不是空的,而是包含了一个空字符串的集合?
好吧,那我在:号后加null,总可以了吧?
Set集合也不是空的,而是包含了一个"null"字符串的集合。
这也不行,那也不行,该如何是好?
答:使用EL表达式的empty方法。
具体代码如下:
@Value("#{'${susan.test.set:}'.empty ? null : '${susan.test.set:}'.split(',')}")
private Set set;
运行之后,结果对了:
其实List也有类似的问题,也能使用该方法解决问题。
在这里温馨的提醒一下,该判断的表达式比较复杂,自己手写非常容易写错,建议复制粘贴之后根据实际需求改改。
6.3.3 Map
还有一种比较常用的集合是map,它支持key/value键值对的形式保存数据,并且不会出现相同key的数据。
我们可以这样定义Map:
@Value("#{${susan.test.map}}")
private Map map;
配置文件是这样的:
susan.test.map={"name":"苏三", "age":"18"}
这种用法跟上面稍微有一点区别。
设置默认值的代码如下:
@Value("#{'${susan.test.map:}'.empty ? null : '${susan.test.map:}'}")
private Map map;
7 EL高端玩法
前面我们已经见识过spring EL表达式的用法了,在设置空的默认值时特别有用。
其实,empty方法只是它很普通的用法,还有更高端的用法,不信我们一起看看。
7.1 注入bean
以前我们注入bean,一般都是用的@Autowired或者@Resource注解。例如:
@Service
public class RoleService {public String getRoleName() {return "管理员";}
}@Service
public class UserService {@Autowiredprivate RoleService roleService;public String test() {System.out.println(roleService.getRoleName());return null;}
}
但我要告诉你的是@Value注解也可以注入bean,它是这么做的:
@Value("#{roleService}")
private RoleService roleService;
通过这种方式,可以注入id为roleService的bean。
7.2 bean的变量和方法
通过EL表达式,@Value注解已经可以注入bean了。既然能够拿到bean实例,接下来,可以再进一步。
在RoleService类中定义了:成员变量、常量、方法、静态方法。
@Service
public class RoleService {public static final int DEFAULT_AGE = 18;public int id = 1000;public String getRoleName() {return "管理员";}public static int getParentId() {return 2000;}
}
在调用的地方这样写:
@Service
public class UserService {@Value("#{roleService.DEFAULT_AGE}")private int myAge;@Value("#{roleService.id}")private int id;@Value("#{roleService.getRoleName()}")private String myRoleName;@Value("#{roleService.getParentId()}")private String myParentId;public String test() {System.out.println(myAge);System.out.println(id);System.out.println(myRoleName);System.out.println(myParentId);return null;}
}
在UserService类中通过@Value可以注入:成员变量、常量、方法、静态方法获取到的值,到相应的成员变量中。
一下子有没有豁然开朗的感觉,有了这些,我们可以通过@Value注解,实现更多的功能了,不仅仅限于注入系统属性。
7.3 静态类
前面的内容都是基于bean的,但有时我们需要调用静态类,比如:Math、xxxUtil等静态工具类的方法,该怎么办呢?
答:用T加括号。
示例1:
@Value("#{T(java.io.File).separator}")
private String path;
可以注入系统的路径分隔符到path中。
示例2:
@Value("#{T(java.lang.Math).random()}")
private double randomValue;
可以注入一个随机数到randomValue中。
7.4 逻辑运算
通过上面介绍的内容,我们可以获取到绝大多数类的变量和方法的值了。但有了这些值,还不够,我们能不能在EL表达式中加点逻辑?
拼接字符串:
@Value("#{roleService.roleName + '' + roleService.DEFAULT_AGE}")
private String value;
逻辑判断:
@Value("#{roleService.DEFAULT_AGE > 16 and roleService.roleName.equals('苏三')}")
private String operation;
三目运算:
@Value("#{roleService.DEFAULT_AGE > 16 ? roleService.roleName: '苏三' }")
private String realRoleName;
还有很多很多功能,我就不一一列举了。
EL表达式实在太强大了,对这方面如果感兴趣的小伙伴可以找我私聊。
8 ${}和#{}的区别
上面巴拉巴拉说了这么多@Value的牛逼用法,归根揭底就是${}和#{}的用法。
下面重点说说${}和#{}的区别,这可能是很多小伙伴比较关心的话题。
8.1 ${}
主要用于获取配置文件中的系统属性值。
例如:
@Value(value = "${susan.test.userName:susan}")
private String userName;
通过:可以设置默认值。如果在配置文件中找不到susan.test.userName的配置,则注入时用默认值。
如果在配置文件中找不到susan.test.userName的配置,也没有设置默认值,则启动项目时会报错。
8.2 #{}
主要用于通过spring的EL表达式,获取bean的属性,或者调用bean的某个方法。还有调用类的静态常量和静态方法。
@Value("#{roleService.DEFAULT_AGE}")
private int myAge;@Value("#{roleService.id}")
private int id;@Value("#{roleService.getRoleName()}")
private String myRoleName;@Value("#{T(java.lang.Math).random()}")
private double randomValue;
如果是调用类的静态方法,则需要加T(包名 + 方法名称)。
例如:T(java.lang.Math)。
@Value的诸多用法相关推荐
- 浅谈RxJava与2.0的新特性
简介 说起 RxJava ,相信诸多 Android 开发者都不会陌生.作为一个知名的响应式编程库,从前年开始逐渐变得火热,从小众到被众多 Android 开发者们广泛引入与流传,其在 GitHub ...
- 为什么说在Android中请求权限从来都不是一件简单的事情?
本文同步发表于我的微信公众号,扫一扫文章底部的二维码或在微信搜索 郭霖 即可关注,每个工作日都有文章更新. 周末时间参加了东莞和深圳的两场GDG,因为都是线上参与,所以时间上并不赶,我只需要坐在家里等 ...
- NSIS教程(8): 基于第三方界面库的安装包界面
推荐:NSIS-UI-Plugin 开源NSIS UI插件框架,支持任意第三方界面库,默认提供使用Qt作为界面库的安装包示例. 前面的几篇文章介绍了NSIS的传统界面的安装包和现代界面的安装包的制作方 ...
- Glide从V3到V4的探索
关于glide的前世今生,相信每一个搞Android开发的小伙伴都不会陌生,这里我也就不多做叙述了,不了解的小伙伴,可以先阅读https://github.com/bumptech/glide 这篇博 ...
- php mockery单元测试,使用testify和mockery库简化单元测试
前言 2016年我写过一篇关于Go语言单元测试的文章,简单介绍了 testing 库的使用方法.后来发现 testify/require 和 testify/assert 可以大大简化单元测试的写法, ...
- 【githubshare】Linux sed 命令行常用汇总:useful-sed,收集了 sed 命令行的诸多常见用法,可用于快速处理文本文件
Linux sed 命令行常用汇总:useful-sed,收集了 sed 命令行的诸多常见用法,可用于快速处理文本文件. 仓库内提供了不少示例,如输出文件首行内容,正则匹配替换文本内容.删除空文件.删 ...
- Dorado用法与示例
Dorado用法与示例 dorado用后总结 一.dorado概念 dorado的产品全名是"dorado展现中间件".从产品形态上dorado由两部分组成,第一部分是一个具有AJ ...
- python mysqldb cursor_python中MySQLdb模块用法实例
转载自:http://www.jb51.net/article/57290.htm 姓名:梅金波 学号:16010110036 [嵌牛导读]MySQLdb ...
- 【干货】eval函数用法解释及对开发者的便利讲解
个人见解,有选择阅读,欢迎评论指正 Python中,默认有个函数名为eval.这个函数在诸多像我一样的菜鸡圈子里,是很少用的.我也一直以为这个没什么特别大的作用.直到今天,我在读一个源代码的时候,突然 ...
最新文章
- [diango]理解django视图工作原理
- 数据分析(排序,数据特征、平均数、方差等,累计统计,相关分析)
- 在 .NET Framework 4.0 的程序中使用 .NET Framework 2.0 的程序集
- java visitor_java 的visitor方式
- python 插入排序,选择排序
- python基础知识-python基础知识,python必背内容,一、python的基
- Docker简介(转)
- hping3进行SYN Flood攻击
- 单表(sqlserver不支持)、整库,支持本地和远程备份
- 网友发帖曝最剽悍翻译 贵阳译成昂贵的太阳
- matlab怎么算不定积分,matlab计算不定积分
- I love you
- BIRD 与 BGP 的新手开场 --转
- spring boot打包本地idea跑能行,上线jar包跑不行 解决
- 只狼服务器维修或停机,只狼存档怎么替换 只狼存档损坏修复方法介绍_游侠网...
- P1931 套利-SPFA最长路与环的判断
- Vue3.0.0-beta.1 今天它来了!!!
- python开始_开始Python的新手教程
- 在docker中使用sqlplus
- 2020/7/17 积分不等式/反常积分/定积分应用
热门文章
- ModemManager 1.10发布
- python椭圆特征识别_opencv python中的椭圆检测
- 【C++】vector添加元素
- 改善监控过程中逆光的方法
- Django的搭建和小项目处理的过程(二)
- java -jar 工作原理_Java 中的 jar ,天天见,可是你知道它的运行机制吗?
- 2014计算机网络基础课程说课 张宗宝,2014年四川省省级资源共享课立项建设名单说课.doc...
- 百度、字节跳动们,能否撬动在线办公市场?
- 清橙 A1210. 光棱坦克
- new DecimalFormat(#0.###)中0与#