1   package org.apache.log4j.spi;
2   
3   
4   import org.apache.log4j.spi.LoggerRepository;
5   import java.net.URL;
6   
7   /**
8      Implemented by classes capable of configuring log4j using a URL.
9   
10     @since 1.0
11     @author Anders Kristensen
12   */
13  public interface Configurator {
14  
15    /**
16       Special level value signifying inherited behaviour. The current
17       value of this string constant is <b>inherited</b>. {@link #NULL}
18       is a synonym.  */
19    public static final String INHERITED = "inherited";
20  
21    /**
22       Special level signifying inherited behaviour, same as {@link
23       #INHERITED}. The current value of this string constant is
24       <b>null</b>. */
25    public static final String NULL = "null";
26  
27  
28  
29    /**
30       Interpret a resource pointed by a URL and set up log4j accordingly.
31  
32       The configuration is done relative to the <code>hierarchy</code>
33       parameter.
34  
35       @param url The URL to parse
36       @param repository The hierarchy to operation upon.
37     */
38    void doConfigure(URL url, LoggerRepository repository);
39  }