Package com.sun.identity.log

Class Logger

java.lang.Object

java.util.logging.Logger

com.sun.identity.log.Logger

@SupportedAll
@Deprecated
public class Logger
extends Logger

Deprecated.

OpenAM extension to the jdk1.4 Logger This extension gives some functionality required by OpenAM secure logger. For JDK1.4 Logger please refer to

 http://java.sun.com/j2se/1.4.1/docs/api/java/util/logging/Logger.html
 

Field Summary

Fields

Modifier and Type	Field	Description
static com.sun.identity.common.ReaderWriterLock	rwLock	Deprecated. Lock to prevent parallel writing and reading at the same time.
static ThreadLocal	token	Deprecated.

Fields inherited from class java.util.logging.Logger

global, GLOBAL_LOGGER_NAME

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Logger(String name, String resourceBundleName, com.sun.identity.monitoring.MonitoringServices monitoringServices, com.sun.identity.monitoring.MonitoringStatusService monitoringStatusService)	Deprecated. Protected method to construct a logger for a named subsystem.

Method Summary

Modifier and Type	Method	Description
void	flush()	Deprecated. Writes all the buffered log records.
String	getCurrentFile()	Deprecated. Returns the current file to which the logger's handler is writing.
static Logger	getLogger(String name)	Deprecated. Find or create a logger for a named subsystem.
static Logger	getLogger(String name, String rbName)	Deprecated. Find or create a logger for a named subsystem.
void	log(com.sun.identity.log.ILogRecord record)	Deprecated. Log entitlement log record.
void	log(LogRecord record)	Deprecated. Directs every log call to log(LogRecord, Object) And thus the default authorization check does not allow logging when an application uses this interface.
void	log(LogRecord record, Object cred)	Deprecated. Calls super.log after checking authorization.
void	setCurrentFile(String fileName)	Deprecated. Set the current file to which the logger's handler is writing.

Methods inherited from class java.util.logging.Logger

addHandler, config, config, entering, entering, entering, exiting, exiting, fine, fine, finer, finer, finest, finest, getAnonymousLogger, getAnonymousLogger, getFilter, getGlobal, getHandlers, getLevel, getName, getParent, getResourceBundle, getResourceBundleName, getUseParentHandlers, info, info, isLoggable, log, log, log, log, log, log, logp, logp, logp, logp, logp, logp, logrb, logrb, logrb, logrb, logrb, logrb, logrb, logrb, removeHandler, setFilter, setLevel, setParent, setResourceBundle, setUseParentHandlers, severe, severe, throwing, warning, warning

Methods inherited from class java.lang.Object

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

Field Details

token

public static ThreadLocal token

Deprecated.

rwLock

public static com.sun.identity.common.ReaderWriterLock rwLock

Deprecated.

Lock to prevent parallel writing and reading at the same time.

Constructor Details

Logger

protected Logger(String name,
 String resourceBundleName,
 com.sun.identity.monitoring.MonitoringServices monitoringServices,
 com.sun.identity.monitoring.MonitoringStatusService monitoringStatusService)

Deprecated.

Protected method to construct a logger for a named subsystem.

The logger will be initially configured with a null Level and with useParentHandlers true.

Parameters:

name - A name for the logger. This should be a dot-separated name and should normally be based on the package name or class name of the subsystem, such as java.net or javax.swing. It may be null for anonymous Loggers.

resourceBundleName - Name of the ResourceBundle to be used for localizing messages for this logger. May be null if none of the messages require localization.

monitoringServices - The monitoring services.

monitoringStatusService - The monitoring status service.

Throws:

MissingResourceException - if the ResourceBundleName is non-null and no corresponding resource can be found.

Method Details

log

public void log(LogRecord record)

Deprecated.

Directs every log call to log(LogRecord, Object) And thus the default authorization check does not allow logging when an application uses this interface.

Overrides:

log in class Logger

Parameters:

record - The LogRecord to be logged.

log

public void log(com.sun.identity.log.ILogRecord record)

Deprecated.

Log entitlement log record.

Parameters:

record - Log record.

log

public void log(LogRecord record,
 Object cred)

Deprecated.

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 validity of the single sign on token which should be passed as the cred.

flush

public void flush()

Deprecated.

Writes all the buffered log records.

getLogger

public static Logger getLogger(String name)

Deprecated.

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 Logger getLogger(String name,
 String rbName)

Deprecated.

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 logger's 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 String getCurrentFile()

Deprecated.

Returns the current file to which the logger's handler is writing. This is useful only in case of file..

Returns:

the current file to which the logger's handler is writing.

setCurrentFile

public void setCurrentFile(String fileName)

Deprecated.

Set the current file to which the logger's handler is writing.

Parameters:

fileName - name of file.