001    /*
002     * Licensed to the Apache Software Foundation (ASF) under one or more
003     * contributor license agreements. See the NOTICE file distributed with
004     * this work for additional information regarding copyright ownership.
005     * The ASF licenses this file to You under the Apache license, Version 2.0
006     * (the "License"); you may not use this file except in compliance with
007     * the License. You may obtain a copy of the License at
008     *
009     *      http://www.apache.org/licenses/LICENSE-2.0
010     *
011     * Unless required by applicable law or agreed to in writing, software
012     * distributed under the License is distributed on an "AS IS" BASIS,
013     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014     * See the license for the specific language governing permissions and
015     * limitations under the license.
016     */
017    package org.apache.log4j;
018    
019    import org.apache.log4j.spi.LoggerRepository;
020    
021    import java.io.InputStream;
022    import java.net.URL;
023    import java.util.Properties;
024    
025    /**
026     *
027     * @since 0.8.1
028     */
029    public class PropertyConfigurator {
030    
031        public void doConfigure(final String configFileName, final LoggerRepository hierarchy) {
032    
033        }
034    
035        public static void configure(final String configFileName) {
036        }
037    
038        /**
039         Read configuration options from url <code>configURL</code>.
040    
041         @since 0.8.2
042         */
043        public static void configure(final URL configURL) {
044        }
045    
046        /**
047         Reads configuration options from an InputStream.
048    
049         @since 1.2.17
050         */
051        public static void configure(final InputStream inputStream) {
052        }
053    
054    
055        /**
056         Read configuration options from <code>properties</code>.
057    
058         See {@link #doConfigure(String, LoggerRepository)} for the expected format.
059         */
060        public static void configure(final Properties properties) {
061        }
062    
063        /**
064         Like {@link #configureAndWatch(String, long)} except that the
065         default delay as defined by FileWatchdog.DEFAULT_DELAY is
066         used.
067    
068         @param configFilename A file in key=value format.
069    
070         */
071        public static void configureAndWatch(final String configFilename) {
072        }
073    
074    
075        /**
076         Read the configuration file <code>configFilename</code> if it
077         exists. Moreover, a thread will be created that will periodically
078         check if <code>configFilename</code> has been created or
079         modified. The period is determined by the <code>delay</code>
080         argument. If a change or file creation is detected, then
081         <code>configFilename</code> is read to configure log4j.
082    
083         @param configFilename A file in key=value format.
084         @param delay The delay in milliseconds to wait between each check.
085         */
086        public static void configureAndWatch(final String configFilename, final long delay) {
087        }
088    
089    
090        /**
091         Read configuration options from <code>properties</code>.
092    
093         See {@link #doConfigure(String, LoggerRepository)} for the expected format.
094         */
095        public void doConfigure(final Properties properties, final LoggerRepository hierarchy) {
096        }
097    
098        /**
099         * Read configuration options from an InputStream.
100         *
101         * @since 1.2.17
102         */
103        public void doConfigure(final InputStream inputStream, final LoggerRepository hierarchy) {
104        }
105    
106        /**
107         Read configuration options from url <code>configURL</code>.
108         */
109        public void doConfigure(final java.net.URL configURL, final LoggerRepository hierarchy) {
110        }
111    }