转载

Spring入门(九):运行时值注入

Spring提供了2种方式在运行时注入值:

  1. 属性占位符(Property placeholder)
  2. Spring表达式语言(SpEL)

1. 属性占位符

1.1 注入外部的值

1.1.1 使用Environment

一般情况下,我们会将一些值放到配置文件中,等程序运行时再把值注入到一些字段上。

假如,我们有一个test.properties配置文件,内容如下:

book.author=wangyunfei
book.name=spring boot
author.age=30

现在我们希望在程序运行时,把这个值分别赋值给字段bookAuthor和bookName,那么该如何实现呢?

首先,新建配置类ExpressiveConfig如下:

package chapter03.el;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;
import org.springframework.core.env.Environment;

@Configuration
@ComponentScan
@PropertySource("classpath:chapter03/el/test.properties")
public class ExpressiveConfig {
    @Autowired
    private Environment environment;

    public void outputResource() {
        System.out.println("book.name:" + environment.getProperty("book.name"));
        System.out.println("book.author:" + environment.getProperty("book.author"));
    }
}

这里我们使用@PropertySource注解引用了test.properties配置文件,这个文件的位置位于chapter03.el包下。

这个属性文件会加载到Spring的Environment中,然后我们就可以调用getProperty()方法获取到属性值。

新建Main类,在其main()方法中添加如下测试代码:

package chapter03.el;

import org.springframework.context.annotation.AnnotationConfigApplicationContext;

public class Main {
    public static void main(String[] args) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(ExpressiveConfig.class);

        ExpressiveConfig expressiveConfig = context.getBean(ExpressiveConfig.class);

        expressiveConfig.outputResource();

        context.close();
    }
}

运行代码,发现抛出 java.io.FileNotFoundException 异常,如下所示:

Spring入门(九):运行时值注入

从报错信息可以看出, 这是提示找不到chapter03/el/test.properties这个文件,这是为什么呢?

带着这个疑问,我们看下target目录下编译后的代码,如下所示: Spring入门(九):运行时值注入

从图中可以看出,我们新建的test.properties和test.txt文件并没有被编译到target目录下,所以才会抛出异常。

这是因为,我们新建文件的位置放在chapter03.el包下,而IDEA默认是不会把这些文件自动复制到target目录下的,但我们可以在pom.xml中添加如下配置来解决该问题:

<build>
    <resources>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.txt</include>
                <include>**/*.properties</include>
            </includes>
        </resource>
    </resources>
</build>

这里我们指定了txt和properties文件,如果需要,可以继续添加 <include> 标签指定xml等文件。

再次运行测试代码,输出日志如下所示:

book.name:spring boot
book.author:wangyunfei

此时target目录下已经包含了我们新建的2个文件:

Spring入门(九):运行时值注入

如果指定的属性值不存在,getProperty()会返回null,如下所示:

String workCity = environment.getProperty("author.workcity");
System.out.println("author.workcity:" + workCity);

输出结果:

author.workcity:null

getProperty()还提供了1个重载,当指定的属性值不存在时,可以指定默认值:

String workCity = environment.getProperty("author.workcity", "上海");
System.out.println("author.workcity:" + workCity);

输出结果:

author.workcity:上海

如果希望属性值必须存在,可以使用getRequiredProperty()方法,当属性值不存在时,会抛出 java.lang.IllegalStateException 异常:

String workCity = environment.getRequiredProperty("author.workcity");
System.out.println("author.workcity:" + workCity);

Spring入门(九):运行时值注入

getProperty()还提供了1个重载,可以指定返回值的类型,比如我们想返回Integer类型:

Integer authorAge = environment.getProperty("author.age", Integer.class);
System.out.println("author.age:" + authorAge);

输出结果:

author.age:30

getProperty()还提供了1个重载,当指定的属性值不存在时,不仅可以指定默认值,还可以指定返回值类型:

boolean isMan = environment.getProperty("author.isMan", Boolean.class, true);
System.out.println("author.isMan:" + isMan);

输出结果:

author.isMan:true

1.1.2 使用属性占位符

除了使用Environment获取外部的属性值,我们还可以使用属性占位符来获取。

在Spring装配中,占位符的形式为使用“${……}”包装的属性名称。

新建Book类如下:

package chapter03.el;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

@Component
public class Book {
    @Value("${book.name}")
    private String bookName;

    @Value("${book.author}")
    private String bookAuthor;

    public String getBookName() {
        return bookName;
    }

    public void setBookName(String bookName) {
        this.bookName = bookName;
    }

    public String getBookAuthor() {
        return bookAuthor;
    }

    public void setBookAuthor(String bookAuthor) {
        this.bookAuthor = bookAuthor;
    }
}

可以发现,我们在字段上添加了@Value注解,参数传的值就是属性占位符,用来获取属性文件中指定的属性值。

然后,在ExpressiveConfig配置类中添加如下代码:

@Autowired
private Book book;

public void outputResource() {
     System.out.println("book.name:" + book.getBookName());
     System.out.println("book.author:" + book.getBookAuthor());
}

输出结果:

book.name:spring boot
book.author:wangyunfei

2. Spring表达式语言

Spring表达式语言(Spring Expression Language,SpEL)是一种非常灵活的表达式语言,能够以一种强大和简洁的方式将值装配到bean属性或者构造器参数中,在这个过程中所使用的的表达式会在运行时计算值。

SpEL表达式要放到“#{……}”之中,而之前讲到的属性占位符是放到“${……}”之中。

接下来,我们分场景来看下Spring表达式语言的使用方法。

2.1 引用系统属性值

在ExpressiveConfig中添加如下代码:

@Value("#{systemProperties['os.name']}")
private String osName;

public void outputResource() {
    System.out.println("os.name:" + osName);
}

输出结果:

os.name:Windows 7

2.2 引用bean的属性和方法

首先,新建一个类DemoService如下所示:

package chapter03.el;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;

@Service
public class DemoService {
    @Value("DemoService类的another属性")
    private String another;

    public String getAnother() {
        return another;
    }

    public void setAnother(String another) {
        this.another = another;
    }
}

然后,在ExpressiveConfig中添加如下代码:

@Value("#{demoService.another}")
private String fromAnother;

public void outputResource() {
    System.out.println("demoService.another:" + fromAnother);
}

表达式中的demoService为DemoService bean的ID,another是它的属性。

输出结果:

demoService.another:DemoService类的another属性

表达式也可以修改为调用bean的方法:

@Value("#{demoService.getAnother()}")
private String fromAnother;

输出结果不变,只是从调用属性变成了调用方法。

调用完方法,可以对方法的返回值继续调用其它方法,比如toUpperCase():

@Value("#{demoService.getAnother()?.toUpperCase()}")
private String fromAnother;

之所以使用”?.”运算符,是为了避免当 demoService.getAnother() 返回null时,代码出现NullPointerException。

此时的输出结果为:

demoService.another:DEMOSERVICE类的ANOTHER属性

2.3 在表达式中使用类型

使用表达式生成1个随机数:

@Value("#{T(java.lang.Math).random()}")
private double randomNumber;

public void outputResource() {
    System.out.println("randomNumber:" + randomNumber);
}

这里我们使用T()引用了java.lang.Math类,然后调用了它的静态方法random()。

输出结果:

randomNumber:0.6801944394506442

2.4 使用运算符

上面的例子中,生成随机数后,我们还可以使用乘法运算符,如下所示:

@Value("#{T(java.lang.Math).random() * 100.0}")
private double randomNumber;

我们也可以在表达式中使用“+”运算符拼接字符串,如下所示:

@Value("#{book.getBookName() + ' write by ' + book.getBookAuthor()}")
private String bookDescr;

public void outputResource() {
    System.out.println("bookDescr:" + bookDescr);
}

其中book为Book bean的ID,输出结果如下所示:

bookDescr:spring boot write by wangyunfei

也可以在表达式中使用三元运算符:

@Value("#{systemProperties['os.name'] == 'Windows 7'?'Windows':'Linux'}")
private String osType;

public void outputResource() {
    System.out.println("osType:" + osType);
}

因为我的电脑系统是Windows 7,所以输出结果如下所示:

osType:Windows

SpEL还支持很多的运算符,这里只是列举了几个常用的例子,有兴趣的同学可以自己深入研究下。

3. 源码及参考

源码地址: https://github.com/zwwhnly/spring-action.git ,欢迎下载。

Craig Walls 《Spring实战(第4版)》

汪云飞《Java EE开发的颠覆者:Spring Boot实战》

IDEA maven项目src源代码下的资源文件不自动复制到classes文件夹的解决方法

4. 最后

打个小广告,欢迎扫码关注微信公众号:「申城异乡人」,定期分享Java技术干货,让我们一起进步。

Spring入门(九):运行时值注入

原文  http://www.zwwhnly.com/spring/2019/08/15/spring-expression-language.html
正文到此结束
Loading...