com.sun.identity.log
Class Logger

com.sun.identity.log.Logger

public class Logger

Sun ONE Identity Server extension to the jdk1.4 Logger This extension gives some functionality required by Sun ONE Identity Server secure logger. For JDK1.4 Logger please refer to http://java.sun.com/j2se/1.4.1/docs/api/java/util/logging/Logger.html

Since:
Sun ONE Identity Server 6.0

Field Summary
static com.sun.identity.log.util.ReaderWriterLock rwLock
           
 
Method Summary
 void flush()
          Writes all the buffered log records.
 java.lang.String getCurrentFile()
          This method will return the current file to which the logger's handler is writing to...
static java.util.logging.Logger getLogger(java.lang.String name)
          Find or create a logger for a named subsystem.
static java.util.logging.Logger getLogger(java.lang.String name, java.lang.String rbName)
          Find or create a logger for a named subsystem.
 void log(java.util.logging.LogRecord record)
          Directs evey log call to log(record, credential) And thus the default authorization check does not allow logging when an application uses this interface.
 void log(java.util.logging.LogRecord record, java.lang.Object cred)
          Calls super.log after checking authorization.
 void setCurrentFile(java.lang.String fileName)
           
 

Field Detail

rwLock

public static com.sun.identity.log.util.ReaderWriterLock rwLock
Method Detail

log

public void log(java.util.logging.LogRecord record)
Directs evey log call to log(record, credential) And thus the default authorization check does not allow logging when an application uses this interface.
Parameters:
record - The LogRecord to be logged

log

public void log(java.util.logging.LogRecord record,
                java.lang.Object cred)
Calls super.log after checking authorization. Data is not logged at all if this check fails.
Parameters:
record - The LogRecord to be logged
cred - To prove authorization for log WRITE. The default authorization hook checks validitity of the ssoToken which should be passed as the cred.

flush

public void flush()
Writes all the buffered log records.

getLogger

public static java.util.logging.Logger getLogger(java.lang.String name)
Find or create a logger for a named subsystem. If a logger has already been created with the given name it is returned. Otherwise a new logger is created.

If a new logger is created its log level will be configured based on the LogManager and it will be configured NOT to send logging output to its parent loggers Handlers. It will be registered in the LogManager global namespace.

Parameters:
name - A name for the logger. This should be a dot-separated name and should be the file name you want to have for your logs, such as amSSO.access or audit
Returns:
a suitable Logger

getLogger

public static java.util.logging.Logger getLogger(java.lang.String name,
                                                 java.lang.String rbName)
Find or create a logger for a named subsystem. If a logger has already been created with the given name it is returned. Otherwise a new logger is created.

If a new logger is created its log level will be configured based on the LogManager and it will configured to also send logging output to its parent loggers Handlers. It will be registered in the LogManager global namespace.

If the named Logger already exists and does not yet have a localization resource bundle then the given resource bundle name is used. If the named Logger already exists and has a different resource bundle name then an IllegalArgumentException is thrown.

Parameters:
name - A name for the logger. This should be a dot-separated name and should be the file name you want to have for your logs, such as amSSO.access or audit
rbName - A resource bundle to be used for localizing the log messages.
Returns:
logger for a named subsystem.

getCurrentFile

public java.lang.String getCurrentFile()
This method will return the current file to which the logger's handler is writing to... useful only in case of file..

setCurrentFile

public void setCurrentFile(java.lang.String fileName)