diff --git a/slf4j-site/src/site/pages/faq.html b/slf4j-site/src/site/pages/faq.html index 3bbf0cd6..7d7a226e 100755 --- a/slf4j-site/src/site/pages/faq.html +++ b/slf4j-site/src/site/pages/faq.html @@ -50,7 +50,7 @@
Applicable to 2.x Note that the - 2.0.x series builds upon the 1.8.x series, as such the remarks - below are applicable to SLF4J 2.x as well.
- -There are no client facing API changes in 1.8.x. For most - users upgrading to version 1.8.x should be a drop-in replacement + +
There are no client facing API changes in 2.0.x. For most + users upgrading to version 2.0..x should be a drop-in replacement as long as the logging provider is updated as well.
-In version 1.8.0, SLF4J has been modularized per In version 2.0.0, SLF4J has been modularized per JPMS/Jigsaw - specificaton. Moreover, slf4j-api now relies on the JMPS module names are listed + in another FAQ entry.
+ +More visibly, slf4j-api now relies on the ServiceLoader
- mechanism to find its logging backend. Earlier versions relied
- on the static binder mechanism which is no loger honored by
- slf4j-api version 1.8.x. More specifically, when initializing
- the LoggerFactory class will no longer search for
- the StaticLoggerBinder class on the class path.
LoggerFactory class will no longer
+ search for the StaticLoggerBinder class on the
+ class path.
Instead of "bindings" now
org.slf4j.LoggerFactory searches for
"providers". These ship for example with
- slf4j-nop-1.8.x.jar, slf4j-simple-1.8.x.jar or
- slf4j-jdk14-1.8.x.jar.
+ slf4j-nop-2.0.x.jar, slf4j-simple-2.0.x.jar or
+ slf4j-jdk14-2.0.x.jar.
The following table describes the results when various @@ -402,26 +410,26 @@
StaticLoggerBindingAlthough compatible with Java 8, SLF4J version 2.0 supports + JMPS modularisation as introduced in Java 9. Here are the JMPS + module names for the various artificats shipping in SLF4J.
+ +| artifact name | +JMPS module name | +
|---|---|
| slf4j-api.jar | +org.slf4j | +
| slf4j-simple.jar | +org.slf4j.simple | +
| slf4j-jdk14.jar | +org.slf4j.jul | +
| slf4j-nop.jar | +org.slf4j.nop | +
| jcl-over-slf4j.jar | +org.apache.commons.logging | +
| log4j-over-slf4j.jar | +log4j | +
since 2.0.0 SLF4J API version 2.0.0 - requires Java 8 and introduces a backward-compatible fluent logging - API. By backward-compatible, we mean that existing logging + requires Java 8 and introduces a backward-compatible fluent + logging API. By backward-compatible, we mean that existing logging frameworks do not have to be changed in order for the user to benefit from the fluent logging API.
+since 2.0.0 SLF4J API version 2.0.0 + relies on the ServiceLoader + mechanism to find its logging backend. See the relevant FAQ entry for more + details. +
+As customary in programming tradition, here is an example @@ -509,7 +517,6 @@ SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further detail a warning about the suspected mismatch.
-