Spring/spring-framework
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Polish Javadoc in @EventListener

Browse Source
This commit is contained in:
Sam Brannen
2015-07-08 18:33:35 +02:00
parent fd2c0cc982
commit 72f0ac7e5b
1 changed files with 15 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
spring-context/src/main/java/org/springframework/context/event/EventListener.java
View File

@@ -28,15 +28,19 @@ import org.springframework.core.annotation.AliasFor;
/** /**
* Annotation that marks a method as a listener for application events. * Annotation that marks a method as a listener for application events.
* *
* <p>The method must declare one (and only one) parameter that reflects the * <p>If an annotated method supports a single event type, the method may
* event type to listen to. Alternatively, this annotation may refer to the * declare a single parameter that reflects the event type to listen to. If
* event type(s) using the {@link #classes} attribute. Events can be * an annotated method supports multiple event types, this annotation may
* {@link ApplicationEvent} instances as well as arbitrary objects. * refer to one or more supported event types using the {@code classes}
* attribute. See {@link #classes} for further details.
*
* <p>Events can be {@link ApplicationEvent} instances as well as arbitrary
* objects.
* *
* <p>Processing of {@code @EventListener} annotations is performed via the * <p>Processing of {@code @EventListener} annotations is performed via the
* {@link EventListenerMethodProcessor} that is registered automatically * {@link EventListenerMethodProcessor} which is registered automatically
* when using Java config or via the {@code <context:annotation-driven/>} * when using Java config or manually via the {@code <context:annotation-driven/>}
* XML element. * element when using XML config.
* *
* <p>Annotated methods may have a non-{@code void} return type. When they * <p>Annotated methods may have a non-{@code void} return type. When they
* do, the result of the method invocation is sent as a new event. If the * do, the result of the method invocation is sent as a new event. If the
@@ -69,9 +73,10 @@ public @interface EventListener {
/** /**
* The event classes that this listener handles. * The event classes that this listener handles.
* <p>When this attribute is specified with one value, the method parameter * <p>If this attribute is specified with a single value, the annotated
* may or may not be specified. When this attribute is specified with more * method may optionally accept a single parameter. However, if this
* than one value, the method must not have a parameter. * attribute is specified with multiple values, the annotated method
* must <em>not</em> declare any parameters.
*/ */
@AliasFor(attribute = "value") @AliasFor(attribute = "value")
Class<?>[] classes() default {}; Class<?>[] classes() default {};