| java.lang.Object
 org.zkoss.util.logging.LogService
| LogService | | public class LogService (Code) | | The log service which is used to monitor i3-log.conf.
To initialize it, invoke
LogService.init . Note:
Log could work
without
LogService .
Design consideration: the configure and configureAndWatch
methods could be declared as static, but we don't.
Reason: easilier to extend (also the performance gained by
the static method is neglectable comparing its complexity).
Implementation Note:
LogService cannot be a component (because ComponentManager depedns
on iDom, which depends on log). Thus, we use Singleton instead.
author:
tomyeh |
| Field Summary | |
| final protected String | _root
The name of the root logger that this logging service is monitoring. |
| Constructor Summary | |
| public | LogService(String root)
Constructor.
Don't call this method directly. |
| Method Summary | |
| final public void | configure(Properties props)
Configures based the properties. | | final public void | configure(File file)
Configures based the properties stored in a file. | | final public void | configure(String filename)
Configures based the properties stored in a file. | | final public FileWatchdog | configureAndWatch(File file, long delay)
Periodically checks whether a file is modified, and configures
based the properties stored in the file, if any modifications. | | final public static LogService | init(String rootnm, Class cls)
Initializes the logging service.
If the log service already started, an error message is logged.
Note: it also enables the hierarchy support of loggers by
calling
Log.setHierarchy with true.
Parameters:
rootnm - the name of the root logger. | | final public static boolean | isInited(String rootnm)
Returns whether the logging service is started, i.e., whether
LogService.init is invoked. | | final public static void | stop(String rootnm)
| | public synchronized void | stop()
Stops the service. |
| _root | | final protected String _root(Code) | | The name of the root logger that this logging service is monitoring.
Note: we cannot use Logger because Tomcat has one root per Web app
|
| LogService | | public LogService(String root)(Code) | | Constructor.
Don't call this method directly. Rather, use
LogService.init to
start the service.
|
| configure | | final public void configure(Properties props)(Code) | | Configures based the properties.
The key is a logger name and the value is the level.
A special level, INHERIT or NULL, to denote resetting the level
to be the same as the logger's parent.
Parameters:
props - the properties |
| configure | | final public void configure(File file) throws FileNotFoundException, IOException(Code) | | Configures based the properties stored in a file.
The key is a logger name and the value is the level.
Parameters:
file - the file |
| configure | | final public void configure(String filename) throws FileNotFoundException, IOException(Code) | | Configures based the properties stored in a file.
The key is a logger name and the value is the level.
Parameters:
filename - the filename |
| configureAndWatch | | final public FileWatchdog configureAndWatch(File file, long delay)(Code) | | Periodically checks whether a file is modified, and configures
based the properties stored in the file, if any modifications.
The key is a logger name and the value is the level.
Parameters:
file - the file
Parameters:
delay - the delay in milliseconds to wait between each check. |
| init | | final public static LogService init(String rootnm, Class cls)(Code) | | Initializes the logging service.
If the log service already started, an error message is logged.
Note: it also enables the hierarchy support of loggers by
calling
Log.setHierarchy with true.
Parameters:
rootnm - the name of the root logger. The logging serviceregistered handlers at the specified logger.
Parameters:
cls - the implementation to start. If null, LogServiceis used. |
| isInited | | final public static boolean isInited(String rootnm)(Code) | | Returns whether the logging service is started, i.e., whether
LogService.init is invoked.
|
| stop | | final public static void stop(String rootnm)(Code) | | Stops the logging service
|
| stop | | public synchronized void stop()(Code) | | Stops the service. You rarely need to do so. This service monitors
whether any preference is changed, and automatically reflects
the new changes.
|
|
|