Polishing.

Refine wording around Environment and EvaluationContext presence.

See #3170

Author: mp911de

src/main/java/org/springframework/data/expression/ValueEvaluationContext.java

@@ -19,8 +19,8 @@
 import org.springframework.expression.EvaluationContext;
 
 /**
- * Expressions are executed in an evaluation context. It is in this context that references are resolved when
- * encountered during expression evaluation.
+ * Expressions are executed using an evaluation context. This context is used to resolve references during (SpEL,
+ * property placeholder) expression evaluation.
  *
  * @author Christoph Strobl
  * @author Mark Paluch
@@ -31,23 +31,23 @@ public interface ValueEvaluationContext {
 	/**
 	 * Returns a new {@link ValueEvaluationContext}.
 	 *
-	 * @param environment
-	 * @param evaluationContext
+	 * @param environment must not be {@literal null}.
+	 * @param evaluationContext must not be {@literal null}.
 	 * @return a new {@link ValueEvaluationContext} for the given environment and evaluation context.
 	 */
 	static ValueEvaluationContext of(Environment environment, EvaluationContext evaluationContext) {
 		return new DefaultValueEvaluationContext(environment, evaluationContext);
 	}
 
 	/**
-	 * Returns the {@link Environment} if provided.
+	 * Returns the {@link Environment}.
 	 *
 	 * @return the {@link Environment}.
 	 */
 	Environment getEnvironment();
 
 	/**
-	 * Returns the {@link EvaluationContext} if provided.
+	 * Returns the {@link EvaluationContext}.
 	 *
 	 * @return the {@link EvaluationContext}.
 	 */