The Spring Framework

org.springframework.web.context.support
Class RequestHandledEvent

java.lang.Object
  extended by java.util.EventObject
      extended by org.springframework.context.ApplicationEvent
          extended by org.springframework.web.context.support.RequestHandledEvent
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
PortletRequestHandledEvent, ServletRequestHandledEvent

public class RequestHandledEvent
extends ApplicationEvent

Event raised when a request is handled within an ApplicationContext.

Supported by Spring's own FrameworkServlet (through a specific ServletRequestHandledEvent subclass), but can also be raised by any other web component. Used, for example, by Spring's out-of-the-box PerformanceMonitorListener.

Since:
January 17, 2001
Author:
Rod Johnson, Juergen Hoeller
See Also:
ServletRequestHandledEvent, PerformanceMonitorListener, FrameworkServlet, ApplicationEventPublisher.publishEvent(org.springframework.context.ApplicationEvent), Serialized Form

Field Summary
 
Fields inherited from class java.util.EventObject
source
 
Constructor Summary
RequestHandledEvent(Object source, String sessionId, String userName, long processingTimeMillis)
          Create a new RequestHandledEvent with session information.
RequestHandledEvent(Object source, String sessionId, String userName, long processingTimeMillis, Throwable failureCause)
          Create a new RequestHandledEvent with session information.
 
Method Summary
 String getDescription()
          Return a full description of this event, involving all available context data.
 Throwable getFailureCause()
          Return the cause of failure, if any.
 long getProcessingTimeMillis()
          Return the processing time of the request in milliseconds.
 String getSessionId()
          Return the id of the HTTP session, if any.
 String getShortDescription()
          Return a short description of this event, only involving the most important context data.
 String getUserName()
          Return the name of the user that was associated with the request (usually the UserPrincipal).
 String toString()
           
 boolean wasFailure()
          Return whether the request failed.
 
Methods inherited from class org.springframework.context.ApplicationEvent
getTimestamp
 
Methods inherited from class java.util.EventObject
getSource
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

RequestHandledEvent

public RequestHandledEvent(Object source,
                           String sessionId,
                           String userName,
                           long processingTimeMillis)
Create a new RequestHandledEvent with session information.

Parameters:
source - the component that published the event
sessionId - the id of the HTTP session, if any
userName - the name of the user that was associated with the request, if any (usually the UserPrincipal)
processingTimeMillis - the processing time of the request in milliseconds

RequestHandledEvent

public RequestHandledEvent(Object source,
                           String sessionId,
                           String userName,
                           long processingTimeMillis,
                           Throwable failureCause)
Create a new RequestHandledEvent with session information.

Parameters:
source - the component that published the event
sessionId - the id of the HTTP session, if any
userName - the name of the user that was associated with the request, if any (usually the UserPrincipal)
processingTimeMillis - the processing time of the request in milliseconds
failureCause - the cause of failure, if any
Method Detail

getProcessingTimeMillis

public long getProcessingTimeMillis()
Return the processing time of the request in milliseconds.


getSessionId

public String getSessionId()
Return the id of the HTTP session, if any.


getUserName

public String getUserName()
Return the name of the user that was associated with the request (usually the UserPrincipal).

See Also:
HttpServletRequest.getUserPrincipal()

wasFailure

public boolean wasFailure()
Return whether the request failed.


getFailureCause

public Throwable getFailureCause()
Return the cause of failure, if any.


getShortDescription

public String getShortDescription()
Return a short description of this event, only involving the most important context data.


getDescription

public String getDescription()
Return a full description of this event, involving all available context data.


toString

public String toString()
Overrides:
toString in class EventObject

The Spring Framework

Copyright © 2002-2008 The Spring Framework.