diff --git a/buildScripts/website.ant.xml b/buildScripts/website.ant.xml index 73700a82..6ab8d509 100644 --- a/buildScripts/website.ant.xml +++ b/buildScripts/website.ant.xml @@ -132,6 +132,9 @@ such as converting the changelog into HTML, and creating javadoc. + + + diff --git a/usage_examples/LogExample_post.jpage b/usage_examples/LogExample_post.jpage new file mode 100644 index 00000000..cbdc5a9e --- /dev/null +++ b/usage_examples/LogExample_post.jpage @@ -0,0 +1,15 @@ +public class LogExample { + private static final org.slf4j.Logger log = org.slf4j.LoggerFactory.getLogger(LogExample.class); + + public static void main(String... args) { + log.error("Something's wrong here"); + } +} + +public class LogExampleOther { + private static final org.slf4j.Logger log = org.slf4j.LoggerFactory.getLogger(java.util.List.class); + + public static void main(String... args) { + log.warn("Something might be wrong here"); + } +} diff --git a/usage_examples/LogExample_pre.jpage b/usage_examples/LogExample_pre.jpage new file mode 100644 index 00000000..450a6a34 --- /dev/null +++ b/usage_examples/LogExample_pre.jpage @@ -0,0 +1,17 @@ +import lombok.slf4j.Log; + +@Log +public class LogExample { + + public static void main(String... args) { + log.error("Something's wrong here"); + } +} + +@Log(java.util.List.class) +public class LogExampleOther { + + public static void main(String... args) { + log.warn("Something might be wrong here"); + } +} diff --git a/website/features/Log.html b/website/features/Log.html new file mode 100644 index 00000000..45beca77 --- /dev/null +++ b/website/features/Log.html @@ -0,0 +1,76 @@ + + + + + + + + @Log +
+
+
+
Project Lombok
+

@Log

+
Captain's Log, stardate 24435.7: "What was that line again?"
+
+

Overview

+

+ You can annotate any field with @Log to let lombok generate a logger field automatically.
+ The logger is named log and field's type depends on which logger you have selected. +

+ There are four @Log choices available:
+

+
@lombok.commons.Log
+
Creates private static final org.apache.commons.logging.Log log = org.apache.commons.logging.LogFactory.getLog(TargetType.class);
+
@lombok.jul.Log
+
Creates private static final java.util.logging.Logger log = java.util.logging.Logger.getLogger(TargetType.class.getName());
+
@lombok.log4j.Log
+
Creates private static final org.apache.log4j.Logger log = org.apache.log4j.Logger.getLogger(TargetType.class);
+
@lombok.slf4j.Log
+
Creates private static final org.slf4j.Logger log = org.slf4j.LoggerFactory.getLogger(TargetType.class);
+
+

+

+ All @Log annotations can take an optional parameter of type Class. If such a parameter is specified, that class will be used as the parameter for the logger factory call. +

+
+
+
+

With Lombok

+
@HTML_PRE@
+
+
+
+

Vanilla Java

+
@HTML_POST@
+
+
+
+
+

Small print

+

+ If a field called log already exists, a warning will be emitted and no code will be generated. +

+

+ Although it is possible to specify any class literal to pass to the logger factory method, passing void.class will be considered to be the same as specifying no parameter. +

+
+
+
+ Back to features | Previous feature (@SneakyThrows) | Next feature
+ credits | Copyright © 2009-2010 Reinier Zwitserloot, Roel Spilker and Robbert Jan Grootjans, licensed under the MIT license. +
+
+
+
+ + + diff --git a/website/features/SneakyThrows.html b/website/features/SneakyThrows.html index ec7d09c5..0781f083 100644 --- a/website/features/SneakyThrows.html +++ b/website/features/SneakyThrows.html @@ -71,7 +71,7 @@
- Back to features | Previous feature (@Synchronized) | Next feature
+ Back to features | Previous feature (@Synchronized) | Next feature (@Log)
credits | Copyright © 2009 Reinier Zwitserloot and Roel Spilker, licensed under the MIT license.
diff --git a/website/features/features.css b/website/features/features.css index 5de41654..a7e8e318 100644 --- a/website/features/features.css +++ b/website/features/features.css @@ -64,6 +64,15 @@ h1 { margin-left: 32px; } +dt { + margin-top: 4px; + font-size: 1.2em; +} + +dd { + margin-left: 16px; +} + .overview code { font-size: 1.1em; } @@ -138,3 +147,23 @@ h1 { font-style: normal; font-weight: bold; } + +code a { + color: black; + text-decoration: none; +} + +code a:hover { + color: black; + text-decoration: underline; +} + +code .keyword { + color: #7f0055; + font-weight: bold; +} + +code .staticfield { + color: #2a00ff; + font-style: italic; +} \ No newline at end of file diff --git a/website/features/index.html b/website/features/index.html index 869bbe89..d216ddb4 100644 --- a/website/features/index.html +++ b/website/features/index.html @@ -30,6 +30,8 @@
synchronized done right: Don't expose your locks.
@SneakyThrows
To boldly throw checked exceptions where no one has thrown them before!
+
@Log
+
Captain's Log, stardate 24435.7: "What was that line again?"