值表示式基礎

值表示式是 Spring Expression Language (SpEL) 和屬性預留位置解析的組合。它們結合了程式化表示式的強大評估能力，以及簡化為屬性預留位置解析以從環境（例如組態屬性）中取得值的能力。

表示式應由受信任的輸入（例如註解值）定義，而不應由使用者輸入決定。

以下程式碼示範如何在註解的上下文中使用表示式。

範例 1. 註解用法

@Document("orders-#{tenantService.getOrderCollection()}-${tenant-config.suffix}")
class Order {
  // …
}

值表示式可以從單獨的 SpEL 表示式、屬性預留位置或混合各種表示式（包括字面值）的複合表示式定義。

範例 2. 表示式範例

#{tenantService.getOrderCollection()}                          (1)
#{(1+1) + '-hello-world'}                                      (2)
${tenant-config.suffix}                                        (3)
orders-${tenant-config.suffix}                                 (4)
#{tenantService.getOrderCollection()}-${tenant-config.suffix}  (5)

1	使用單個 SpEL 表示式的值表示式。
2	使用靜態 SpEL 表示式（評估為 2-hello-world）的值表示式。
3	使用單個屬性預留位置的值表示式。
4	由字面值 orders- 和屬性預留位置 ${tenant-config.suffix} 組成的複合表示式。
5	使用 SpEL、屬性預留位置和字面值的複合表示式。

使用值表示式為您的程式碼引入了很大的彈性。這樣做需要在每次使用時評估表示式，因此，值表示式評估會對效能概況產生影響。

剖析與評估

值表示式由 ValueExpressionParser API 剖析。ValueExpression 的實例是執行緒安全的，並且可以快取以供日後使用，以避免重複剖析。

以下範例顯示 Value Expression API 的用法

剖析與評估

Java
Kotlin

ValueParserConfiguration configuration = SpelExpressionParser::new;
ValueEvaluationContext context = ValueEvaluationContext.of(environment, evaluationContext);

ValueExpressionParser parser = ValueExpressionParser.create(configuration);
ValueExpression expression = parser.parse("Hello, World");
Object result = expression.evaluate(context);

val configuration = ValueParserConfiguration { SpelExpressionParser() }
val context = ValueEvaluationContext.of(environment, evaluationContext)

val parser = ValueExpressionParser.create(configuration)
val expression: ValueExpression = parser.parse("Hello, World")
val result: Any = expression.evaluate(context)

SpEL 表示式

SpEL 表示式遵循範本樣式，其中表示式預期包含在 #{…} 格式中。表示式使用由 EvaluationContextProvider 提供的 EvaluationContext 進行評估。上下文本身是一個強大的 StandardEvaluationContext，允許廣泛的操作、對靜態類型的存取和上下文擴充。

請務必僅剖析和評估來自受信任來源（例如註解）的表示式。接受使用者提供的表示式可能會建立一個入口路徑，以利用應用程式上下文和您的系統，從而導致潛在的安全性漏洞。

擴充評估上下文

EvaluationContextProvider 及其反應式變體 ReactiveEvaluationContextProvider 提供對 EvaluationContext 的存取。ExtensionAwareEvaluationContextProvider 及其反應式變體 ReactiveExtensionAwareEvaluationContextProvider 是預設實作，用於從應用程式上下文（特別是 ListableBeanFactory）判斷上下文擴充。

擴充功能實作 EvaluationContextExtension 或 ReactiveEvaluationContextExtension，以提供擴充支援來填入 EvaluationContext。它們是根物件、屬性和函數（頂層方法）。

以下範例顯示了一個上下文擴充，它提供了根物件、屬性、函數和一個別名函數。

實作 EvaluationContextExtension

Java
Kotlin

@Component
public class MyExtension implements EvaluationContextExtension {

    @Override
    public String getExtensionId() {
        return "my-extension";
    }

    @Override
    public Object getRootObject() {
        return new CustomExtensionRootObject();
    }

    @Override
    public Map<String, Object> getProperties() {

        Map<String, Object> properties = new HashMap<>();

        properties.put("key", "Hello");

        return properties;
    }

    @Override
    public Map<String, Function> getFunctions() {

        Map<String, Function> functions = new HashMap<>();

        try {
            functions.put("aliasedMethod", new Function(getClass().getMethod("extensionMethod")));
            return functions;
        } catch (Exception o_O) {
            throw new RuntimeException(o_O);
        }
    }

    public static String extensionMethod() {
        return "Hello World";
    }

    public static int add(int i1, int i2) {
        return i1 + i2;
    }

}

public class CustomExtensionRootObject {

	public boolean rootObjectInstanceMethod() {
		return true;
	}

}

@Component
class MyExtension : EvaluationContextExtension {

    override fun getExtensionId(): String {
        return "my-extension"
    }

    override fun getRootObject(): Any? {
        return CustomExtensionRootObject()
    }

    override fun getProperties(): Map<String, Any> {
        val properties: MutableMap<String, Any> = HashMap()

        properties["key"] = "Hello"

        return properties
    }

    override fun getFunctions(): Map<String, Function> {
        val functions: MutableMap<String, Function> = HashMap()

        try {
            functions["aliasedMethod"] = Function(javaClass.getMethod("extensionMethod"))
            return functions
        } catch (o_O: Exception) {
            throw RuntimeException(o_O)
        }
    }

    companion object {
        fun extensionMethod(): String {
            return "Hello World"
        }

        fun add(i1: Int, i2: Int): Int {
            return i1 + i2
        }
    }
}

class CustomExtensionRootObject {
	fun rootObjectInstanceMethod(): Boolean {
		return true
	}
}

一旦註冊了上面顯示的擴充功能，您就可以使用其匯出的方法、屬性和根物件來評估 SpEL 表示式

範例 3. 表示式評估範例

#{add(1, 2)}                                             (1)
#{extensionMethod()}                                     (2)
#{aliasedMethod()}                                       (3)
#{key}                                                   (4)
#{rootObjectInstanceMethod()}                            (5)

1	調用 MyExtension 宣告的 `add` 方法，結果為 `3`，因為該方法會將兩個數值參數相加並傳回總和。
2	調用 MyExtension 宣告的 `extensionMethod` 方法，結果為 `Hello World`。
3	調用 `aliasedMethod` 方法。該方法作為函數公開，並重新導向到 MyExtension 宣告的 `extensionMethod` 方法，結果為 `Hello World`。
4	評估 `key` 屬性，結果為 `Hello`。
5	在根物件實例 `CustomExtensionRootObject` 上調用 `rootObjectInstanceMethod` 方法。

您可以在 SecurityEvaluationContextExtension 中找到真實的上下文擴充功能。

屬性預留位置

遵循 ${…} 形式的屬性預留位置指的是通常由 PropertySource 透過 Environment 提供的屬性。屬性對於解析系統屬性、應用程式組態檔、環境組態或由密碼管理系統貢獻的屬性來源非常有用。您可以在 Spring Framework 關於 @Value 用法的檔案中找到有關屬性預留位置的更多詳細資訊。