|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.google.gwt.libideas.logging.shared.Log
public class Log
This class is very loosely based Java's Logger class. It is static to allow
differed binding to remove logging information in production code.
By default the logging level is set to Level.CONFIG
.
If you wish to use this class in code that may not be run in a GWT
environment, you must instantiate on of the system logging adaptors available
from com.google.gwt.libideas.logging.server.SystemLogSystemLog
.
Field Summary | |
---|---|
static java.lang.String |
CATEGORY
|
Constructor Summary | |
---|---|
Log()
|
Method Summary | |
---|---|
static boolean |
addLogHandler(LogHandler handler)
Add a log Handler to receive logging messages. |
static void |
clearLogHandlers()
Clear all handlers. |
static void |
config(java.lang.String msg)
Log a CONFIG message. |
static void |
config(java.lang.String msg,
java.lang.String category)
Log a CONFIG message. |
static void |
fine(java.lang.String msg)
Log a FINE message. |
static void |
fine(java.lang.String msg,
java.lang.String category)
Log a FINE message. |
static void |
finer(java.lang.String msg)
Log a FINER message. |
static void |
finer(java.lang.String msg,
java.lang.String category)
Log a FINER message. |
static void |
finest(java.lang.String msg)
Log a FINEST message. |
static void |
finest(java.lang.String msg,
java.lang.String category)
Log a FINEST message. |
static Level |
getDefaultLevel()
Get the default log level needed to publish messages. |
protected static com.google.gwt.libideas.logging.shared.impl.LogImpl |
getLogImpl()
Gets the current LogImpl class. |
static void |
info(java.lang.String msg)
Log an INFO message. |
static void |
info(java.lang.String msg,
java.lang.String category)
Log an INFO message. |
protected static void |
initLogImpl(com.google.gwt.libideas.logging.shared.impl.LogImpl impl)
|
static boolean |
isLoggable(Level level)
Check if a message of the given level would actually be logged by this logger. |
static boolean |
isLoggingMinimal()
Is the logging system in minimal mode? i.e. |
static boolean |
isLoggingSupported()
Is Logging supported? |
static java.util.Iterator |
levelIterator()
Returns an iterator of all currently defined levels. |
static void |
log(java.lang.String msg,
Level level,
java.lang.String category,
java.lang.Throwable e)
Logs a message using a given level. |
static Level |
parseLevel(java.lang.String levelName)
Return the correct level based on name. |
static void |
removeLogHandler(LogHandler handler)
Remove a log Handler. |
static void |
setDefaultLevel(Level newLevel)
Set the default log level specifying which message levels will be logged by this logger. |
static void |
setLevel(java.lang.String category,
Level level)
Sets the level of a given logging category. |
static void |
severe(java.lang.String msg)
Log a SEVERE message. |
static void |
severe(java.lang.String msg,
java.lang.String category)
Log a SEVERE message. |
static void |
severe(java.lang.String msg,
java.lang.String category,
java.lang.Throwable t)
Log a SEVERE message. |
static java.lang.String[] |
splitCategory(java.lang.String category)
Splits the category into its component parts, separated by the "." character. |
static void |
warning(java.lang.String msg)
Log a WARNING message. |
static void |
warning(java.lang.String msg,
java.lang.String category)
Log a WARNING message. |
static void |
warning(java.lang.String msg,
java.lang.String category,
java.lang.Throwable e)
Log a WARNING message. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final java.lang.String CATEGORY
Constructor Detail |
---|
public Log()
Method Detail |
---|
public static boolean addLogHandler(LogHandler handler)
If no handlers are supplied and a message should be logged, it will be logging to the GWT console in hosted mode and the JavaScript console in web mode.
handler
- the new handler
public static void clearLogHandlers()
public static void config(java.lang.String msg)
public static void config(java.lang.String msg, java.lang.String category)
public static void fine(java.lang.String msg)
public static void fine(java.lang.String msg, java.lang.String category)
public static void finer(java.lang.String msg)
public static void finer(java.lang.String msg, java.lang.String category)
public static void finest(java.lang.String msg)
public static void finest(java.lang.String msg, java.lang.String category)
public static Level getDefaultLevel()
public static void info(java.lang.String msg)
public static void info(java.lang.String msg, java.lang.String category)
public static boolean isLoggable(Level level)
level
- a message logging level
public static boolean isLoggingMinimal()
public static boolean isLoggingSupported()
public static java.util.Iterator levelIterator()
public static void log(java.lang.String msg, Level level, java.lang.String category, java.lang.Throwable e)
public static Level parseLevel(java.lang.String levelName)
java.lang.IllegalArgumentException
- for unknown levels.public static void removeLogHandler(LogHandler handler)
Returns silently if the given Handler is not found or is null
handler
- a logging Handler
java.lang.SecurityException
- if a security manager exists and if the caller
does not have LoggingPermission("control").public static void setDefaultLevel(Level newLevel)
public static void setLevel(java.lang.String category, Level level)
category
- categorylevel
- levelpublic static void severe(java.lang.String msg)
If the logger is currently enabled for the SEVERE message level then the given message is forwarded to all the registered output Handler objects.
msg
- The string messagepublic static void severe(java.lang.String msg, java.lang.String category)
public static void severe(java.lang.String msg, java.lang.String category, java.lang.Throwable t)
public static java.lang.String[] splitCategory(java.lang.String category)
public static void warning(java.lang.String msg)
If the logger is currently enabled for the WARNING message level then the given message is forwarded to all the registered output Handler objects.
msg
- The string messagepublic static void warning(java.lang.String msg, java.lang.String category)
public static void warning(java.lang.String msg, java.lang.String category, java.lang.Throwable e)
protected static com.google.gwt.libideas.logging.shared.impl.LogImpl getLogImpl()
protected static void initLogImpl(com.google.gwt.libideas.logging.shared.impl.LogImpl impl)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |