to.etc.dbpool

Class StatisticsRequestListener

java.lang.Object

to.etc.dbpool.StatisticsRequestListener

All Implemented Interfaces:

EventListener, javax.servlet.ServletRequestListener

public final class StatisticsRequestListener
extends Object
implements javax.servlet.ServletRequestListener

This listener can be used to collect statistics for the database pool when to.etc.dbpool's pool manager is used. This collects the URL's used as input and collates database usage statistics per page.

Author:

Frits Jalvingh Created on Feb 22, 2007

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	StatisticsRequestListener.UnclosedListener

Constructor Summary

Constructors

Constructor and Description
StatisticsRequestListener()

Method Summary

Modifier and Type	Method and Description
static SessionStatistics	createSessionStats(javax.servlet.http.HttpServletRequest r) Create a HttpSession, and add a Session Statistics block there.
static void	destroySessionStats(javax.servlet.http.HttpServletRequest r) Destroy any known session stats structure.
static GlobalPerformanceStore	getGlobalStore() Returns the current global performance store maintained by this listener.
static String	getRequestID() Return the unique ID for this request/response cycle which can be used to identify the metrics for this request after it finished.
static SessionStatistics	getSessionStatistics(javax.servlet.http.HttpServletRequest r)
static StatisticsCollectorBase	getThreadStatistics() Get the current counts for SQL statements for the current thread, if enabled/available.
void	requestDestroyed(javax.servlet.ServletRequestEvent ev) At request finish, we collect all of the statistics we gathered and add them to the accounting outputs (the stores).
void	requestInitialized(javax.servlet.ServletRequestEvent ev)
static void	setForceEncoding(String forceEncoding) Advanced horror mode: Internet Exploder, who else, does not send the charset it encoded the parameters with in it's content type for input received.
static void	setSessionStatistics(boolean on)
static void	setUnclosedListener(StatisticsRequestListener.UnclosedListener ucl)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StatisticsRequestListener

public StatisticsRequestListener()

Method Detail

requestDestroyed

public void requestDestroyed(javax.servlet.ServletRequestEvent ev)

At request finish, we collect all of the statistics we gathered and add them to the accounting outputs (the stores). We also check whether all connections are properly closed.

Specified by:

requestDestroyed in interface javax.servlet.ServletRequestListener

Parameters:

ev -

requestInitialized

public void requestInitialized(javax.servlet.ServletRequestEvent ev)

Specified by:

requestInitialized in interface javax.servlet.ServletRequestListener

See Also:

ServletRequestListener.requestInitialized(javax.servlet.ServletRequestEvent)

setSessionStatistics

public static void setSessionStatistics(boolean on)

getThreadStatistics

@Nullable
public static final StatisticsCollectorBase getThreadStatistics()

Get the current counts for SQL statements for the current thread, if enabled/available. These are the statistics so far of course.

Returns:

getRequestID

@Nullable
public static final String getRequestID()

Return the unique ID for this request/response cycle which can be used to identify the metrics for this request after it finished.

Returns:

destroySessionStats

public static void destroySessionStats(javax.servlet.http.HttpServletRequest r)

Destroy any known session stats structure.

Parameters:

r -

createSessionStats

@Nonnull
public static SessionStatistics createSessionStats(javax.servlet.http.HttpServletRequest r)

Create a HttpSession, and add a Session Statistics block there. This will start session statistics collection. If the block already exists nothing happens.

Parameters:

r -

getSessionStatistics

@Nullable
public static SessionStatistics getSessionStatistics(javax.servlet.http.HttpServletRequest r)

getGlobalStore

public static GlobalPerformanceStore getGlobalStore()

Returns the current global performance store maintained by this listener. Returns null if not collecting statistics.

Returns:

setForceEncoding

public static void setForceEncoding(String forceEncoding)

Advanced horror mode: Internet Exploder, who else, does not send the charset it encoded the parameters with in it's content type for input received. Because of this, when content is sent to the server from IE that is encoded in UTF-8, the server does not know that and will decode the parameters as the default encoding (iso-8859-1 probably). This will cause parameter values to be wrong. And because these are decoded only once by Tomcat and then stored- using the getParameter() call here will cause encoding problems. Parameters are decoded as iso-8859-1 and a later call to use UTF-8 encoding is silently ignored, because otherwise the problem would be clear. The workaround here is to force input decoding to a specified encoding (usually UTF-8) always when the charset header is missing.

Parameters:

forceEncoding -

setUnclosedListener

public static void setUnclosedListener(StatisticsRequestListener.UnclosedListener ucl)