//========================================================================
//Copyright 1997-2006 Mort Bay Consulting Pty. Ltd.
//------------------------------------------------------------------------
//Licensed under the Apache License, Version 2.0 (the "License");
//you may not use this file except in compliance with the License.
//You may obtain a copy of the License at
//http://www.apache.org/licenses/LICENSE-2.0
//Unless required by applicable law or agreed to in writing, software
//distributed under the License is distributed on an "AS IS" BASIS,
//WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
//See the License for the specific language governing permissions and
//limitations under the License.
//========================================================================

package org.mortbay.jetty;

/* ------------------------------------------------------------ */
/**
 * This interface provides a mechanism to call the loadLog4JConfig method of the
 * {@link Log4JConfigLoaderImpl} that will be plugged into this interface
 * without requiring the class to be loaded within the server's application
 * class loader.
 * 
 * Note that this method should only be called once, upon server startup. All
 * server log4j configuration should be set within the specified config file.
 * 
 * @author Chance Yeoman
 */
public interface Log4JConfigLoader {

    /* ------------------------------------------------------------ */
    /**
     * Loads the specified log4j xml configuration file and applies the
     * configuration to all Loggers that are instantiated by static calls to the
     * {@link JettyServerLog4JConfig} class.
     * 
     * @param String
     *            path to the log4j configuration xml file.
     */
    public void loadLog4JConfig(String pathToFile);

}