@@ -96,30 +96,37 @@ public interface Logger {
96
96
public String getName ();
97
97
98
98
/**
99
- * Make a new {@link LoggingEventBuilder} instance as appropriate for this logger and the
100
- * desired {@link Level} passed as parameter. If this Logger is disabled for the given Level, then
101
- * a {@link NOPLoggingEventBuilder} is returned.
102
- *
103
- *
99
+ * <p>Make a new {@link LoggingEventBuilder} instance as appropriate for this logger implementation.
100
+ * The default implementation returns an instance of {@link DefaultLoggingEventBuilder}.</p>
101
+ *
102
+ * <p>Note that the {@link LoggingEventBuilder} should be built for all levels, independently of the level.
103
+ * In other words, this method is an <b>unconditional</b> constructor for the {@link LoggingEventBuilder}
104
+ * appropriate for this logger implementation.</p>
105
+ *
104
106
* @param level desired level for the event builder
105
107
* @return a new {@link LoggingEventBuilder} instance as appropriate for this logger
106
108
* @since 2.0
107
109
*/
108
110
default public LoggingEventBuilder makeLoggingEventBuilder (Level level ) {
109
- if (isEnabledForLevel (level )) {
110
- return new DefaultLoggingEventBuilder (this , level );
111
- } else {
112
- return NOPLoggingEventBuilder .singleton ();
113
- }
111
+ return new DefaultLoggingEventBuilder (this , level );
114
112
}
115
113
116
114
/**
117
- * A convenient alias for {@link #makeLoggingEventBuilder}.
118
- *
115
+ * Make a new {@link LoggingEventBuilder} instance as appropriate for this logger and the
116
+ * desired {@link Level} passed as parameter. If this Logger is disabled for the given Level, then
117
+ * a {@link NOPLoggingEventBuilder} is returned.
118
+ *
119
+ *
120
+ * @param level desired level for the event builder
121
+ * @return a new {@link LoggingEventBuilder} instance as appropriate for this logger
119
122
* @since 2.0
120
123
*/
121
124
default public LoggingEventBuilder atLevel (Level level ) {
122
- return makeLoggingEventBuilder (level );
125
+ if (isEnabledForLevel (level )) {
126
+ return makeLoggingEventBuilder (level );
127
+ } else {
128
+ return NOPLoggingEventBuilder .singleton ();
129
+ }
123
130
}
124
131
125
132
0 commit comments