[slf4j-dev] svn commit: r809 - in slf4j/trunk: slf4j-archetype/src/main/resources/META-INF/maven slf4j-archetype/src/main/resources/archetype-resources/src/main/java slf4j-site/src/site/pages slf4j-site/src/site/pages/templates
ceki at slf4j.org
ceki at slf4j.org
Wed May 16 23:38:00 CEST 2007
Author: ceki
Date: Wed May 16 23:38:00 2007
New Revision: 809
Removed:
slf4j/trunk/slf4j-archetype/src/main/resources/archetype-resources/src/main/java/LoggerFactory.java
slf4j/trunk/slf4j-archetype/src/main/resources/archetype-resources/src/main/java/MarkerFactory.java
Modified:
slf4j/trunk/slf4j-archetype/src/main/resources/META-INF/maven/archetype.xml
slf4j/trunk/slf4j-site/src/site/pages/codes.html
slf4j/trunk/slf4j-site/src/site/pages/faq.html
slf4j/trunk/slf4j-site/src/site/pages/index.html
slf4j/trunk/slf4j-site/src/site/pages/news.html
slf4j/trunk/slf4j-site/src/site/pages/templates/right.js
Log:
- updating slf4j-archetype/pom.xml to match latest changes
- doc enhancements
Modified: slf4j/trunk/slf4j-archetype/src/main/resources/META-INF/maven/archetype.xml
==============================================================================
--- slf4j/trunk/slf4j-archetype/src/main/resources/META-INF/maven/archetype.xml (original)
+++ slf4j/trunk/slf4j-archetype/src/main/resources/META-INF/maven/archetype.xml Wed May 16 23:38:00 2007
@@ -2,10 +2,9 @@
<archetype>
<id>slf4j-archetype</id>
<sources>
- <source>src/main/java/LoggerFactory.java</source>
- <source>src/main/java/MarkerFactory.java</source>
<source>src/main/java/impl/StaticLoggerBinder.java</source>
<source>src/main/java/impl/StaticMarkerBinder.java</source>
+ <source>src/main/java/impl/*.java</source>
</sources>
<testSources>
<source>src/test/java/InvocationTest.java</source>
Modified: slf4j/trunk/slf4j-site/src/site/pages/codes.html
==============================================================================
--- slf4j/trunk/slf4j-site/src/site/pages/codes.html (original)
+++ slf4j/trunk/slf4j-site/src/site/pages/codes.html Wed May 16 23:38:00 2007
@@ -69,10 +69,26 @@
appropriate SLF4J binding could be found. Placing one of
<em>slf4j-nop.jar</em>, <em>slf4j-simple.jar</em>,
<em>slf4j-log4j12.jar</em>, <em>slf4j-jdk14.jar</em> or
- <em>logback-classic.jar</em> should prove to be an effective
- remedy.
+ <em>logback-classic.jar</em> on the class path should prove to be
+ an effective remedy.
</p>
+ <a name="StaticLoggerBinder">
+ </a>
+
+ <h3>Failed to load class
+ <code>org.slf4j.impl.StaticLoggerBinder</code></h3>
+
+ <p>This error is reported when the
+ <code>org.slf4j.impl.StaticLoggerBinder</code> class could not be
+ loaded into memory. This happens when no appropriate SLF4J
+ binding could be found on the class path. Placing one of
+ <em>slf4j-nop.jar</em>, <em>slf4j-simple.jar</em>,
+ <em>slf4j-log4j12.jar</em>, <em>slf4j-jdk14.jar</em> or
+ <em>logback-classic.jar</em> on the class path should solve the
+ problem.
+ </p>
+
</div>
</body>
Modified: slf4j/trunk/slf4j-site/src/site/pages/faq.html
==============================================================================
--- slf4j/trunk/slf4j-site/src/site/pages/faq.html (original)
+++ slf4j/trunk/slf4j-site/src/site/pages/faq.html Wed May 16 23:38:00 2007
@@ -25,67 +25,90 @@
<ol type="1">
<li><a href="#what_is">What is SLF4J?</a></li>
-
+
<li><a href="#when">When should SLF4J be used?</a></li>
<li><a href="#yet_another_facade"> Is SLF4J yet another loggingfacade?</a></li>
+
+ <li>
+ <a href="#why_new_project"> If SLF4J fixes JCL, then why
+ wasn't the fix made in JCL instead of creating a new project?
+ </a>
+ </li>
- <li><a href="#why_new_project"> If SLF4J fixes JCL, then why
- wasn't the fix made in JCL instead of creating a new project?
- </a></li>
-
- <li><a href="#need_to_recompile"> When using SLF4J, do I have to
- recompile my application to switch to a different logging
- system? </a></li>
+ <li>
+ <a href="#need_to_recompile"> When using SLF4J, do I have to
+ recompile my application to switch to a different logging
+ system?
+ </a>
+ </li>
<li><a href="#requirements">What are SLF4J's requirements?</a></li>
- <li><a href="#license">Why is SLF4J licensed under X11 type
- license instead of the Apache Software License? </a></li>
+ <li>
+ <a href="#license">Why is SLF4J licensed under X11 type
+ license instead of the Apache Software License?
+ </a>
+ </li>
- <li><a href="#where_is_binding">Where can I get a particular
- SLF4J binding? </a></li>
+ <li>
+ <a href="#where_is_binding">Where can I get a particular
+ SLF4J binding?
+ </a>
+ </li>
- <li><a href="#configure_logging">Should my library attempt to
- configure logging?
- </a>
+ <li>
+ <a href="#configure_logging">Should my library attempt to
+ configure logging?
+ </a>
</li>
- <li><a href="#maven2">What about Maven 2 transitive
- dependencies?
- </a>
+ <li>
+ <a href="#maven2">What about Maven 2 transitive
+ dependencies?
+ </a>
</li>
</ol>
- <b>About the SLF4J API</b>
-
- <ol type="1">
-
- <li><a href="#string_or_object"> Why don't the printing methods
- in the Logger interface accept message of type Object, but only
- messages of type String? </a></li>
+ <b>About the SLF4J API</b>
+
+ <ol type="1">
+
+ <li>
+ <a href="#string_or_object"> Why don't the printing methods
+ in the Logger interface accept message of type Object, but only
+ messages of type String?
+ </a>
+ </li>
- <li><a href="#exception_message">
- Can I log an exception without an accompanying message?
- </a></li>
+ <li>
+ <a href="#exception_message">
+ Can I log an exception without an accompanying message?
+ </a>
+ </li>
- <li><a href="#logging_performance"> What is the fastest way of
- (not) logging? </a></li>
+ <li>
+ <a href="#logging_performance"> What is the fastest way of
+ (not) logging?
+ </a>
+ </li>
- <li><a href="#string_contents"> How can I log the string
- contents of a single (possibly complex) object? </a></li>
+ <li>
+ <a href="#string_contents"> How can I log the string contents
+ of a single (possibly complex) object?
+ </a>
+ </li>
<li><a href="#fatal"> Why doesn't the
<code>org.slf4j.Logger</code> interface have methods for the
FATAL level? </a></li>
- <li><a href="#trace"> Why doesn't the
- <code>org.slf4j.Logger</code> interface have methods for the
- TRACE level? </a></li></ol>
+ <li><a href="#trace">Why was the TRACE level introduced only in
+ SLF4J version 1.4.0? </a></li></ol>
<b>Implementing the SLF4J API</b>
@@ -385,7 +408,7 @@
<p class="source"><dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
- <version>1.3.0</version>
+ <version>${project.version}</version>
</dependency></p>
<p> </p>
@@ -399,7 +422,7 @@
<p class="source"><dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
- <version>1.3.0</version>
+ <version>${project.version}</version>
<b><scope>test</scope></b>
</dependency></p>
@@ -663,39 +686,78 @@
meriting close attention, we are inclined to believe that the
FATAL level is superfluous.
</p>
- <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr /></dd><dt><a name="trace">
- Why doesn't the <code>org.slf4j.Logger</code> interface
- have methods for the TRACE level?
- </a></dt><dd>
+
+ <table border="0">
+ <tr>
+ <td align="right">
+ <a href="#top">[top]</a>
+ </td>
+ </tr>
+ </table>
+
+ <hr />
+ </dd>
+
+ <dt>
+ <a name="trace">Why was the TRACE level introduced only in
+ SLF4J version 1.4.0?
+ </a>
+ </dt>
+
+ <dd>
<p>The addition of the TRACE level has been frequently and
- hotly debated request. By studying various projects, it looks
- like the TRACE level is mostly used to disable logging output
- from certain classes without needing to configure logging for
- those classes. Indeed, the TRACE level is by default disabled
- in log4j and other logging systems. We believe that the same
- result could be achieved by adding the appropriate directives
- in configuration files.
- </p>
+ hotly debated request. By studying various projects, we
+ observed that the TRACE level was used to disable logging
+ output from certain classes <em>without</em> needing to
+ configure logging for those classes. Indeed, the TRACE level
+ is by default disabled in log4j and logback as well most other
+ logging systems. The same result can be achieved by adding the
+ appropriate directives in configuration files.
+ </p>
- <p>Thus, in the majority of cases the TRACE level has the same
- semantic meaning as DEBUG. In such case, the TRACE level
- merely saves a few configuration directives. In the rare but
- interesting cases where TRACE has a different meaning than
- DEBUG, <a href="api/org/slf4j/Marker.html">Marker</a> objects
- can be put to use to convey the desired new meaning.
- </p>
+ <p>Thus, in many of cases the TRACE level carried the same
+ semantic meaning as DEBUG. In such cases, the TRACE level
+ merely saves a few configuration directives. In other, more
+ interesting occasions, where TRACE carries a different meaning
+ than DEBUG, <a href="api/org/slf4j/Marker.html">Marker</a>
+ objects can be put to use to convey the desired
+ meaning. However, if you can't be bothered with markers and
+ wish to use a logging level lower than DEBUG, the TRACE level
+ can get the job done.
+ </p>
+
+ <p>Note that while the cost of evaluating a disabled log
+ request is in the order of a few <code>nanoseconds</code>, the
+ use of the TRACE level (or any other level for that matter) is
+ discouraged in tight loops where the log request might be
+ evaluated millions of times. If the log request is enabled,
+ then it will overwhelm the target destination with massive
+ output. If the request is disabled, it will waste resources.
+ </p>
- <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table>
+ <p>In short, although we still discourage the use of the TRACE
+ level because alternatives exist or because in many cases log
+ requests of level TRACE are wasteful, given that people kept
+ asking for it, we decided to bow to popular demand.
+ </p>
- </dd>
- </dl>
- </div>
+ <table border="0">
+ <tr>
+ <td align="right">
+ <a href="#top">[top]</a>
+ </td>
+ </tr>
+ </table>
+
+ </dd>
+ </dl>
+ </div>
- <div class="section">
+ <div class="section">
- <h2>Implementing the SLF4J API</h2><dl><dt><a name="slf4j_compatible">
+ <h2>Implementing the SLF4J API</h2><dl><dt><a name="slf4j_compatible">
How do I make my logging framework SLF4J
compatible?
</a>
Modified: slf4j/trunk/slf4j-site/src/site/pages/index.html
==============================================================================
--- slf4j/trunk/slf4j-site/src/site/pages/index.html (original)
+++ slf4j/trunk/slf4j-site/src/site/pages/index.html Wed May 16 23:38:00 2007
@@ -31,11 +31,11 @@
</p>
<p>Logging API implementations can either choose to implement the
- the SLF4J interfaces directly, e.g. <a
+ the SLF4J interfaces directly, à la <a
href="http://logback.qos.ch">logback</a> or <a
href="api/org/slf4j/impl/SimpleLogger.html">SimpleLogger</a>. Alternatively,
- it is possible (and rather easy) to write SLF4J adapters for the
- given API implementation, e.g. <a
+ it is possible (and rather easy) to write SLF4J adapters for a given
+ API implementation, e.g. <a
href="api/org/slf4j/impl/Log4jLoggerAdapter.html">Log4jLoggerAdapter</a>
or <a
href="api/org/slf4j/impl/JDK14LoggerAdapter.html">JDK14LoggerAdapter</a>..
@@ -74,27 +74,38 @@
<table border="0">
<tr>
- <td>
+ <td valign="top">
<ul>
<li><a href="http://directory.apache.org/">Apache Directory</a></li>
+ <li><a href="http://incubator.apache.org/ftpserver/">Apache FTPServer</a></li>
<li><a href="http://incubator.apache.org/graffito/">Apache Graffito</a></li>
<li><a href=" http://jackrabbit.apache.org/">Apache Jackrabbit</a></li>
<li><a href="http://mina.apache.org/">Apache Mina</a></li>
- <li><a href="http://incubator.apache.org/wicket/">Apache Wicket 2.0</a></li>
+ <li><a href="http://incubator.apache.org/wicket/">Apache Wicket</a></li>
<li><a href="http://apogee.nuxeo.org/">Apogee</a></li>
<li><a href="http://www.bitronix.be/">Bitronix</a></li>
- <li><a href="http://ha-jdbc.sourceforge.net/">HA-JDBC: High-Availability JDBC</a></li>
- <li><a href="http://jetty.mortbay.org/">Jetty v6</a></li>
- <li><a href="http://www.topmind.biz/html/index.php">jLynx</a></li>
+ <li><a href="http://ha-jdbc.sourceforge.net/">HA-JDBC: High-Availability JDBC</a></li>
</ul>
</td>
- <td>
+
+ <td valign="top">
<ul>
+ <li><a href="http://jetty.mortbay.org/">Jetty v6</a></li>
+ <li><a href="http://www.topmind.biz/html/index.php">jLynx</a></li>
+ <li><a href="http://code.google.com/p/jmesa/">JMesa</a></li>
<li><a href="http://jwebunit.sourceforge.net/2.x/">JWebUnit 2.x</a></li>
<li><a href="http://www.liferay.com/web/guest/home">LIFERAY</a></li>
- <li><a href="http://mule.codehaus.org/display/MULE/Home">Mule</a></li>
+ <li><a href="http://mule.codehaus.org/display/MULE/Home">Mule</a></li>
<li><a href="http://www.unidata.ucar.edu/software/netcdf-java/">NetCDF</a></li>
<li><a href="http://proximity.abstracthorizon.org/index.html">Proximity</a></li>
+ <li><a href="http://pzfilereader.sourceforge.net/">PZFileReader</a></li>
+
+ </ul>
+
+ </td>
+
+ <td valign="top">
+ <ul>
<li><a href="http://www.quickfixj.org/">QuickFIX/J</a></li>
<li><a href="http://www.restlet.org/about/">Restlet</a></li>
<li><a href="http://smsj.sourceforge.net/dependencies.html">SMSJ</a></li>
@@ -102,6 +113,7 @@
<li><a href="http://yaslibrary.sourceforge.net/index.shtml">YASL</a></li>
</ul>
</td>
+
</tr>
</table>
</div>
Modified: slf4j/trunk/slf4j-site/src/site/pages/news.html
==============================================================================
--- slf4j/trunk/slf4j-site/src/site/pages/news.html (original)
+++ slf4j/trunk/slf4j-site/src/site/pages/news.html Wed May 16 23:38:00 2007
@@ -28,6 +28,16 @@
announce</a> mailing list.
</p>
+ <hr noshade="noshade" size="1"/>
+
+ <h3>May 16th, 2007 - Release of SLF4J 1.4.0</h3>
+
+
+ <p>In response to many user requests over time, the TRACE level has
+ been added to <a href="">org.slf4j.Logger</a> interface. Please also
+ see the <a href="">FAQ entry discussing</a> the TRACE level.
+ </p>
+
<hr noshade="noshade" size="1"/>
Modified: slf4j/trunk/slf4j-site/src/site/pages/templates/right.js
==============================================================================
--- slf4j/trunk/slf4j-site/src/site/pages/templates/right.js (original)
+++ slf4j/trunk/slf4j-site/src/site/pages/templates/right.js Wed May 16 23:38:00 2007
@@ -1,6 +1,11 @@
document.write('<p class="menu_header">SLF4J-related buzz</p>');
+http://blog.lukas-vlcek.com/2007/05/jakarta-commons-logging-and-slf4j.html
+
+document.write('<p class="rm small"><a href="http://blog.lukas-vlcek.com/2007/05/jakarta-commons-logging-and-slf4j.html">JCL and SLF4J</a>');
+document.write('</p>');
+
document.write('<p class="rm small"><a href="http://hohonuuli.blogspot.com/2007/04/sl4j-code-template-for-netbeans-i-use.html">Code Template for Netbeans</a>');
document.write('</p>');
More information about the slf4j-dev
mailing list