You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@logging.apache.org by rp...@apache.org on 2016/05/19 15:16:14 UTC

logging-log4j2 git commit: LOG4J2-1293 clarify how custom Messages can be garbage-free

Repository: logging-log4j2
Updated Branches:
  refs/heads/master c73f49b31 -> 30d997d33


LOG4J2-1293 clarify how custom Messages can be garbage-free


Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo
Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/30d997d3
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/30d997d3
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/30d997d3

Branch: refs/heads/master
Commit: 30d997d33b208dcd9aabd82c2aa0ef0bc46903d1
Parents: c73f49b
Author: rpopma <rp...@apache.org>
Authored: Fri May 20 00:16:51 2016 +0900
Committer: rpopma <rp...@apache.org>
Committed: Fri May 20 00:16:51 2016 +0900

----------------------------------------------------------------------
 .../src/main/java/org/apache/logging/log4j/message/Message.java  | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/30d997d3/log4j-api/src/main/java/org/apache/logging/log4j/message/Message.java
----------------------------------------------------------------------
diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/message/Message.java b/log4j-api/src/main/java/org/apache/logging/log4j/message/Message.java
index 4f8be65..30d7aca 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/message/Message.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/message/Message.java
@@ -26,7 +26,9 @@ import org.apache.logging.log4j.util.StringBuilderFormattable;
  * at runtime such as the locale of the system.
  * <p>
  * Custom Message implementations should consider implementing the {@link StringBuilderFormattable}
- * interface for more efficient processing.
+ * interface for more efficient processing. Garbage-free Layouts will call
+ * {@link StringBuilderFormattable#formatTo(StringBuilder) formatTo(StringBuilder)} instead of
+ * {@link Message#getFormattedMessage()} if the Message implements StringBuilderFormattable.
  * </p>
  *<p>
  * Note: Message objects should not be considered to be thread safe nor should they be assumed to be