<p dir="auto"><strong><a href="https://jira.spring.io/secure/ViewProfile.jspa?name=cblin" rel="nofollow">christophe blin</a></strong> opened <strong><a href="https://jira.spring.io/browse/SPR-7395?redirect=false" rel="nofollow">SPR-7395</a></strong> and commented</p>
<p dir="auto">In the §3.13.2 <a href="http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/htmlsingle/spring-framework-reference.html#context-functionality-events" rel="nofollow">http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/htmlsingle/spring-framework-reference.html#context-functionality-events</a></p>
<p dir="auto">The BlackListNotifier class which implements the interface ApplicationListener is registered as a subscriber to the application context and will receive the BlackListEvent. In order to access properties specific to BlackListEvent, the listener must perform a downcast.</p>
<p dir="auto">This is not true because of the java generic.<br>
You simply have to write BlackListNotifier implements ApplicationListener&lt;BlackListEvent&gt;</p>
<hr>
<p dir="auto"><strong>Affects:</strong> 3.0 GA</p>
<p dir="auto"><strong>Issue Links:</strong></p>
<ul dir="auto">
<li><a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="398106539" data-permission-text="Title is private" data-url="https://github.com/spring-projects/spring-framework/issues/12080" data-hovercard-type="issue" data-hovercard-url="/spring-projects/spring-framework/issues/12080/hovercard" href="https://github.com/spring-projects/spring-framework/issues/12080">#12080</a> Document use of ApplicationEventPublisher (<em><strong>"duplicates"</strong></em>)</li>
</ul>
<p dir="auto"><strong>Referenced from:</strong> commits <a class="commit-link" data-hovercard-type="commit" data-hovercard-url="https://github.com/spring-projects/spring-framework/commit/9008cf907ae2d537cc65640a79f0834823f113fb/hovercard" href="https://github.com/spring-projects/spring-framework/commit/9008cf907ae2d537cc65640a79f0834823f113fb"><tt>9008cf9</tt></a></p>
<p dir="auto"><strong><a href="https://jira.spring.io/secure/ViewProfile.jspa?name=jtravis" rel="nofollow">Jon Travis</a></strong> opened <strong><a href="https://jira.spring.io/browse/SPR-7422?redirect=false" rel="nofollow">SPR-7422</a></strong> and commented</p>
<p dir="auto">Section 3.13.2 (Standard and Custom Events) of the reference manual is out of date wrt best practices.</p>
<ul dir="auto">
<li>It does not talk about using ApplicationListener&lt;T&gt; with a type argument, thus removing instanceof checks in the event callback</li>
<li>It does not espouse the use of ApplicationEventPublisher and ApplicationEventPublisherAware</li>
</ul>
<p dir="auto">In both cases, the javadoc for the corresponding bits is correct and up-to-date, it simply needs to be referenced in the manual.</p>
<hr>
<p dir="auto"><strong>Affects:</strong> 3.0 GA</p>
<p dir="auto"><strong>Issue Links:</strong></p>
<ul dir="auto">
<li><a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="398106380" data-permission-text="Title is private" data-url="https://github.com/spring-projects/spring-framework/issues/12053" data-hovercard-type="issue" data-hovercard-url="/spring-projects/spring-framework/issues/12053/hovercard" href="https://github.com/spring-projects/spring-framework/issues/12053">#12053</a> Document generic use of ApplicationListener interface (<em><strong>"is duplicated by"</strong></em>)</li>
</ul>
<p dir="auto"><strong>Referenced from:</strong> commits <a class="commit-link" data-hovercard-type="commit" data-hovercard-url="https://github.com/spring-projects/spring-framework/commit/9008cf907ae2d537cc65640a79f0834823f113fb/hovercard" href="https://github.com/spring-projects/spring-framework/commit/9008cf907ae2d537cc65640a79f0834823f113fb"><tt>9008cf9</tt></a></p>