KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > avalon > logging > provider > LoggingManager


1 /*
2  * Copyright 2004 Apache Software Foundation
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at
6  *
7  * http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
12  * implied.
13  *
14  * See the License for the specific language governing permissions and
15  * limitations under the License.
16  */
17
18 package org.apache.avalon.logging.provider;
19
20 import org.apache.avalon.framework.logger.Logger;
21 import org.apache.avalon.logging.data.CategoriesDirective;
22
23 /**
24  * A <code>LoggerManager</code> that supports the management of a logging hierarchy.
25  * @author <a HREF="mailto:dev@avalon.apache.org">Avalon Development Team</a>
26  * @version $Revision: 1.2 $ $Date: 2004/03/17 10:30:07 $
27  */
28 public interface LoggingManager
29 {
30     /**
31      * Standard context key for the logging manager.
32      */
33      String JavaDoc KEY = "urn:avalon:logging.manager";
34
35     /**
36      * Add a set of category entries using the supplied categories descriptor.
37      * @param descriptor a set of category descriptors to be added under the path
38      */
39     void addCategories( CategoriesDirective descriptor );
40
41     /**
42      * Add a set of category entries relative to the supplied base category
43      * path, using the supplied descriptor as the definition of subcategories.
44      * @param path the category base path
45      * @param descriptor a set of category descriptors to be added under
46      * the base path
47      */
48     void addCategories( String JavaDoc path, CategoriesDirective descriptor );
49
50     /**
51      * Return the Logger for the specified category.
52      * @param category the category path
53      * @return the logging channel
54      */
55     Logger getLoggerForCategory( final String JavaDoc category );
56
57 }
58
Popular Tags