    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
    018package org.apache.commons.logging;
    019
    020import java.util.Objects;
    021
    022/**
    023 * An exception that is thrown only if a suitable {@code LogFactory} or {@code Log} instance cannot be created by the corresponding factory methods.
    024 */
    025public class LogConfigurationException extends RuntimeException {
    026
    027    /** Serializable version identifier. */
    028    private static final long serialVersionUID = 8486587136871052495L;
    029
    030    /**
    031     * The underlying cause of this exception.
    032     *
    033     * @deprecated Use {@link #getCause()}.
    034     */
    035    @Deprecated
    036    protected Throwable cause;
    037
    038    /**
    039     * Constructs a new exception with {@code null} as its detail message.
    040     */
    041    public LogConfigurationException() {
    042    }
    043
    044    /**
    045     * Constructs a new exception with the specified detail message.
    046     *
    047     * @param message The detail message
    048     */
    049    public LogConfigurationException(final String message) {
    050        super(message);
    051    }
    052
    053    /**
    054     * Constructs a new exception with the specified detail message and cause.
    055     *
    056     * @param message The detail message
    057     * @param cause   The underlying cause
    058     */
    059    public LogConfigurationException(final String message, final Throwable cause) {
    060        super(message, cause);
    061        this.cause = cause;
    062    }
    063
    064    /**
    065     * Constructs a new exception with the specified cause and a derived detail message.
    066     *
    067     * @param cause The underlying cause
    068     */
    069    public LogConfigurationException(final Throwable cause) {
    070        this(Objects.toString(cause, null), cause);
    071    }
    072
    073}