[slf4j-dev] branch, master, updated. v1.5.9-RC0-2-g7e1d1bb
added by portage for gitosis-gentoo
git-noreply at pixie.qos.ch
Sun Sep 13 17:53:54 CEST 2009
The branch, master has been updated
via 7e1d1bb7e1200d9233e1c5c622cde6415ab41b42 (commit)
from c9abde8243fd4a77b418383b11ff3279fb236d53 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://git.qos.ch/gitweb/?p=slf4j.git;a=commit;h=7e1d1bb7e1200d9233e1c5c622cde6415ab41b42
http://github.com/ceki/slf4j/commit/7e1d1bb7e1200d9233e1c5c622cde6415ab41b42
commit 7e1d1bb7e1200d9233e1c5c622cde6415ab41b42
Author: Ceki Gulcu <ceki at qos.ch>
Date: Sun Sep 13 17:50:10 2009 +0200
- added blurb about MessageFormatter performance compred to JDK's MessageFormat
- added link to article on "Logging with SLF4J and Guice" by Michael
Glauche
diff --git a/slf4j-api/src/main/java/org/slf4j/helpers/MessageFormatter.java b/slf4j-api/src/main/java/org/slf4j/helpers/MessageFormatter.java
index 81ecc46..c41ae9a 100644
--- a/slf4j-api/src/main/java/org/slf4j/helpers/MessageFormatter.java
+++ b/slf4j-api/src/main/java/org/slf4j/helpers/MessageFormatter.java
@@ -24,6 +24,7 @@
package org.slf4j.helpers;
+import java.text.MessageFormat;
import java.util.HashMap;
import java.util.Map;
@@ -32,6 +33,7 @@ import java.util.Map;
/**
* Formats messages according to very simple substitution rules. Substitutions
* can be made 1, 2 or more arguments.
+ *
* <p>
* For example,
*
@@ -41,9 +43,9 @@ import java.util.Map;
*
* will return the string "Hi there.".
* <p>
- * The {} pair is called the <em>formatting anchor</em>. It serves to
- * designate the location where arguments need to be substituted within the
- * message pattern.
+ * The {} pair is called the <em>formatting anchor</em>. It serves to designate
+ * the location where arguments need to be substituted within the message
+ * pattern.
* <p>
* In case your message contains the '{' or the '}' character, you do not have
* to do anything special unless the '}' character immediately follows '{'. For
@@ -62,16 +64,13 @@ import java.util.Map;
* character should be escaped. There is no need to escape the '}' character.
* For example,
*
- * <pre>
- * MessageFormatter.format("Set \\{} is not equal to {}.", "1,2");
- * </pre>
+ * <pre>MessageFormatter.format("Set \\{} is not equal to {}.", "1,2");</pre>
*
* will return the string "Set {} is not equal to 1,2.".
*
* <p>
* The escaping behavior just described can be overridden by escaping the escape
* character '\'. Calling
- *
* <pre>
* MessageFormatter.format("File name is C:\\\\{}.", "file.zip");
* </pre>
@@ -79,8 +78,16 @@ import java.util.Map;
* will return the string "File name is C:\file.zip".
*
* <p>
- * See {@link #format(String, Object)}, {@link #format(String, Object, Object)}
- * and {@link #arrayFormat(String, Object[])} methods for more details.
+ * The formatting conventions are different than those of {@link MessageFormat}
+ * which ships with the Java platform. This is justified by the fact that
+ * SLF4J's implementation is 10 times faster than that of {@link MessageFormat}.
+ * This local performance difference is both measurable and significant in the
+ * larger context of the complete logging processing chain.
+ *
+ * <p>
+ * See also {@link #format(String, Object)},
+ * {@link #format(String, Object, Object)} and
+ * {@link #arrayFormat(String, Object[])} methods for more details.
*
* @author Ceki Gülcü
*/
@@ -104,10 +111,9 @@ final public class MessageFormatter {
* <p>
*
* @param messagePattern
- * The message pattern which will be parsed and formatted
+ * The message pattern which will be parsed and formatted
* @param argument
- * The argument to be substituted in place of the formatting
- * anchor
+ * The argument to be substituted in place of the formatting anchor
* @return The formatted message
*/
final public static String format(String messagePattern, Object arg) {
@@ -128,13 +134,13 @@ final public class MessageFormatter {
* will return the string "Hi Alice. My name is Bob.".
*
* @param messagePattern
- * The message pattern which will be parsed and formatted
+ * The message pattern which will be parsed and formatted
* @param arg1
- * The argument to be substituted in place of the first
- * formatting anchor
+ * The argument to be substituted in place of the first formatting
+ * anchor
* @param arg2
- * The argument to be substituted in place of the second
- * formatting anchor
+ * The argument to be substituted in place of the second formatting
+ * anchor
* @return The formatted message
*/
final public static String format(final String messagePattern, Object arg1,
@@ -148,10 +154,10 @@ final public class MessageFormatter {
* arguments can be passed in an array.
*
* @param messagePattern
- * The message pattern which will be parsed and formatted
+ * The message pattern which will be parsed and formatted
* @param argArray
- * An array of arguments to be substituted in place of
- * formatting anchors
+ * An array of arguments to be substituted in place of formatting
+ * anchors
* @return The formatted message
*/
final public static String arrayFormat(final String messagePattern,
@@ -269,8 +275,10 @@ final public class MessageFormatter {
try {
String oAsString = o.toString();
sbuf.append(oAsString);
- } catch( Throwable t) {
- System.err.println("SLF4J: Failed toString() invocation on an object of type ["+o.getClass().getName()+"]");
+ } catch (Throwable t) {
+ System.err
+ .println("SLF4J: Failed toString() invocation on an object of type ["
+ + o.getClass().getName() + "]");
t.printStackTrace();
sbuf.append("[FAILED toString()]");
}
diff --git a/slf4j-site/src/site/pages/docs.html b/slf4j-site/src/site/pages/docs.html
index 989b1ca..52a3020 100644
--- a/slf4j-site/src/site/pages/docs.html
+++ b/slf4j-site/src/site/pages/docs.html
@@ -49,6 +49,12 @@
Logger Plug-ins for RCP Applications</a>, by John J. Franey
</li>
+
+ <li><a
+ href="http://glauche.de/2009/08/24/logging-with-slf4j-and-guice/">Logging
+ with SLF4J and Guice</a>, by Michael Glauche
+ </li>
+
<li>
<a href="slf4j-in-10-slides.ppt">SLF4J in 10 slides</a>, by Ceki Gülcü
</li>
@@ -76,6 +82,7 @@
href="http://bsnyderblog.blogspot.com/2007/08/my-soapbox-for-slf4j.html">My
Soapbox for SLF4J</a>, by Bruce Snyder
</li>
+
</ul>
-----------------------------------------------------------------------
Summary of changes:
.../java/org/slf4j/helpers/MessageFormatter.java | 52 +++++++++++--------
slf4j-site/src/site/pages/docs.html | 7 +++
2 files changed, 37 insertions(+), 22 deletions(-)
hooks/post-receive
--
SLF4J: Simple Logging Facade for Java
More information about the slf4j-dev
mailing list