Spring Framework学习小记

Spring Expression Language(SpEL)

The Spring Expression Language (“SpEL” for short) is a powerful expression language that supports querying and manipulating an object graph at runtime. The language syntax is similar to Unified EL but offers additional features, most notably method invocation and basic string templating functionality.

详情参阅：https://docs.spring.io/spring-framework/docs/current/reference/html/core.html#expressions

模式配置（SpelCompilerMode）：解释执行模式（OFF）、编译模式（IMMEDIATE）、混合模式（MIXED）

使用示例：

Bean中使用（Expressions in Bean Definitions）：

//1
public class FieldValueTestBean {

    @Value("#{ systemProperties['user.region'] }")
    private String defaultLocale;

    public void setDefaultLocale(String defaultLocale) {
        this.defaultLocale = defaultLocale;
    }

    public String getDefaultLocale() {
        return this.defaultLocale;
    }
}


//2
public class PropertyValueTestBean {

    private String defaultLocale;

    @Value("#{ systemProperties['user.region'] }")
    public void setDefaultLocale(String defaultLocale) {
        this.defaultLocale = defaultLocale;
    }

    public String getDefaultLocale() {
        return this.defaultLocale;
    }
}

//3
public class SimpleMovieLister {

    private MovieFinder movieFinder;
    private String defaultLocale;

    @Autowired
    public void configure(MovieFinder movieFinder,
            @Value("#{ systemProperties['user.region'] }") String defaultLocale) {
        this.movieFinder = movieFinder;
        this.defaultLocale = defaultLocale;
    }

    // ...
}

代码路径中动态使用SpEL：（参阅：https://docs.spring.io/spring-framework/docs/current/reference/html/core.html#expressions-language-ref）

package com.sensetime.sensestudy.exptool.web;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import org.springframework.expression.EvaluationContext;
import org.springframework.expression.ExpressionParser;
import org.springframework.expression.common.TemplateParserContext;
import org.springframework.expression.spel.SpelParserConfiguration;
import org.springframework.expression.spel.standard.SpelExpressionParser;
import org.springframework.expression.spel.support.SimpleEvaluationContext;

import lombok.Data;

/**
 * @see <a href=
 *      'https://docs.spring.io/spring-framework/docs/current/reference/html/core.html#expressions-language-ref'>https://docs.spring.io/spring-framework/docs/current/reference/html/core.html#expressions-language-ref</a>
 */
public class SpELTest {
    @Data
    public static class Person {
        private String name;
        private List<Boolean> booleans = new ArrayList<>();
        private List<String> nickNames;
        private Map<String, Integer> friendAge = new HashMap<>();
    }

    public static void main(String[] args) throws NoSuchMethodException, SecurityException {

        ExpressionParser parser = new SpelExpressionParser();

        // 1 Literal Expressions
        System.err.println(parser.parseExpression("1+7").getValue());// 8
        System.err.println(parser.parseExpression("-6.0221415E+23").getValue(Double.class));// -6.0221415E23
        System.err.println(parser.parseExpression("0x7FFFFFFF").getValue(Integer.class));// 2147483647
        System.err.println(parser.parseExpression("true").getValue(Boolean.class));// true
        System.err.println(parser.parseExpression("null").getValue(Double.class));// null

        System.err.println(parser.parseExpression("'Hello World'").getValue());// Hello World
        System.err.println(parser.parseExpression("'Hello World'").getValue(String.class));// Hello World
        System.err.println();

        Person p = new Person();
        p.setName("张三丰");
        p.getBooleans().add(true);
        p.getFriendAge().put("小李", 10);

        System.err.println(parser.parseExpression("name").getValue(p));// 张三丰
        System.err.println(parser.parseExpression("getName()").getValue(p));// 张三丰
        System.err.println(parser.parseExpression("name").getValue(p, String.class));// 张三丰
        System.err.println();

        // 2 Properties, Arrays, Lists, Maps, and Indexers
        System.err.println(parser.parseExpression("getBooleans()[0]").getValue(p));// true
        System.err.println(parser.parseExpression("getFriendAge()['小李']").getValue(p));// 10

        parser.parseExpression("booleans[0]").setValue(SimpleEvaluationContext.forReadOnlyDataBinding().build(), p, "false");// 会自动进行类型转换
        System.err.println(p.getBooleans().get(0));// false

        new SpelExpressionParser(new SpelParserConfiguration(true, true)).parseExpression("nickNames[3]").getValue(p);// 通过SpelParserConfiguration配置自动对Array或Collection进行容量扩展和元素初始化
        System.err.println(p.getNickNames().size());// 4
        System.err.println();

        // 3 Inline lists, Inline Maps
        Object val1 = parser.parseExpression("{1,2,3,4}").getValue();
        System.err.println(val1);// [1, 2, 3, 4]
        System.err.println(val1.getClass());// class java.util.Collections$UnmodifiableRandomAccessList
        System.err.println(parser.parseExpression("{{1,2},{3,4}}").getValue());// [[1, 2], [3, 4]]

        Object val2 = parser.parseExpression("{name:'zhangsan', age:20}").getValue();
        System.err.println(val2);// {name=zhangsan, age=20}
        System.err.println(val2.getClass());// class java.util.Collections$UnmodifiableMap
        System.err.println(parser.parseExpression("{p1:{1,2}, p2:{3,4}}").getValue());// {p1=[1, 2], p2=[3, 4]}
        System.err.println();

        // 4 Array Construction
        int[] numbers1 = (int[]) parser.parseExpression("new int[4]").getValue();
        int[] numbers2 = (int[]) parser.parseExpression("new int[]{1,2,3}").getValue();
        int[][] numbers3 = (int[][]) parser.parseExpression("new int[4][5]").getValue();
        System.err.println();

        // 5 Methods
        System.err.println(parser.parseExpression("'Hello World'.concat('!')").getValue());// Hello World!
        System.err.println(parser.parseExpression("'Hello World'.bytes.length").getValue());// 11
        System.err.println();

        // 6 Operators: Relational Operators, Logical Operators, Mathematical Operators
        System.err.println(parser.parseExpression("name=='张三丰'").getValue(p));// true
        System.err.println(parser.parseExpression("1 < 2").getValue());// true
        System.err.println(parser.parseExpression("1 lt 2").getValue());// true
        System.err.println(parser.parseExpression("'a' < 'b'").getValue());// true
        System.err.println(parser.parseExpression("2 instanceof T(Integer)").getValue());// true
        System.err.println(parser.parseExpression("'5.00' matches '^-?\d+(\.\d{2})?$'").getValue());// true

        System.err.println(parser.parseExpression("true and false").getValue(Boolean.class));// false
        System.err.println(parser.parseExpression("true or false").getValue(Boolean.class));// true
        System.err.println(parser.parseExpression("not false").getValue(Boolean.class));// true
        System.err.println(parser.parseExpression("! false").getValue(Boolean.class));// true

        System.err.println(parser.parseExpression(" 1 + -1*8 + 7%4 +8/3 - -1").getValue());// -1
        System.err.println();

        // 7 Types
        System.err.println(parser.parseExpression("T(System).getProperty('user.dir')").getValue());/// Users/zhangsan/software/eclipse-workspace/CourseDesignServer
        System.err.println(parser.parseExpression("T(java.util.Date)").getValue(Class.class));// class java.util.Date
        System.err.println(parser.parseExpression("T(java.math.RoundingMode).CEILING < T(java.math.RoundingMode).FLOOR").getValue());// true
        System.err.println();

        // 8 Variables
        EvaluationContext context = SimpleEvaluationContext.forReadWriteDataBinding().build();// new StandardEvaluationContext();
        context.setVariable("newName", "张君宝");
        System.err.println(parser.parseExpression("name = #newName").getValue(context, p)); // 张君宝
        System.err.println(p.getName());// 张君宝

        context.setVariable("primes", Arrays.asList(2, 3, 5, 7, 11, 13, 17));
        System.err.println(parser.parseExpression("#primes.?[#this>10]").getValue(context));// [11, 13, 17]
        System.err.println(parser.parseExpression("#primes.#this").getValue(context, p));// [2, 3, 5, 7, 11, 13, 17]
        System.err.println(parser.parseExpression("#primes.#root").getValue(context, p));// SpELTest.Person(name=张君宝, booleans=[false], nickNames=[, , , ],
                                                                                            // friendAge={小李=10})
        System.err.println(parser.parseExpression("#this").getValue(context, p));// SpELTest.Person(name=张君宝, booleans=[false], nickNames=[, , , ],
                                                                                    // friendAge={小李=10})
        System.err.println(parser.parseExpression("#root").getValue(context, p));// SpELTest.Person(name=张君宝, booleans=[false], nickNames=[, , , ],
                                                                                    // friendAge={小李=10})
        // The #this variable is always defined and refers to the current evaluation
        // object, The #root variable is always defined and refers to the root context
        // object.
        System.err.println();

        // 9 Register Functions
        context.setVariable("myReverseString", SpELTest.class.getDeclaredMethod("reverseString", String.class));
        System.err.println(parser.parseExpression("#myReverseString('hello')").getValue(context));// olleh
        System.err.println();

        // 10 Ternary Operator (If-Then-Else), Elvis Operator
        System.err.println(parser.parseExpression("name?:'Unknown'").getValue(p));// 张君宝
        System.err.println(parser.parseExpression("1>0?'yes':'no' ").getValue());// yes
        System.err.println(parser.parseExpression("1>0?:'no' ").getValue());// true
        System.err.println();

        // 11 Collection Selection. Selection is possible upon both lists and maps.
        // .?[selectionExpression] all matched elements
        // .^[selectionExpression] first matched elements
        // .$[selectionExpression] last matched elements

//        System.err.println(parser.parseExpression("booleans.?[#this=true]").getValue(p));//

        p.getFriendAge().put("小张", 20);
        System.err.println(parser.parseExpression("friendAge.?[value>10] ").getValue(p));// {小张=20}
        System.err.println(parser.parseExpression("friendAge.?[key!=null] ").getValue(p));// {小李=10, 小张=20}
        System.err.println(parser.parseExpression("friendAge.^[key!=null] ").getValue(p));// {小李=10}
        System.err.println(parser.parseExpression("friendAge.$[key!=null] ").getValue(p));// {小张=20}
        System.err.println();

        // 12 Collection Projection. .![projectionExpression]
        System.err.println(parser.parseExpression("friendAge.![key+value] ").getValue(p));// [小李10, 小张20]
        System.err.println();

        // 13 Expression templating
        System.err.println(parser.parseExpression("random number is #{T(java.lang.Math).random()}", new TemplateParserContext()).getValue());// random number is 0.7043883689415746
        System.err.println();

    }

    public static String reverseString(String input) {
        StringBuilder backwards = new StringBuilder(input.length());
        for (int i = 0; i < input.length(); i++) {
            backwards.append(input.charAt(input.length() - 1 - i));
        }
        return backwards.toString();
    }
}

String类型自动转换

强烈推荐阅读下面列出的各文章，写得深入易懂。

Spring Framework中的String类型转换器、格式化器经过了多个发展阶段，概述如下（详情参阅：Spring类型转换-框架设计的基石）：

1 PropertyEditor： （名字的由来：早期JDK AWT中为了解析GUI界面用户输入的值而引入，故叫ProperEditor，Spring基于PropertyEditor做增强）

Spring PropertyEditor及其各种实现：ProperyEditor、ProperyEditorSupport

Spring对PropertyEditor的注册和管理机制：PropertyEditorRegistry、PropertyEditorRegistrySupport、PropertyEditorRegistrar。

PropertyEditorRegistrar在Spring内的唯一实现为ResourceEditorRegistrar，配置文件转为Resource（如配置classpath:xxx.xml用来启动Spring容器的配置文件，String -> Resource转换）就是它的功劳。

2 新一代类型转换器：Spring 新一代类型转换机制。Spring中对HTTP请求参数的自动解析转换、@Value参数的解析等都是基于此。

转换器接口及其实现：

Converter<S, T>：  Source -> Target类型转换接口，适用于1:1转换

ConverterFactory<S, R>：  Source -> R类型转换接口，适用于1:N转换

GenericConverter：  更为通用的类型转换接口，适用于N:N转换

ConditionalConverter：  可跟上面3个接口搭配组合使用，提供前置条件判断验证

3 ConversionService：上述转换器的注册和管理，见 注册中心服务

ConverterRegistry、ConversionService、DefaultConversionService、ConversionServiceFactoryBean

4 JDK的format（java.text.format）：DateFormat、NumberFormat、MessageFormat。详情参阅 JDK 格式化器

DateFormat：日期时间格式化——日期字符串与Java日期类型间的解析或格式化

NumberFormat：数值格式化

DecimalFormat：数值的有效位保留、科学技术法、分组分隔、百分数表示、货币符表示

ChoiceFormat：维护数字与字符串间的对应关系。用的很少。

MessageFormat：字符串格式——用于在字符串中插入参数

缺点：设计上存在一定缺陷，过于底层无法标准化对使用者不够友好等。

 、

5 大一统的Spring Format

Spring格式化器：org.springframework.format.Formatter，进行了应用层面的封装，更友好易用，内部还是借助 java.text.Format、java.time下的format 、java.text.NumberFormat 等实现。

Spring格式化器的注册中心：FormatterRegistry，此接口继承自类型转换器注册中心 ConverterRegistry，所以格式化注册中心是转换器注册中心的加强版，是其超集，功能更多更强大。

FormatterRegistry、FormattingConversionService、DefaultFormattingConversionService

  、