安全导航操作符

安全导航操作符（?.）用于避免 NullPointerException，它源自 Groovy 语言。通常，当您引用一个对象时，可能需要在访问该对象的方法或属性之前验证它是否为 null。为避免此问题，安全导航操作符会为特定的空安全操作返回 null，而不是抛出异常。

当复合表达式中的特定空安全操作使用安全导航操作符评估为 null 时，复合表达式的剩余部分仍将继续评估。

详情请参阅复合表达式中的空安全操作。

安全的属性和方法访问

以下示例展示了如何将安全导航操作符用于属性访问（?.）。

  • Java

  • Kotlin

ExpressionParser parser = new SpelExpressionParser();
EvaluationContext context = SimpleEvaluationContext.forReadOnlyDataBinding().build();

Inventor tesla = new Inventor("Nikola Tesla", "Serbian");
tesla.setPlaceOfBirth(new PlaceOfBirth("Smiljan"));

// evaluates to "Smiljan"
String city = parser.parseExpression("placeOfBirth?.city") (1)
		.getValue(context, tesla, String.class);

tesla.setPlaceOfBirth(null);

// evaluates to null - does not throw NullPointerException
city = parser.parseExpression("placeOfBirth?.city") (2)
		.getValue(context, tesla, String.class);
1 在非空的 placeOfBirth 属性上使用安全导航操作符
2 在空的 placeOfBirth 属性上使用安全导航操作符 
val parser = SpelExpressionParser()
val context = SimpleEvaluationContext.forReadOnlyDataBinding().build()

val tesla = Inventor("Nikola Tesla", "Serbian")
tesla.setPlaceOfBirth(PlaceOfBirth("Smiljan"))

// evaluates to "Smiljan"
var city = parser.parseExpression("placeOfBirth?.city") (1)
		.getValue(context, tesla, String::class.java)

tesla.setPlaceOfBirth(null)

// evaluates to null - does not throw NullPointerException
city = parser.parseExpression("placeOfBirth?.city") (2)
		.getValue(context, tesla, String::class.java)
1 在非空的 placeOfBirth 属性上使用安全导航操作符
2 在空的 placeOfBirth 属性上使用安全导航操作符

安全导航操作符也适用于对象上的方法调用。

例如，表达式 #calculator?.max(4, 2) 如果上下文中的 #calculator 变量未配置，则评估为 null。否则，将在 #calculator 上调用 max(int, int) 方法。

安全索引访问

从 Spring Framework 6.2 开始，Spring Expression Language 支持对以下类型结构进行空安全索引访问。

以下示例展示了如何将安全导航操作符用于列表索引（?.[]）。

  • Java

  • Kotlin

ExpressionParser parser = new SpelExpressionParser();
IEEE society = new IEEE();
EvaluationContext context = new StandardEvaluationContext(society);

// evaluates to Inventor("Nikola Tesla")
Inventor inventor = parser.parseExpression("members?.[0]") (1)
		.getValue(context, Inventor.class);

society.members = null;

// evaluates to null - does not throw an exception
inventor = parser.parseExpression("members?.[0]") (2)
		.getValue(context, Inventor.class);
1 在非空的 members 列表上使用空安全索引操作符
2 在空的 members 列表上使用空安全索引操作符 
val parser = SpelExpressionParser()
val society = IEEE()
val context = StandardEvaluationContext(society)

// evaluates to Inventor("Nikola Tesla")
var inventor = parser.parseExpression("members?.[0]") (1)
		.getValue(context, Inventor::class.java)

society.members = null

// evaluates to null - does not throw an exception
inventor = parser.parseExpression("members?.[0]") (2)
		.getValue(context, Inventor::class.java)
1 在非空的 members 列表上使用空安全索引操作符
2 在空的 members 列表上使用空安全索引操作符

安全的集合选择和投影

Spring Expression Language 通过以下操作符支持对集合选择和集合投影进行空安全导航。

  • 空安全选择: ?.?

  • 空安全选择第一个: ?.^

  • 空安全选择最后一个: ?.$

  • 空安全投影: ?.!

以下示例展示了如何将安全导航操作符用于集合选择（?.?）。

  • Java

  • Kotlin

ExpressionParser parser = new SpelExpressionParser();
IEEE society = new IEEE();
StandardEvaluationContext context = new StandardEvaluationContext(society);
String expression = "members?.?[nationality == 'Serbian']"; (1)

// evaluates to [Inventor("Nikola Tesla")]
List<Inventor> list = (List<Inventor>) parser.parseExpression(expression)
		.getValue(context);

society.members = null;

// evaluates to null - does not throw a NullPointerException
list = (List<Inventor>) parser.parseExpression(expression)
		.getValue(context);
1 在可能为 null 的 members 列表上使用空安全选择操作符 
val parser = SpelExpressionParser()
val society = IEEE()
val context = StandardEvaluationContext(society)
val expression = "members?.?[nationality == 'Serbian']" (1)

// evaluates to [Inventor("Nikola Tesla")]
var list = parser.parseExpression(expression)
		.getValue(context) as List<Inventor>

society.members = null

// evaluates to null - does not throw a NullPointerException
list = parser.parseExpression(expression)
		.getValue(context) as List<Inventor>
1 在可能为 null 的 members 列表上使用空安全选择操作符

以下示例展示了如何将“空安全选择第一个”操作符用于集合（?.^）。

  • Java

  • Kotlin

ExpressionParser parser = new SpelExpressionParser();
IEEE society = new IEEE();
StandardEvaluationContext context = new StandardEvaluationContext(society);
String expression =
	"members?.^[nationality == 'Serbian' || nationality == 'Idvor']"; (1)

// evaluates to Inventor("Nikola Tesla")
Inventor inventor = parser.parseExpression(expression)
		.getValue(context, Inventor.class);

society.members = null;

// evaluates to null - does not throw a NullPointerException
inventor = parser.parseExpression(expression)
		.getValue(context, Inventor.class);
1 在可能为 null 的 members 列表上使用“空安全选择第一个”操作符 
val parser = SpelExpressionParser()
val society = IEEE()
val context = StandardEvaluationContext(society)
val expression =
	"members?.^[nationality == 'Serbian' || nationality == 'Idvor']" (1)

// evaluates to Inventor("Nikola Tesla")
var inventor = parser.parseExpression(expression)
		.getValue(context, Inventor::class.java)

society.members = null

// evaluates to null - does not throw a NullPointerException
inventor = parser.parseExpression(expression)
		.getValue(context, Inventor::class.java)
1 在可能为 null 的 members 列表上使用“空安全选择第一个”操作符

以下示例展示了如何将“空安全选择最后一个”操作符用于集合（?.$）。

  • Java

  • Kotlin

ExpressionParser parser = new SpelExpressionParser();
IEEE society = new IEEE();
StandardEvaluationContext context = new StandardEvaluationContext(society);
String expression =
	"members?.$[nationality == 'Serbian' || nationality == 'Idvor']"; (1)

// evaluates to Inventor("Pupin")
Inventor inventor = parser.parseExpression(expression)
		.getValue(context, Inventor.class);

society.members = null;

// evaluates to null - does not throw a NullPointerException
inventor = parser.parseExpression(expression)
		.getValue(context, Inventor.class);
1 在可能为 null 的 members 列表上使用“空安全选择最后一个”操作符 
val parser = SpelExpressionParser()
val society = IEEE()
val context = StandardEvaluationContext(society)
val expression =
	"members?.$[nationality == 'Serbian' || nationality == 'Idvor']" (1)

// evaluates to Inventor("Pupin")
var inventor = parser.parseExpression(expression)
		.getValue(context, Inventor::class.java)

society.members = null

// evaluates to null - does not throw a NullPointerException
inventor = parser.parseExpression(expression)
		.getValue(context, Inventor::class.java)
1 在可能为 null 的 members 列表上使用“空安全选择最后一个”操作符

以下示例展示了如何将安全导航操作符用于集合投影（?.!）。

  • Java

  • Kotlin

ExpressionParser parser = new SpelExpressionParser();
IEEE society = new IEEE();
StandardEvaluationContext context = new StandardEvaluationContext(society);

// evaluates to ["Smiljan", "Idvor"]
List placesOfBirth = parser.parseExpression("members?.![placeOfBirth.city]") (1)
		.getValue(context, List.class);

society.members = null;

// evaluates to null - does not throw a NullPointerException
placesOfBirth = parser.parseExpression("members?.![placeOfBirth.city]") (2)
		.getValue(context, List.class);
1 在非空的 members 列表上使用空安全投影操作符
2 在空的 members 列表上使用空安全投影操作符 
val parser = SpelExpressionParser()
val society = IEEE()
val context = StandardEvaluationContext(society)

// evaluates to ["Smiljan", "Idvor"]
var placesOfBirth = parser.parseExpression("members?.![placeOfBirth.city]") (1)
		.getValue(context, List::class.java)

society.members = null

// evaluates to null - does not throw a NullPointerException
placesOfBirth = parser.parseExpression("members?.![placeOfBirth.city]") (2)
		.getValue(context, List::class.java)
1 在非空的 members 列表上使用空安全投影操作符
2 在空的 members 列表上使用空安全投影操作符

复合表达式中的空安全操作

如本节开头所述，当复合表达式中的特定空安全操作使用安全导航操作符评估为 null 时，复合表达式的剩余部分仍将继续评估。这意味着安全导航操作符必须应用于整个复合表达式中，以避免出现任何不期望的 NullPointerException。

给定表达式 #person?.address.city，如果 #person 为 null，安全导航操作符（?.）确保在尝试访问 #person 的 address 属性时不会抛出异常。然而，由于 #person?.address 评估为 null，在尝试访问 null 的 city 属性时将抛出 NullPointerException。为了解决这个问题，您可以在整个复合表达式中应用空安全导航，例如 #person?.address?.city。如果 #person 或 #person?.address 评估为 null，该表达式将安全地评估为 null。

以下示例演示了如何在复合表达式中使用集合上的“空安全选择第一个”操作符（?.^）结合空安全属性访问（?.）。如果 members 为 null，则“空安全选择第一个”操作符（members?.^[nationality == 'Serbian']）的结果评估为 null，并且附加使用的安全导航操作符（?.name）确保整个复合表达式评估为 null，而不是抛出异常。

  • Java

  • Kotlin

ExpressionParser parser = new SpelExpressionParser();
IEEE society = new IEEE();
StandardEvaluationContext context = new StandardEvaluationContext(society);
String expression = "members?.^[nationality == 'Serbian']?.name"; (1)

// evaluates to "Nikola Tesla"
String name = parser.parseExpression(expression)
		.getValue(context, String.class);

society.members = null;

// evaluates to null - does not throw a NullPointerException
name = parser.parseExpression(expression)
		.getValue(context, String.class);
1 在复合表达式中使用“空安全选择第一个”和空安全属性访问操作符。 
val parser = SpelExpressionParser()
val society = IEEE()
val context = StandardEvaluationContext(society)
val expression = "members?.^[nationality == 'Serbian']?.name" (1)

// evaluates to "Nikola Tesla"
String name = parser.parseExpression(expression)
		.getValue(context, String::class.java)

society.members = null

// evaluates to null - does not throw a NullPointerException
name = parser.parseExpression(expression)
		.getValue(context, String::class.java)
1 在复合表达式中使用“空安全选择第一个”和空安全属性访问操作符。