Package com.sun.identity.log

Class Logger

java.lang.Object
java.util.logging.Logger
com.sun.identity.log.Logger
@SupportedAll @Deprecated(since="8.0.0", forRemoval=true) public class Logger extends Logger
Deprecated, for removal: This API element is subject to removal in a future version.
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 Details

    • token

      public static ThreadLocal token
      Deprecated, for removal: This API element is subject to removal in a future version.

    • rwLock

      public static com.sun.identity.common.ReaderWriterLock rwLock
      Deprecated, for removal: This API element is subject to removal in a future version.
      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, for removal: This API element is subject to removal in a future version.
      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, for removal: This API element is subject to removal in a future version.
      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, for removal: This API element is subject to removal in a future version.
      Log entitlement log record.
      Parameters:
      record - Log record.

    • log

      public void log(LogRecord record, Object cred)
      Deprecated, for removal: This API element is subject to removal in a future version.
      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, for removal: This API element is subject to removal in a future version.
      Writes all the buffered log records.

    • getLogger

      public static Logger getLogger(String name)
      Deprecated, for removal: This API element is subject to removal in a future version.
      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, for removal: This API element is subject to removal in a future version.
      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, for removal: This API element is subject to removal in a future version.
      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, for removal: This API element is subject to removal in a future version.
      Set the current file to which the logger's handler is writing.
      Parameters:
      fileName - name of file.