//========================================================================
//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;

import org.mortbay.jetty.RequestLog;
import org.mortbay.component.LifeCycle;

/* ------------------------------------------------------------ */
/**
 * This interface extends the {@link RequestLog} and {@link LifeCycle}
 * interfaces as well as adding additional methods to allow logger configuration
 * to be set. The main purpose of this interface is to provide a mechanism to
 * set the logger properties of the {@link Log4JRequestLogImpl} that will be
 * plugged into this interface without requiring the class to be loaded within
 * the server's application class loader.
 * 
 * @author Chance Yeoman
 */
public interface Log4JRequestLog extends RequestLog, LifeCycle {

    /* ------------------------------------------------------------ */
    /**
     * Sets the name of this RequestLog, which will be appended to the class
     * name of the implementing class to make the complete logger name. For
     * example:
     * 
     * org.mortbay.jetty.Log4JRequestLogImpl.MyLoggerName
     * 
     * This is the Logger name that must be specified in the log4j configuration
     * xml file when adding appenders.
     * 
     * @param accessLoggerName
     *            String name for the Logger instance. Used to configure
     *            logger-specific appenders.
     */
    public void setAccessLoggerName(final String accessLoggerName);

    public void setLogServer(boolean logServer);

    public void setPreferProxiedForAddress(boolean preferProxiedForAddress);

    public void setLogDateFormat(String logDateFormat);

    public void setLogTimeZone(String logTimeZone);

    public void setIgnorePaths(String[] ignorePaths);

    public void setExtended(boolean extended);

    public void setLogCookies(boolean logCookies);

    public void setLogLatency(boolean logLatency);

}