io.vertx.core.logging.Logger Maven / Gradle / Ivy
/*
* Copyright (c) 2011-2019 Contributors to the Eclipse Foundation
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License 2.0 which is available at
* http://www.eclipse.org/legal/epl-2.0, or the Apache License, Version 2.0
* which is available at https://www.apache.org/licenses/LICENSE-2.0.
*
* SPDX-License-Identifier: EPL-2.0 OR Apache-2.0
*/
package io.vertx.core.logging;
import io.vertx.core.spi.logging.LogDelegate;
/**
* This class allows us to isolate all our logging dependencies in one place. It also allows us to have zero runtime
* 3rd party logging jar dependencies, since we default to JUL by default.
*
* By default logging will occur using JUL (Java-Util-Logging). The logging configuration file (logging.properties)
* used by JUL will taken from the default logging.properties in the JDK installation if no {@code java.util.logging.config.file} system
* property is set.
*
* If you would prefer to use Log4J 2 or SLF4J instead of JUL then you can set a system property called
* {@code vertx.logger-delegate-factory-class-name} to the class name of the delegate for your logging system.
* For Log4J 2 the value is {@link io.vertx.core.logging.Log4j2LogDelegateFactory}, for SLF4J the value
* is {@link io.vertx.core.logging.SLF4JLogDelegateFactory}. You will need to ensure whatever jar files
* required by your favourite log framework are on your classpath.
*
* Keep in mind that logging backends use different formats to represent replaceable tokens in parameterized messages.
* As a consequence, if you rely on parameterized logging methods, you won't be able to switch backends without changing your code.
*
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*
* @author Tim Fox
*/
@Deprecated
public class Logger {
final LogDelegate delegate;
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public Logger(final LogDelegate delegate) {
this.delegate = delegate;
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public boolean isWarnEnabled() {
return delegate.isWarnEnabled();
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public boolean isInfoEnabled() {
return delegate.isInfoEnabled();
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public boolean isDebugEnabled() {
return delegate.isDebugEnabled();
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public boolean isTraceEnabled() {
return delegate.isTraceEnabled();
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void fatal(final Object message) {
delegate.fatal(message);
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void fatal(final Object message, final Throwable t) {
delegate.fatal(message, t);
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void error(final Object message) {
delegate.error(message);
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void error(final Object message, final Throwable t) {
delegate.error(message, t);
}
/**
* @throws UnsupportedOperationException if the logging backend does not support parameterized messages
*
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void error(final Object message, final Object... objects) {
delegate.error(message, objects);
}
/**
* @throws UnsupportedOperationException if the logging backend does not support parameterized messages
*
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void error(final Object message, final Throwable t, final Object... objects) {
delegate.error(message, t, objects);
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void warn(final Object message) {
delegate.warn(message);
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void warn(final Object message, final Throwable t) {
delegate.warn(message, t);
}
/**
* @throws UnsupportedOperationException if the logging backend does not support parameterized messages
*
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void warn(final Object message, final Object... objects) {
delegate.warn(message, objects);
}
/**
* @throws UnsupportedOperationException if the logging backend does not support parameterized messages
*
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void warn(final Object message, final Throwable t, final Object... objects) {
delegate.warn(message, t, objects);
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void info(final Object message) {
delegate.info(message);
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void info(final Object message, final Throwable t) {
delegate.info(message, t);
}
/**
* @throws UnsupportedOperationException if the logging backend does not support parameterized messages
*
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void info(final Object message, final Object... objects) {
delegate.info(message, objects);
}
/**
* @throws UnsupportedOperationException if the logging backend does not support parameterized messages
*
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void info(final Object message, final Throwable t, final Object... objects) {
delegate.info(message, t, objects);
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void debug(final Object message) {
delegate.debug(message);
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void debug(final Object message, final Throwable t) {
delegate.debug(message, t);
}
/**
* @throws UnsupportedOperationException if the logging backend does not support parameterized messages
*
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void debug(final Object message, final Object... objects) {
delegate.debug(message, objects);
}
/**
* @throws UnsupportedOperationException if the logging backend does not support parameterized messages
*
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void debug(final Object message, final Throwable t, final Object... objects) {
delegate.debug(message, t, objects);
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void trace(final Object message) {
delegate.trace(message);
}
/**
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void trace(final Object message, final Throwable t) {
delegate.trace(message, t);
}
/**
* @throws UnsupportedOperationException if the logging backend does not support parameterized messages
*
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void trace(final Object message, final Object... objects) {
delegate.trace(message, objects);
}
/**
* @throws UnsupportedOperationException if the logging backend does not support parameterized messages
*
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public void trace(final Object message, final Throwable t, final Object... objects) {
delegate.trace(message, t, objects);
}
/**
* @return the delegate instance sending operations to the underlying logging framework
*
* @deprecated see https://github.com/eclipse-vertx/vert.x/issues/2774
*/
@Deprecated
public LogDelegate getDelegate() {
return delegate;
}
}