001    // Copyright 2005 The Apache Software Foundation
002    //
003    // Licensed under the Apache License, Version 2.0 (the "License");
004    // you may not use this file except in compliance with the License.
005    // You may obtain a copy of the License at
006    //
007    //     http://www.apache.org/licenses/LICENSE-2.0
008    //
009    // Unless required by applicable law or agreed to in writing, software
010    // distributed under the License is distributed on an "AS IS" BASIS,
011    // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
012    // See the License for the specific language governing permissions and
013    // limitations under the License.
014    
015    package org.apache.hivemind.management.log4j;
016    
017    /**
018     * Interface of the LogManagementMBean service This is not the mbean management interface. *
019     * 
020     * @author Achim Huegen
021     * @since 1.1
022     */
023    public interface LogManagement
024    {
025        /**
026         * Adds a MBean for a logger or a group of loggers that matches a pattern. The pattern kann
027         * contain '*' as wildcard character. If no wildcard is used the logger is created if it doesn't
028         * exist. This is useful, since most loggers are not created before the defining class is
029         * loaded. And this may be long after this MBean is registered. If a wildcard is used, only
030         * loggers that already exist. Example: addLoggerMBean( "hivemind.*" )
031         * 
032         * @param loggerPattern
033         *            Name of the logger
034         * @return ObjectName of created MBean
035         */
036        public void addLoggerMBean(String loggerPattern);
037    }