Internal Service Provider Interface (SPI) that makes it possible to use java.util.logging as backend when the sun.util.logging.internal.LoggingProviderImpl is present.

The JDK default implementation of the LoggerFinder will attempt to locate and load an installed implementation of the DefaultLoggerFinder. If java.util.logging is present, this will usually resolve to an instance of sun.util.logging.internal.LoggingProviderImpl. Otherwise, if no concrete service provider is declared for DefaultLoggerFinder, the default implementation provided by this class will be used.

When the sun.util.logging.internal.LoggingProviderImpl is not present then the default implementation provided by this class is to use a simple logger that will log messages whose level is INFO and above to the console. These simple loggers are not configurable.

When configuration is needed, an application should either link with java.util.logging - and use the java.util.logging for configuration, or link with another implementation of the LoggerFinder that provides the necessary configuration.

Modifier and Type	Class and Description
pack-priv static class	DefaultLoggerFinder.SharedLoggers

Modifier and Type	Field and Description
pack-priv static final RuntimePermission	LOGGERFINDER_PERMISSION Hides java.lang.System.LoggerFinder.LOGGERFINDER_PERMISSION.

Constructor Summary

Access	Constructor and Description
protected	DefaultLoggerFinder() Creates a new instance of DefaultLoggerFinder.
private	DefaultLoggerFinder(Void unused)

Method Summary

Modifier and Type	Method and Description
private static Void	checkPermission() Hides java.lang.System.LoggerFinder.checkPermission.
protected System.Logger	Returns: A `logger` suitable for the application usage. demandLoggerFor(String The name of the logger. name, Module The module on behalf of which the logger is created. module) Returns a `logger` suitable for use within the given `module`.
public final System.Logger	getLocalizedLogger(String the name of the logger. name, ResourceBundle a resource bundle; can be `null`. bundle, Module the module for which the logger is being requested. module) Overrides java.lang.System.LoggerFinder.getLocalizedLogger. Returns a localizable instance of `Logger` for the given `module`.
public final System.Logger	getLogger(String the name of the logger. name, Module the module for which the logger is being requested. module) Implements abstract java.lang.System.LoggerFinder.getLogger. Returns an instance of `Logger` for the given `module`.
public static boolean	isSystem(Module m)

Inherited from java.lang.System.LoggerFinder:: getLoggerFinder

Field Detail

LOGGERFINDER_PERMISSION	back to summary
pack-priv static final RuntimePermission LOGGERFINDER_PERMISSION Hides java.lang.System.LoggerFinder.LOGGERFINDER_PERMISSION.

Constructor Detail

DefaultLoggerFinder back to summary

DefaultLoggerFinder	back to summary
protected DefaultLoggerFinder() Creates a new instance of DefaultLoggerFinder. Exceptions SecurityException: if the calling code does not have the `RuntimePermission("loggerFinder")`

protected DefaultLoggerFinder()

Creates a new instance of DefaultLoggerFinder.

Exceptions

SecurityException:: if the calling code does not have the RuntimePermission("loggerFinder")

DefaultLoggerFinder	back to summary
private DefaultLoggerFinder(Void unused)

Method Detail

checkPermission	back to summary
private static Void checkPermission() Hides java.lang.System.LoggerFinder.checkPermission.

demandLoggerFor back to summary

demandLoggerFor	back to summary
protected System.Logger demandLoggerFor(String name, Module module) Returns a `logger` suitable for use within the given `module`. Implementation Specification The default implementation for this method is to return a simple logger that will print all messages of INFO level and above to the console. That simple logger is not configurable. Parameters name:String The name of the logger. module:Module The module on behalf of which the logger is created. Returns:System.Logger A `logger` suitable for the application usage. Exceptions SecurityException: if the calling code does not have the `RuntimePermission("loggerFinder")`.

protected System.Logger demandLoggerFor(String name, Module module)

Returns a logger suitable for use within the given module.

Implementation Specification

The default implementation for this method is to return a simple logger that will print all messages of INFO level and above to the console. That simple logger is not configurable.

Parameters

name:String: The name of the logger.
module:Module: The module on behalf of which the logger is created.

Returns:System.Logger

A logger suitable for the application usage.

Exceptions

SecurityException:: if the calling code does not have the RuntimePermission("loggerFinder").

getLocalizedLogger back to summary

getLocalizedLogger	back to summary
public final System.Logger getLocalizedLogger(String name, ResourceBundle bundle, Module module) Overrides java.lang.System.LoggerFinder.getLocalizedLogger. Doc from java.lang.System.LoggerFinder.getLocalizedLogger. Returns a localizable instance of `Logger` for the given `module`. The returned logger will use the provided resource bundle for message localization. Parameters name:String the name of the logger. bundle:ResourceBundle a resource bundle; can be `null`. module:Module the module for which the logger is being requested. Returns:System.Logger an instance of `Logger` which will use the provided resource bundle for message localization. Annotations @Override

public final System.Logger getLocalizedLogger(String name, ResourceBundle bundle, Module module)

Overrides java.lang.System.LoggerFinder.getLocalizedLogger.

Doc from java.lang.System.LoggerFinder.getLocalizedLogger.

Returns a localizable instance of Logger for the given module. The returned logger will use the provided resource bundle for message localization.

Parameters

name:String: the name of the logger.
bundle:ResourceBundle: a resource bundle; can be null.
module:Module: the module for which the logger is being requested.

Returns:System.Logger

an instance of Logger which will use the provided resource bundle for message localization.

Annotations

@Override

getLogger back to summary

getLogger	back to summary
public final System.Logger getLogger(String name, Module module) Implements abstract java.lang.System.LoggerFinder.getLogger. Doc from java.lang.System.LoggerFinder.getLogger. Returns an instance of `Logger` for the given `module`. Parameters name:String the name of the logger. module:Module the module for which the logger is being requested. Returns:System.Logger a `logger` suitable for use within the given module. Annotations @Override

public final System.Logger getLogger(String name, Module module)

Implements abstract java.lang.System.LoggerFinder.getLogger.

Doc from java.lang.System.LoggerFinder.getLogger.

Returns an instance of Logger for the given module.

Parameters

name:String: the name of the logger.
module:Module: the module for which the logger is being requested.

Returns:System.Logger

a logger suitable for use within the given module.

Annotations

@Override

isSystem	back to summary
public static boolean isSystem(Module m) Annotations @SuppressWarnings:removal

jdk.internal.logger back to summary

pack-priv final Class DefaultLoggerFinder.SharedLoggers

Class Inheritance

extends Object

java.lang.Object
jdk.internal.logger.DefaultLoggerFinder.SharedLoggers

Field Summary

Modifier and Type	Field and Description
pack-priv static final DefaultLoggerFinder.SharedLoggers	application
private final Map<String, Reference<System.Logger>>	loggers
private final ReferenceQueue<System.Logger>	queue
pack-priv static final DefaultLoggerFinder.SharedLoggers	system

Constructor Summary

Access	Constructor and Description
pack-priv	SharedLoggers()

Method Summary

Modifier and Type	Method and Description
pack-priv synchronized System.Logger	get(Function<String, System.Logger> loggerSupplier, final String name)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

application	back to summary
pack-priv static final DefaultLoggerFinder.SharedLoggers application

loggers	back to summary
private final Map<String, Reference<System.Logger>> loggers

queue	back to summary
private final ReferenceQueue<System.Logger> queue

system	back to summary
pack-priv static final DefaultLoggerFinder.SharedLoggers system

Constructor Detail

SharedLoggers	back to summary
pack-priv SharedLoggers()

Method Detail

get	back to summary
pack-priv synchronized System.Logger get(Function<String, System.Logger> loggerSupplier, final String name)

public Class DefaultLoggerFinder

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class DefaultLoggerFinder.SharedLoggers

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail