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:

java.io.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

Modifier and Type	Field and Description
private java.lang.Throwable	failureCause Cause of failure, if any
private long	processingTimeMillis Request processing time
private java.lang.String	sessionId Session id that applied to the request, if any
private java.lang.String	userName Usually the UserPrincipal

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor and Description
RequestHandledEvent(java.lang.Object source, java.lang.String sessionId, java.lang.String userName, long processingTimeMillis) Create a new RequestHandledEvent with session information.
RequestHandledEvent(java.lang.Object source, java.lang.String sessionId, java.lang.String userName, long processingTimeMillis, java.lang.Throwable failureCause) Create a new RequestHandledEvent with session information.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getDescription() Return a full description of this event, involving all available context data.
java.lang.Throwable	getFailureCause() Return the cause of failure, if any.
long	getProcessingTimeMillis() Return the processing time of the request in milliseconds.
java.lang.String	getSessionId() Return the id of the HTTP session, if any.
java.lang.String	getShortDescription() Return a short description of this event, only involving the most important context data.
java.lang.String	getUserName() Return the name of the user that was associated with the request (usually the UserPrincipal).
java.lang.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

Field Detail

sessionId

private java.lang.String sessionId

Session id that applied to the request, if any

userName

private java.lang.String userName

Usually the UserPrincipal

processingTimeMillis

private final long processingTimeMillis

Request processing time

failureCause

private java.lang.Throwable failureCause

Cause of failure, if any

Constructor Detail

RequestHandledEvent

public RequestHandledEvent(java.lang.Object source,
                           java.lang.String sessionId,
                           java.lang.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(java.lang.Object source,
                           java.lang.String sessionId,
                           java.lang.String userName,
                           long processingTimeMillis,
                           java.lang.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 java.lang.String getSessionId()

Return the id of the HTTP session, if any.

getUserName

public java.lang.String getUserName()

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

See Also:

javax.servlet.http.HttpServletRequest#getUserPrincipal()

wasFailure

public boolean wasFailure()

Return whether the request failed.

getFailureCause

public java.lang.Throwable getFailureCause()

Return the cause of failure, if any.

getShortDescription

public java.lang.String getShortDescription()

Return a short description of this event, only involving the most important context data.

getDescription

public java.lang.String getDescription()

Return a full description of this event, involving all available context data.

toString

public java.lang.String toString()

Overrides:

toString in class java.util.EventObject