对于最新的稳定版本，请使用 Spring Framework 6.2.10！spring-doc.cadn.net.cn

安全导航操作员

安全导航操作员 （?） 用于避免NullPointerException并来自来自 Groovy 语言。通常，当您对对象进行引用时，您可能需要验证它不是null在访问对象的方法或属性之前。为避免此作，安全导航运算符返回null对于特定的空安全作而不是抛出异常。spring-doc.cadn.net.cn

当安全导航操作员评估为null对于特定的空安全复合表达式中的作，复合表达式的其余部分将仍然被评估。spring-doc.cadn.net.cn

有关详细信息，请参阅复合表达式中的空安全作。spring-doc.cadn.net.cn

安全属性和方法访问

以下示例演示如何使用安全导航运算符进行属性访问 (?.).spring-doc.cadn.net.cn

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 在非 null 上使用安全导航运算符placeOfBirth属性
2 在 null 上使用安全导航运算符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 在非 null 上使用安全导航运算符placeOfBirth属性
2 在 null 上使用安全导航运算符placeOfBirth属性

安全导航运算符还适用于对象上的方法调用。spring-doc.cadn.net.cn

例如，表达式#calculator?.max(4, 2)评估为null如果#calculator变量尚未在上下文中配置。否则，max(int, int)方法将在#calculator.spring-doc.cadn.net.cn

安全馆藏选择和投影

Spring 表达式语言支持通过以下运算符的安全导航来选择集合和集合投影以下运算符。spring-doc.cadn.net.cn

以下示例演示如何使用安全导航运算符进行收集selection （?.?).spring-doc.cadn.net.cn

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 使用 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 使用 null 安全选择运算符members列表

以下示例演示了如何使用“空安全先选择”运算符集合 （?.^).spring-doc.cadn.net.cn

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 使用 “null-safe select first” 运算符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 使用 “null-safe select first” 运算符members列表

以下示例演示如何使用“空安全选择最后”运算符集合 （?.$).spring-doc.cadn.net.cn

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 使用 “null-safe select last” 运算符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 使用 “null-safe select last” 运算符members列表

以下示例演示如何使用安全导航运算符进行收集 投影 （?.!).spring-doc.cadn.net.cn

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 对 null 使用 null 安全投影运算符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 对 null 使用 null 安全投影运算符members列表

复合表达式中的空安全运算

如本节开头所述，当安全导航操作员 评估为null对于复合表达式中的特定空安全作， 仍将评估化合物表达式的其余部分。这意味着 安全导航运算符必须应用于整个复合表达式，以便 避免任何不需要的NullPointerException.spring-doc.cadn.net.cn

给定表达式#person?.address.city如果#person是null安全导航 运算符 （?.） 确保在尝试访问address属性#person.但是，由于#person?.address评估为null一个NullPointerException在尝试访问city属性null.为了解决这个问题，您可以在整个化合物中应用空安全导航 表达式，如#person?.address?.city.该表达式将安全地计算为null如果#person或#person?.address评估为null.spring-doc.cadn.net.cn

以下示例演示如何使用“空安全优先选择”运算符 (?.^） 与空安全属性访问 （?.） 在化合物中 表达。如果members是null，“空安全先选择”运算符的结果 (members?.^[nationality == 'Serbian']） 的计算结果为null，以及 安全导航操作员 （?.name）确保整个化合物表达 评估为null而不是抛出异常。spring-doc.cadn.net.cn

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 在复合表达式中使用“空安全优先选择”和空安全属性访问运算符。