org.openqa.selenium.remote.server.log

Class DefaultPerSessionLogHandler

java.lang.Object

java.util.logging.Handler

org.openqa.selenium.remote.server.log.PerSessionLogHandler

org.openqa.selenium.remote.server.log.DefaultPerSessionLogHandler

public class DefaultPerSessionLogHandler
extends PerSessionLogHandler

RestishHandler which keeps in memory the log records per session so that users can retrieve logs per session.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	DefaultPerSessionLogHandler.ThreadKey

Field Summary

Fields

Modifier and Type	Field and Description
private int	capacity
private java.util.logging.Formatter	formatter
private SessionLogsToFileRepository	logFileRepository
private java.util.Map<org.openqa.selenium.remote.SessionId,java.util.Map<java.lang.String,org.openqa.selenium.logging.LogEntries>>	perSessionDriverEntries
private java.util.Map<org.openqa.selenium.remote.SessionId,java.util.List<java.util.logging.LogRecord>>	perSessionRecords
private java.util.Map<DefaultPerSessionLogHandler.ThreadKey,java.util.List<java.util.logging.LogRecord>>	perThreadTempRecords
private java.util.logging.Level	serverLogLevel
private java.util.Map<org.openqa.selenium.remote.SessionId,DefaultPerSessionLogHandler.ThreadKey>	sessionToThreadMap
private boolean	storeLogsOnSessionQuit
private java.util.Map<DefaultPerSessionLogHandler.ThreadKey,org.openqa.selenium.remote.SessionId>	threadToSessionMap

Constructor Summary

Constructors

Constructor and Description
DefaultPerSessionLogHandler(int capacity, java.util.logging.Level minimumLevel, java.util.logging.Formatter formatter, boolean captureLogsOnQuit) New handler keeping track of log records per session.

Method Summary

Modifier and Type	Method and Description
void	attachToCurrentThread(org.openqa.selenium.remote.SessionId sessionId)
void	clearThreadTempLogs() Clears the logging events attached to the thread.
void	close()
void	configureLogging(org.openqa.selenium.logging.LoggingPreferences prefs) Configures logging using a logging preferences object.
void	detachFromCurrentThread()
void	fetchAndStoreLogsFromDriver(org.openqa.selenium.remote.SessionId sessionId, org.openqa.selenium.WebDriver driver) Fetches and stores available logs from the given session and driver.
void	flush()
private java.lang.String	formattedRecords(org.openqa.selenium.remote.SessionId sessionId)
org.openqa.selenium.logging.SessionLogs	getAllLogsForSession(org.openqa.selenium.remote.SessionId sessionId) Gets all logs for a session.
java.lang.String	getLog(org.openqa.selenium.remote.SessionId sessionId) This returns Selenium Remote Control logs associated with the sessionId.
java.util.List<org.openqa.selenium.remote.SessionId>	getLoggedSessions() Returns a list of session IDs for which there are logs.
org.openqa.selenium.logging.LogEntries	getSessionLog(org.openqa.selenium.remote.SessionId sessionId) Returns the server log for the given session id.
void	publish(java.util.logging.LogRecord record)
private java.util.logging.LogRecord[]	records(org.openqa.selenium.remote.SessionId sessionId)
void	removeSessionLogs(org.openqa.selenium.remote.SessionId sessionId) Removes session logs for the given session id.
void	transferThreadTempLogsToSessionLogs(org.openqa.selenium.remote.SessionId sessionId)

Methods inherited from class java.util.logging.Handler

getEncoding, getErrorManager, getFilter, getFormatter, getLevel, isLoggable, reportError, setEncoding, setErrorManager, setFilter, setFormatter, setLevel

Methods inherited from class java.lang.Object

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

Field Detail

perSessionRecords

private final java.util.Map<org.openqa.selenium.remote.SessionId,java.util.List<java.util.logging.LogRecord>> perSessionRecords

perSessionDriverEntries

private final java.util.Map<org.openqa.selenium.remote.SessionId,java.util.Map<java.lang.String,org.openqa.selenium.logging.LogEntries>> perSessionDriverEntries

perThreadTempRecords

private final java.util.Map<DefaultPerSessionLogHandler.ThreadKey,java.util.List<java.util.logging.LogRecord>> perThreadTempRecords

formatter

private final java.util.logging.Formatter formatter

threadToSessionMap

private java.util.Map<DefaultPerSessionLogHandler.ThreadKey,org.openqa.selenium.remote.SessionId> threadToSessionMap

sessionToThreadMap

private java.util.Map<org.openqa.selenium.remote.SessionId,DefaultPerSessionLogHandler.ThreadKey> sessionToThreadMap

logFileRepository

private SessionLogsToFileRepository logFileRepository

capacity

private int capacity

storeLogsOnSessionQuit

private boolean storeLogsOnSessionQuit

serverLogLevel

private java.util.logging.Level serverLogLevel

Constructor Detail

DefaultPerSessionLogHandler

public DefaultPerSessionLogHandler(int capacity,
                                   java.util.logging.Level minimumLevel,
                                   java.util.logging.Formatter formatter,
                                   boolean captureLogsOnQuit)

New handler keeping track of log records per session.

Parameters:

capacity - The capacity

minimumLevel - Only keep track of records whose level is equal or greater than minimumLevel.

formatter - Formatter to use when retrieving log messages.

captureLogsOnQuit - Whether to enable log capture on quit.

Method Detail

publish

public void publish(java.util.logging.LogRecord record)

Specified by:

publish in class PerSessionLogHandler

flush

public void flush()

Specified by:

flush in class java.util.logging.Handler

close

public void close()
           throws java.lang.SecurityException

Specified by:

close in class java.util.logging.Handler

Throws:

java.lang.SecurityException

records

private java.util.logging.LogRecord[] records(org.openqa.selenium.remote.SessionId sessionId)
                                       throws java.io.IOException

Throws:

java.io.IOException

formattedRecords

private java.lang.String formattedRecords(org.openqa.selenium.remote.SessionId sessionId)
                                   throws java.io.IOException

Throws:

java.io.IOException

attachToCurrentThread

public void attachToCurrentThread(org.openqa.selenium.remote.SessionId sessionId)

Specified by:

attachToCurrentThread in class PerSessionLogHandler

transferThreadTempLogsToSessionLogs

public void transferThreadTempLogsToSessionLogs(org.openqa.selenium.remote.SessionId sessionId)

Specified by:

transferThreadTempLogsToSessionLogs in class PerSessionLogHandler

detachFromCurrentThread

public void detachFromCurrentThread()

Specified by:

detachFromCurrentThread in class PerSessionLogHandler

removeSessionLogs

public void removeSessionLogs(org.openqa.selenium.remote.SessionId sessionId)

Removes session logs for the given session id. NB! If the handler has been configured to capture logs on quit no logs will be removed.

Specified by:

removeSessionLogs in class PerSessionLogHandler

Parameters:

sessionId - The session id to use.

clearThreadTempLogs

public void clearThreadTempLogs()

Clears the logging events attached to the thread. The logging is globally added to the jvm and is effectively used by both classic selenium and WebDriver. WebDriver must call this to avoid leaking memory, even though it is not really used. Ideally we should probably attach the *request* somewhere we could pick it up, so we could attach the pre-session logging to the request instead of the logging. Unfortunately this is no small task.

Specified by:

clearThreadTempLogs in class PerSessionLogHandler

getLog

public java.lang.String getLog(org.openqa.selenium.remote.SessionId sessionId)
                        throws java.io.IOException

This returns Selenium Remote Control logs associated with the sessionId.

Specified by:

getLog in class PerSessionLogHandler

Parameters:

sessionId - session-id for which the RC logs will be returned.

Returns:

String RC logs for the sessionId

Throws:

java.io.IOException - when the elves go bad

getSessionLog

public org.openqa.selenium.logging.LogEntries getSessionLog(org.openqa.selenium.remote.SessionId sessionId)
                                                     throws java.io.IOException

Returns the server log for the given session id.

Specified by:

getSessionLog in class PerSessionLogHandler

Parameters:

sessionId - The session id.

Returns:

The available server log entries for the session.

Throws:

java.io.IOException - If there was a problem reading from file.

getLoggedSessions

public java.util.List<org.openqa.selenium.remote.SessionId> getLoggedSessions()

Returns a list of session IDs for which there are logs. The type of logs that are available depends on the log types provided by the driver. An included session id will at least have server logs.

Specified by:

getLoggedSessions in class PerSessionLogHandler

Returns:

The list of session IDs.

getAllLogsForSession

public org.openqa.selenium.logging.SessionLogs getAllLogsForSession(org.openqa.selenium.remote.SessionId sessionId)

Gets all logs for a session.

Specified by:

getAllLogsForSession in class PerSessionLogHandler

Parameters:

sessionId - The id of the session.

Returns:

The logs for the session, ordered after log types in a session logs object.

fetchAndStoreLogsFromDriver

public void fetchAndStoreLogsFromDriver(org.openqa.selenium.remote.SessionId sessionId,
                                        org.openqa.selenium.WebDriver driver)
                                 throws java.io.IOException

Fetches and stores available logs from the given session and driver.

Specified by:

fetchAndStoreLogsFromDriver in class PerSessionLogHandler

Parameters:

sessionId - The id of the session.

driver - The driver to get the logs from.

Throws:

java.io.IOException - If there was a problem reading from file.

configureLogging

public void configureLogging(org.openqa.selenium.logging.LoggingPreferences prefs)

Configures logging using a logging preferences object.

Specified by:

configureLogging in class PerSessionLogHandler

Parameters:

prefs - The logging preferences object.