diff --git a/spring-beans/src/main/java/org/springframework/beans/factory/FactoryBean.java b/spring-beans/src/main/java/org/springframework/beans/factory/FactoryBean.java index 97362ce1f7c..c8d06fe3b01 100644 --- a/spring-beans/src/main/java/org/springframework/beans/factory/FactoryBean.java +++ b/spring-beans/src/main/java/org/springframework/beans/factory/FactoryBean.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2020 the original author or authors. + * Copyright 2002-2024 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. @@ -39,9 +39,9 @@ import org.springframework.lang.Nullable; * *
{@code FactoryBean} is a programmatic contract. Implementations are not * supposed to rely on annotation-driven injection or other reflective facilities. - * {@link #getObjectType()} {@link #getObject()} invocations may arrive early in the - * bootstrap process, even ahead of any post-processor setup. If you need access to - * other beans, implement {@link BeanFactoryAware} and obtain them programmatically. + * Invocations of {@link #getObjectType()} and {@link #getObject()} may arrive early + * in the bootstrap process, even ahead of any post-processor setup. If you need access + * to other beans, implement {@link BeanFactoryAware} and obtain them programmatically. * *
The container is only responsible for managing the lifecycle of the FactoryBean * instance, not the lifecycle of the objects created by the FactoryBean. Therefore, @@ -50,7 +50,7 @@ import org.springframework.lang.Nullable; * {@link DisposableBean} and delegate any such close call to the underlying object. * *
Finally, FactoryBean objects participate in the containing BeanFactory's
- * synchronization of bean creation. There is usually no need for internal
+ * synchronization of bean creation. Thus, there is usually no need for internal
* synchronization other than for purposes of lazy initialization within the
* FactoryBean itself (or the like).
*
@@ -68,7 +68,7 @@ public interface FactoryBean As with a {@link BeanFactory}, this allows support for both the
- * Singleton and Prototype design pattern.
+ * Singleton and Prototype design patterns.
* If this FactoryBean is not fully initialized yet at the time of
* the call (for example because it is involved in a circular reference),
* throw a corresponding {@link FactoryBeanNotInitializedException}.
- * As of Spring 2.0, FactoryBeans are allowed to return {@code null}
- * objects. The factory will consider this as normal value to be used; it
- * will not throw a FactoryBeanNotInitializedException in this case anymore.
+ * FactoryBeans are allowed to return {@code null} objects. The bean
+ * factory will consider this as a normal value to be used and will not throw
+ * a {@code FactoryBeanNotInitializedException} in this case. However,
* FactoryBean implementations are encouraged to throw
- * FactoryBeanNotInitializedException themselves now, as appropriate.
+ * {@code FactoryBeanNotInitializedException} themselves, as appropriate.
* @return an instance of the bean (can be {@code null})
* @throws Exception in case of creation errors
* @see FactoryBeanNotInitializedException
@@ -100,7 +100,7 @@ public interface FactoryBean This allows one to check for specific types of beans without
* instantiating objects, for example on autowiring.
- * In the case of implementations that are creating a singleton object,
+ * In the case of implementations that create a singleton object,
* this method should try to avoid singleton creation as far as possible;
* it should rather estimate the type in advance.
* For prototypes, returning a meaningful type here is advisable too.
@@ -121,8 +121,8 @@ public interface FactoryBean NOTE: If a FactoryBean indicates to hold a singleton object,
- * the object returned from {@code getObject()} might get cached
+ * NOTE: If a FactoryBean indicates that it holds a singleton
+ * object, the object returned from {@code getObject()} might get cached
* by the owning BeanFactory. Hence, do not return {@code true}
* unless the FactoryBean always exposes the same reference.
* The singleton status of the FactoryBean itself will generally