gov.nasa.worldwind.util

Class Logging

java.lang.Object

gov.nasa.worldwind.util.Logging

public class Logging
extends java.lang.Object

This class of static methods provides the interface to logging for WorldWind components. Logging is performed via java.util.logging. The default logger name is gov.nasa.worldwind. The logger name is configurable via Configuration.

See Also:

Configuration, java.util.logging

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	MAX_MESSAGE_REPEAT
protected static java.lang.String	MESSAGE_BUNDLE_NAME

Method Summary

Modifier and Type	Method and Description
static int	getMaxMessageRepeatCount() Indicates the maximum number of times the same log message should be repeated when generated in the same context, such as within a loop over renderables when operations in the loop consistently fail.
static java.lang.String	getMessage(java.lang.String property) Retrieves a message from the WorldWind message resource bundle.
static java.lang.String	getMessage(java.lang.String property, java.lang.Object... args) Retrieves a message from the WorldWind message resource bundle formatted with specified arguments.
static java.lang.String	getMessage(java.lang.String property, java.lang.String arg) Retrieves a message from the WorldWind message resource bundle formatted with a single argument.
static java.util.logging.Logger	logger() Returns the WorldWind logger.
static java.util.logging.Logger	logger(java.lang.String loggerName) Returns a specific logger.

Methods inherited from class java.lang.Object

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

Field Detail

MAX_MESSAGE_REPEAT

protected static final int MAX_MESSAGE_REPEAT

MESSAGE_BUNDLE_NAME

protected static final java.lang.String MESSAGE_BUNDLE_NAME

Method Detail

getMaxMessageRepeatCount

public static int getMaxMessageRepeatCount()

Indicates the maximum number of times the same log message should be repeated when generated in the same context, such as within a loop over renderables when operations in the loop consistently fail.

Returns:

the maximum number of times to repeat a message.

getMessage

public static java.lang.String getMessage(java.lang.String property)

Retrieves a message from the WorldWind message resource bundle.

Parameters:

property - the property identifying which message to retrieve.

Returns:

The requested message.

getMessage

public static java.lang.String getMessage(java.lang.String property,
                                          java.lang.Object... args)

Retrieves a message from the WorldWind message resource bundle formatted with specified arguments. The arguments are inserted into the message via MessageFormat.

Parameters:

property - the property identifying which message to retrieve.

args - the arguments referenced by the format string identified property.

Returns:

The requested string formatted with the arguments.

See Also:

MessageFormat

getMessage

public static java.lang.String getMessage(java.lang.String property,
                                          java.lang.String arg)

Retrieves a message from the WorldWind message resource bundle formatted with a single argument. The argument is inserted into the message via MessageFormat.

Parameters:

property - the property identifying which message to retrieve.

arg - the single argument referenced by the format string identified property.

Returns:

The requested string formatted with the argument.

See Also:

MessageFormat

logger

public static java.util.logging.Logger logger()

Returns the WorldWind logger.

Returns:

The logger.

logger

public static java.util.logging.Logger logger(java.lang.String loggerName)

Returns a specific logger. Does not access Configuration to determine the configured WorldWind logger.

This is needed by Configuration to avoid calls back into itself when its singleton instance is not yet instantiated.

Parameters:

loggerName - the name of the logger to use.

Returns:

The logger.