From d2b909e7c5a6e5d696c31101fb07a076bd100eb1 Mon Sep 17 00:00:00 2001
From: Rob Winch <rwinch@gopivotal.com>
Date: Fri, 17 Jun 2016 17:16:54 -0500
Subject: [PATCH] Doc InteractiveAuthenticationEvent doesn't extend
 AuthentcationEvent

Document why InteractiveAuthenticationEvent doesn't extend
AuthentcationEvent. This is to avoid multiple AuthenticationSuccessEvent
from being sent to any listeners.

Fixes gh-3857
---
 .../event/InteractiveAuthenticationSuccessEvent.java          | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/core/src/main/java/org/springframework/security/authentication/event/InteractiveAuthenticationSuccessEvent.java b/core/src/main/java/org/springframework/security/authentication/event/InteractiveAuthenticationSuccessEvent.java
index dbf26b9de7..b66e06bf93 100644
--- a/core/src/main/java/org/springframework/security/authentication/event/InteractiveAuthenticationSuccessEvent.java
+++ b/core/src/main/java/org/springframework/security/authentication/event/InteractiveAuthenticationSuccessEvent.java
@@ -26,6 +26,10 @@ import org.springframework.util.Assert;
  * The <code>ApplicationEvent</code>'s <code>source</code> will be the
  * <code>Authentication</code> object.
  * </p>
+ * <p>
+ * This does not extend from <code>AuthenticationSuccessEvent</code> to avoid duplicate
+ * <code>AuthenticationSuccessEvent</code>s being sent to any listeners.
+ * </p>
  *
  * @author Ben Alex
  */