You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sis.apache.org by de...@apache.org on 2021/12/10 10:23:45 UTC
[sis] branch geoapi-4.0 updated: Deprecate `LoggerFactory` for removal. https://issues.apache.org/jira/browse/SIS-531
This is an automated email from the ASF dual-hosted git repository.
desruisseaux pushed a commit to branch geoapi-4.0
in repository https://gitbox.apache.org/repos/asf/sis.git
The following commit(s) were added to refs/heads/geoapi-4.0 by this push:
new 8796eb1 Deprecate `LoggerFactory` for removal. https://issues.apache.org/jira/browse/SIS-531
8796eb1 is described below
commit 8796eb1f9206dd7f43ba49f6b2f05d8ec741b00e
Author: Martin Desruisseaux <ma...@geomatys.com>
AuthorDate: Fri Dec 10 11:23:08 2021 +0100
Deprecate `LoggerFactory` for removal.
https://issues.apache.org/jira/browse/SIS-531
---
.../src/main/java/org/apache/sis/util/logging/DualLogger.java | 4 ++++
.../src/main/java/org/apache/sis/util/logging/DualLoggerFactory.java | 4 ++++
.../src/main/java/org/apache/sis/util/logging/LoggerAdapter.java | 4 ++++
.../src/main/java/org/apache/sis/util/logging/LoggerFactory.java | 4 ++++
.../src/main/java/org/apache/sis/util/logging/Logging.java | 4 ++++
5 files changed, 20 insertions(+)
diff --git a/core/sis-utility/src/main/java/org/apache/sis/util/logging/DualLogger.java b/core/sis-utility/src/main/java/org/apache/sis/util/logging/DualLogger.java
index 66aff57..48bda47 100644
--- a/core/sis-utility/src/main/java/org/apache/sis/util/logging/DualLogger.java
+++ b/core/sis-utility/src/main/java/org/apache/sis/util/logging/DualLogger.java
@@ -30,7 +30,11 @@ import java.util.logging.Logger;
* @version 0.3
* @since 0.3
* @module
+ *
+ * @deprecated Will be removed since there is now other mechanisms for redirecting logging.
+ * See <a href="https://issues.apache.org/jira/browse/SIS-531">SIS-531</a>.
*/
+@Deprecated
@SuppressWarnings("ClassWithMultipleLoggers")
final class DualLogger extends LoggerAdapter {
/**
diff --git a/core/sis-utility/src/main/java/org/apache/sis/util/logging/DualLoggerFactory.java b/core/sis-utility/src/main/java/org/apache/sis/util/logging/DualLoggerFactory.java
index e6a90f3..3a0ad5b 100644
--- a/core/sis-utility/src/main/java/org/apache/sis/util/logging/DualLoggerFactory.java
+++ b/core/sis-utility/src/main/java/org/apache/sis/util/logging/DualLoggerFactory.java
@@ -29,7 +29,11 @@ import java.util.logging.Logger;
* @version 0.3
* @since 0.3
* @module
+ *
+ * @deprecated Will be removed since there is now other mechanisms for redirecting logging.
+ * See <a href="https://issues.apache.org/jira/browse/SIS-531">SIS-531</a>.
*/
+@Deprecated
final class DualLoggerFactory extends LoggerFactory<DualLogger> {
/**
* The factories of loggers on which to delegate logging events.
diff --git a/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerAdapter.java b/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerAdapter.java
index 0ccb0f2..32fa4ae 100644
--- a/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerAdapter.java
+++ b/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerAdapter.java
@@ -92,7 +92,11 @@ import org.apache.sis.util.Debug;
*
* @since 0.3
* @module
+ *
+ * @deprecated Will be removed since there is now other mechanisms for redirecting logging.
+ * See <a href="https://issues.apache.org/jira/browse/SIS-531">SIS-531</a>.
*/
+@Deprecated
public abstract class LoggerAdapter extends Logger {
/**
* The pattern to use for detecting {@link MessageFormat}.
diff --git a/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerFactory.java b/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerFactory.java
index 7bdddfd..fcb43b9 100644
--- a/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerFactory.java
+++ b/core/sis-utility/src/main/java/org/apache/sis/util/logging/LoggerFactory.java
@@ -52,7 +52,11 @@ import org.apache.sis.util.collection.WeakValueHashMap;
*
* @since 0.3
* @module
+ *
+ * @deprecated Will be removed since there is now other mechanisms for redirecting logging.
+ * See <a href="https://issues.apache.org/jira/browse/SIS-531">SIS-531</a>.
*/
+@Deprecated
public abstract class LoggerFactory<L> {
/**
* The logger class. We ask for this information right at construction time in order to
diff --git a/core/sis-utility/src/main/java/org/apache/sis/util/logging/Logging.java b/core/sis-utility/src/main/java/org/apache/sis/util/logging/Logging.java
index 45ec9fe..014e41a 100644
--- a/core/sis-utility/src/main/java/org/apache/sis/util/logging/Logging.java
+++ b/core/sis-utility/src/main/java/org/apache/sis/util/logging/Logging.java
@@ -152,7 +152,11 @@ public final class Logging extends Static {
*
* @param name the logger name.
* @return a logger for the specified name.
+ *
+ * @deprecated Use the standard {@link Logger#getLogger(String)} method instead.
+ * See <a href="https://issues.apache.org/jira/browse/SIS-531">SIS-531</a>.
*/
+ @Deprecated
public static Logger getLogger(final String name) {
ArgumentChecks.ensureNonNull("name", name);
final LoggerFactory<?> factory = Logging.factory;