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.commons.inject.api;
018    
019    import org.apache.logging.log4j.LogManager;
020    import org.apache.logging.log4j.Logger;
021    
022    
023    /**
024     * A {@link IModule module}, which injects Log4J 2 loggers, aka instances of
025     * {@link Logger}.
026     * If you are using the module, it should precede all others in your module list,
027     * when invoking {@link CommonsInject#build(org.apache.commons.inject.api.bind.IModule...)},
028     * or {@link CommonsInject#build(java.util.Collection)}. However, the
029     * {@link PostConstructModule} takes precedence, if you are using that as well.
030     * @see Log4jLoggerModule
031     * @see Slf4JLoggerModule
032     * @see CommonsLoggingLoggerModule
033     * @see AbstractLoggerInjectingModule
034     */
035    public class Log4j2LoggerModule extends AbstractLoggerInjectingModule<Logger> {
036            /**
037             * Creates an instance of {@link Logger}.
038             */
039            @Override
040            protected Logger newLogger(String pId) {
041                    return LogManager.getLogger(pId);
042            }
043    }