cvs commit: jakarta-log4j/docs proposal.html

[ceki]

ceki        01/08/22 23:24:10

  Modified:    docs     proposal.html
  Log:
  Added isXXXEnabled methods for all levels.
  Renamed Logmanager#getDefault to LogManager.getLogManager()
  
  Revision  Changes    Path
  1.2       +21 -17    jakarta-log4j/docs/proposal.html
  
  Index: proposal.html
  ===================================================================
  RCS file: /home/cvs/jakarta-log4j/docs/proposal.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- proposal.html     2001/08/23 05:47:50     1.1
  +++ proposal.html     2001/08/23 06:24:10     1.2
  @@ -31,7 +31,7 @@
   method called <code>setLevel</code> and also a method called
   <code>setPriority</code> (to preserve backward compatibility).
   
  -<p>The user will only deal with a simple <code>Logger</code> class
  +<p>The user will only deal with a minimal <code>Logger</code> class
   offering few essential methods. More concretely:
   
   <p><table bgcolor="CCCCCC">
  @@ -40,19 +40,20 @@
   public <b>abstract class</b> Logger {
   
     protected final String  name;  
  -  protected Level level;
  -  protected ResourceBundle resourceBundle;
     
     protected Logger(String name) {
       this.name = name;
     }
   
  +  public abstract boolean isDebugEnabled(); 
     public abstract void debug(Object message);  
     public abstract void debug(Object message, Throwable t);  
   
  +  public abstract boolean isErrorEnabled(); 
     public abstract void error(Object message);  
     public abstract void error(Object message, Throwable t);
   
  +  public abstract boolean isFatalEnabled(); 
     public abstract void fatal(Object message);  
     public abstract void fatal(Object message, Throwable t);
     
  @@ -60,25 +61,18 @@
       return name;
     }
       
  +  public abstract boolean isInfoEnabled(); 
     public abstract void info(Object message);  
     public abstract void info(Object message, Throwable t);
   
  -  public abstract boolean isDebugEnabled(); 
  -  public abstract boolean isEnabledFor(Level level);
  -  public abstract boolean isInfoEnabled();
  -
     public abstract void l7dlog(Level level, String key, Throwable t);
     public abstract void l7dlog(Level level, String key,  Object[] params, Throwable 
t);
  -  
  +
  +  public abstract boolean isEnabledFor(Level level);  
     public abstract void log(Level level, Object message, Throwable t);  
     public abstract void log(Level level, Object message);
  -
  -  public final Level getLevel() { return level; }
  -  public abstract void setLevel(Level level);
   
  -  public final ResourceBunder getResourceBundle() { return resourceBundle; }
  -  public abstract void setResourceBundle(ResourceBundle bundle);
  -
  +  public abstract boolean isWarnEnabled(); 
     public abstract void warn(Object message);  
     public abstract void warn(Object message, Throwable t);
   }
  @@ -118,9 +112,8 @@
     public Logger getLogger(Class clazz) {
       return getLogger(clazzz.getName());
     }
  -
   
  -  static public LogManager getDefault() {
  +  <b>static</b> public LogManager getLogManager() {
       // returns the default LogManager 
     }
   }
  @@ -133,9 +126,13 @@
   <p><table bgcolor="CCCCCC">
   <tr><td>
   <pre>
  +
  +import org.apache.log4j.LogManager;
  +import org.apache.log4j.Logger;
  +
   public class Foo {
   
  - final static Logger logger = LogManager.getDefault().getLogger(Foo.class);
  + final static Logger logger = LogManager.getLogManager().getLogger(Foo.class);
   
    void bar() {
      logger.debug("hello world.");
  @@ -152,6 +149,10 @@
   <p><table bgcolor="CCCCCC">
   <tr><td>
   <pre>
  +
  +import org.apache.log4j.LogManager;
  +import org.apache.log4j.Logger;
  +
   public class Foo {
   
    
  @@ -179,6 +180,9 @@
   model whereas under JDK 1.1 the returned logger implementation may be
   oblivious to Java2 security checks.
   
  +<p>As in JSR47, the exact implementation of <code>LogManager</code>
  +returned by <code>LogManager.getLogManager()</code> maybe influenced
  +system properties.
   
   </body>
   
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]