http://nexus.sonatype.org/oss-repository-hosting.html/vertx-parent/vertx-core: Sonatype helps open source projects to set up Maven repositories on https://oss.sonatype.org/ (Eclipse) 
/*
 * 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  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 vertx.logger-delegate-factory-class-name to the class name of the delegate for your logging system. For Log4J 2 the value is Log4j2LogDelegateFactory, for SLF4J the value is 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.

Author:Tim Fox
Deprecated:see https://github.com/eclipse-vertx/vert.x/issues/2774
/**
 * 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.
 * <p>
 * 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.
 * <p>
 * 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.
 * <p>
 * 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 <a href="mailto:tim.fox@jboss.com">Tim Fox</a>
 */
@Deprecated
public class Logger {

  final LogDelegate delegate;

  
Deprecated:see https://github.com/eclipse-vertx/vert.x/issues/2774
/**
   * @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 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 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 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 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 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 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 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 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
/**
   * @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
/**
   * @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 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 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
/**
   * @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
/**
   * @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 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 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
/**
   * @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
/**
   * @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 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 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
/**
   * @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
/**
   * @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 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 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
/**
   * @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
/**
   * @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);
  }

  
Returns:the delegate instance sending operations to the underlying logging framework
Deprecated:see https://github.com/eclipse-vertx/vert.x/issues/2774
/**
   * @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;
  }
}