## org.springframework.web.context.support
Class RequestHandledEvent

    java.lang.Object
      java.util.EventObject
          org.springframework.context.ApplicationEvent
              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`, `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`