org.apache.logging.log4j.jul.LevelTranslator Maven / Gradle / Ivy
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to you 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.apache.logging.log4j.jul;
import org.apache.logging.log4j.Level;
import org.apache.logging.log4j.Logger;
import org.apache.logging.log4j.status.StatusLogger;
import org.apache.logging.log4j.util.LoaderUtil;
import org.apache.logging.log4j.util.PropertiesUtil;
/**
* Utility class to convert between JDK Levels and Log4j 2 Levels.
*
* @since 2.1
*/
public final class LevelTranslator {
/**
* Custom Log4j level corresponding to the {@link java.util.logging.Level#FINEST} logging level. This maps to a
* level more specific than {@link org.apache.logging.log4j.Level#TRACE}.
*/
public static final Level FINEST = Level.forName("FINEST", Level.TRACE.intLevel() + 100);
/**
* Custom Log4j level corresponding to the {@link java.util.logging.Level#CONFIG} logging level. This maps to a
* level in between {@link org.apache.logging.log4j.Level#INFO} and {@link org.apache.logging.log4j.Level#DEBUG}.
*/
public static final Level CONFIG = Level.forName("CONFIG", Level.INFO.intLevel() + 50);
private static final Logger LOGGER = StatusLogger.getLogger();
private static final LevelConverter LEVEL_CONVERTER;
static {
final String levelConverterClassName =
PropertiesUtil.getProperties().getStringProperty(Constants.LEVEL_CONVERTER_PROPERTY);
if (levelConverterClassName != null) {
LevelConverter levelConverter;
try {
levelConverter = LoaderUtil.newCheckedInstanceOf(levelConverterClassName, LevelConverter.class);
} catch (final Exception e) {
LOGGER.error("Could not create custom LevelConverter [{}].", levelConverterClassName, e);
levelConverter = new DefaultLevelConverter();
}
LEVEL_CONVERTER = levelConverter;
} else {
LEVEL_CONVERTER = new DefaultLevelConverter();
}
}
/**
* Converts a JDK logging Level to a Log4j logging Level.
*
* @param level JDK Level to convert, may be null per the JUL specification.
* @return converted Level or null
*/
public static Level toLevel(final java.util.logging.Level level) {
return LEVEL_CONVERTER.toLevel(level);
}
/**
* Converts a Log4j logging Level to a JDK logging Level.
*
* @param level Log4j Level to convert.
* @return converted Level.
*/
public static java.util.logging.Level toJavaLevel(final Level level) {
return LEVEL_CONVERTER.toJavaLevel(level);
}
private LevelTranslator() {}
}