Polishing

spring-expression/src/main/java/org/springframework/expression/BeanResolver.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2016 the original author or authors.
+ * Copyright 2002-2018 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -17,10 +17,9 @@
 package org.springframework.expression;
 
 /**
- * A bean resolver can be registered with the evaluation context
- * and will kick in for {@code @myBeanName} and {@code &myBeanName} expressions.
- * The <tt>&</tt> variant syntax allows access to the factory bean where
- * relevant.
+ * A bean resolver can be registered with the evaluation context and will kick in
+ * for bean references: {@code @myBeanName} and {@code &myBeanName} expressions.
+ * The <tt>&</tt> variant syntax allows access to the factory bean where relevant.
  *
  * @author Andy Clement
  * @since 3.0.3
@@ -28,12 +27,12 @@ package org.springframework.expression;
 public interface BeanResolver {
 
 	/**
-	 * Look up the named bean and return it. If attempting to access a factory
-	 * bean the name will have a <tt>&</tt> prefix.
+	 * Look up a bean by the given name and return a corresponding instance for it.
+	 * For attempting access to a factory bean, the name needs a <tt>&</tt> prefix.
 	 * @param context the current evaluation context
-	 * @param beanName the name of the bean to lookup
+	 * @param beanName the name of the bean to look up
 	 * @return an object representing the bean
-	 * @throws AccessException if there is an unexpected problem resolving the named bean
+	 * @throws AccessException if there is an unexpected problem resolving the bean
 	 */
 	Object resolve(EvaluationContext context, String beanName) throws AccessException;