1 /*
2 * Licensed to the Apache Software Foundation (ASF) under one or more
3 * contributor license agreements. See the NOTICE file distributed with
4 * this work for additional information regarding copyright ownership.
5 * The ASF licenses this file to You under the Apache license, Version 2.0
6 * (the "License"); you may not use this file except in compliance with
7 * the License. You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the license for the specific language governing permissions and
15 * limitations under the license.
16 */
17 package org.apache.logging.log4j;
18
19 import org.apache.logging.log4j.message.EntryMessage;
20 import org.apache.logging.log4j.message.Message;
21 import org.apache.logging.log4j.message.MessageFactory;
22 import org.apache.logging.log4j.message.MessageFactory2;
23 import org.apache.logging.log4j.util.MessageSupplier;
24 import org.apache.logging.log4j.util.Supplier;
25
26 /**
27 * This is the central interface in the log4j package. Most logging operations, except configuration, are done through
28 * this interface.
29 *
30 * <p>
31 * The canonical way to obtain a Logger for a class is through {@link LogManager#getLogger()}. Typically, each class
32 * gets its own Logger named after its fully qualified class name (the default Logger name when obtained through the
33 * {@link LogManager#getLogger()} method). Thus, the simplest way to use this would be like so:
34 * </p>
35 *
36 * <pre>
37 * public class MyClass {
38 * private static final Logger LOGGER = LogManager.getLogger();
39 * // ...
40 * }
41 * </pre>
42 * <p>
43 * For ease of filtering, searching, sorting, etc., it is generally a good idea to create Loggers for each class rather
44 * than sharing Loggers. Instead, {@link Marker Markers} should be used for shared, filterable identification.
45 * </p>
46 * <p>
47 * For service provider implementations, it is recommended to extend the
48 * {@link org.apache.logging.log4j.spi.AbstractLogger} class rather than implementing this interface directly.
49 * </p>
50 *
51 * Since 2.4, methods have been added to the {@code Logger} interface to support lambda expressions. The new methods
52 * allow client code to lazily log messages without explicitly checking if the requested log level is enabled. For
53 * example, previously one would write:
54 *
55 * <pre>
56 * // pre-Java 8 style optimization: explicitly check the log level
57 * // to make sure the expensiveOperation() method is only called if necessary
58 * if (logger.isTraceEnabled()) {
59 * logger.trace("Some long-running operation returned {}", expensiveOperation());
60 * }
61 * </pre>
62 * <p>
63 * With Java 8, the same effect can be achieved with a lambda expression:
64 *
65 * <pre>
66 * // Java-8 style optimization: no need to explicitly check the log level:
67 * // the lambda expression is not evaluated if the TRACE level is not enabled
68 * logger.trace("Some long-running operation returned {}", () -> expensiveOperation());
69 * </pre>
70 *
71 * <p>
72 * Note that although {@link MessageSupplier} is provided, using {@link Supplier Supplier<Message>} works just the
73 * same. MessageSupplier was deprecated in 2.6 and un-deprecated in 2.8.1. Anonymous class usage of these APIs
74 * should prefer using Supplier instead.
75 * </p>
76 */
77 public interface Logger {
78
79 /**
80 * Logs an exception or error that has been caught to a specific logging level.
81 *
82 * @param level The logging Level.
83 * @param t The Throwable.
84 */
85 void catching(Level level, Throwable t);
86
87 /**
88 * Logs an exception or error that has been caught. Normally, one may wish to provide additional information with an
89 * exception while logging it; in these cases, one would not use this method. In other cases where simply logging
90 * the fact that an exception was swallowed somewhere (e.g., at the top of the stack trace in a {@code main()}
91 * method), this method is ideal for it.
92 *
93 * @param t The Throwable.
94 */
95 void catching(Throwable t);
96
97 /**
98 * Logs a message with the specific Marker at the {@link Level#DEBUG DEBUG} level.
99 *
100 * @param marker the marker data specific to this log statement
101 * @param msg the message string to be logged
102 */
103 void debug(Marker marker, Message msg);
104
105 /**
106 * Logs a message with the specific Marker at the {@link Level#DEBUG DEBUG} level.
107 *
108 * @param marker the marker data specific to this log statement
109 * @param msg the message string to be logged
110 * @param t A Throwable or null.
111 */
112 void debug(Marker marker, Message msg, Throwable t);
113
114 /**
115 * Logs a message which is only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level with
116 * the specified Marker. The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the
117 * {@code Message}.
118 *
119 * @param marker the marker data specific to this log statement
120 * @param msgSupplier A function, which when called, produces the desired log message.
121 * @since 2.4
122 */
123 void debug(Marker marker, MessageSupplier msgSupplier);
124
125 /**
126 * Logs a message (only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level) with the
127 * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. The
128 * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}.
129 *
130 * @param marker the marker data specific to this log statement
131 * @param msgSupplier A function, which when called, produces the desired log message.
132 * @param t A Throwable or null.
133 * @since 2.4
134 */
135 void debug(Marker marker, MessageSupplier msgSupplier, Throwable t);
136
137 /**
138 * Logs a message CharSequence with the {@link Level#DEBUG DEBUG} level.
139 *
140 * @param marker the marker data specific to this log statement
141 * @param message the message CharSequence to log.
142 */
143 void debug(Marker marker, CharSequence message);
144
145 /**
146 * Logs a message CharSequence at the {@link Level#DEBUG DEBUG} level including the stack trace of the
147 * {@link Throwable} <code>t</code> passed as parameter.
148 *
149 * @param marker the marker data specific to this log statement
150 * @param message the message CharSequence to log.
151 * @param t the exception to log, including its stack trace.
152 */
153 void debug(Marker marker, CharSequence message, Throwable t);
154
155 /**
156 * Logs a message object with the {@link Level#DEBUG DEBUG} level.
157 *
158 * @param marker the marker data specific to this log statement
159 * @param message the message object to log.
160 */
161 void debug(Marker marker, Object message);
162
163 /**
164 * Logs a message at the {@link Level#DEBUG DEBUG} level including the stack trace of the {@link Throwable}
165 * <code>t</code> passed as parameter.
166 *
167 * @param marker the marker data specific to this log statement
168 * @param message the message to log.
169 * @param t the exception to log, including its stack trace.
170 */
171 void debug(Marker marker, Object message, Throwable t);
172
173 /**
174 * Logs a message object with the {@link Level#DEBUG DEBUG} level.
175 *
176 * @param marker the marker data specific to this log statement
177 * @param message the message object to log.
178 */
179 void debug(Marker marker, String message);
180
181 /**
182 * Logs a message with parameters at the {@link Level#DEBUG DEBUG} level.
183 *
184 * @param marker the marker data specific to this log statement
185 * @param message the message to log; the format depends on the message factory.
186 * @param params parameters to the message.
187 * @see #getMessageFactory()
188 */
189 void debug(Marker marker, String message, Object... params);
190
191 /**
192 * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#DEBUG
193 * DEBUG} level.
194 *
195 * @param marker the marker data specific to this log statement
196 * @param message the message to log; the format depends on the message factory.
197 * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters.
198 * @since 2.4
199 */
200 void debug(Marker marker, String message, Supplier<?>... paramSuppliers);
201
202 /**
203 * Logs a message at the {@link Level#DEBUG DEBUG} level including the stack trace of the {@link Throwable}
204 * <code>t</code> passed as parameter.
205 *
206 * @param marker the marker data specific to this log statement
207 * @param message the message to log.
208 * @param t the exception to log, including its stack trace.
209 */
210 void debug(Marker marker, String message, Throwable t);
211
212 /**
213 * Logs a message which is only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level with
214 * the specified Marker.
215 *
216 * @param marker the marker data specific to this log statement
217 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
218 * message factory.
219 * @since 2.4
220 */
221 void debug(Marker marker, Supplier<?> msgSupplier);
222
223 /**
224 * Logs a message (only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level) with the
225 * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter.
226 *
227 * @param marker the marker data specific to this log statement
228 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
229 * message factory.
230 * @param t A Throwable or null.
231 * @since 2.4
232 */
233 void debug(Marker marker, Supplier<?> msgSupplier, Throwable t);
234
235 /**
236 * Logs a message with the specific Marker at the {@link Level#DEBUG DEBUG} level.
237 *
238 * @param msg the message string to be logged
239 */
240 void debug(Message msg);
241
242 /**
243 * Logs a message with the specific Marker at the {@link Level#DEBUG DEBUG} level.
244 *
245 * @param msg the message string to be logged
246 * @param t A Throwable or null.
247 */
248 void debug(Message msg, Throwable t);
249
250 /**
251 * Logs a message which is only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level. The
252 * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}.
253 *
254 * @param msgSupplier A function, which when called, produces the desired log message.
255 * @since 2.4
256 */
257 void debug(MessageSupplier msgSupplier);
258
259 /**
260 * Logs a message (only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level) including the
261 * stack trace of the {@link Throwable} <code>t</code> passed as parameter. The {@code MessageSupplier} may or may
262 * not use the {@link MessageFactory} to construct the {@code Message}.
263 *
264 * @param msgSupplier A function, which when called, produces the desired log message.
265 * @param t the exception to log, including its stack trace.
266 * @since 2.4
267 */
268 void debug(MessageSupplier msgSupplier, Throwable t);
269
270 /**
271 * Logs a message CharSequence with the {@link Level#DEBUG DEBUG} level.
272 *
273 * @param message the message object to log.
274 */
275 void debug(CharSequence message);
276
277 /**
278 * Logs a CharSequence at the {@link Level#DEBUG DEBUG} level including the stack trace of the {@link Throwable}
279 * <code>t</code> passed as parameter.
280 *
281 * @param message the message CharSequence to log.
282 * @param t the exception to log, including its stack trace.
283 */
284 void debug(CharSequence message, Throwable t);
285
286 /**
287 * Logs a message object with the {@link Level#DEBUG DEBUG} level.
288 *
289 * @param message the message object to log.
290 */
291 void debug(Object message);
292
293 /**
294 * Logs a message at the {@link Level#DEBUG DEBUG} level including the stack trace of the {@link Throwable}
295 * <code>t</code> passed as parameter.
296 *
297 * @param message the message to log.
298 * @param t the exception to log, including its stack trace.
299 */
300 void debug(Object message, Throwable t);
301
302 /**
303 * Logs a message object with the {@link Level#DEBUG DEBUG} level.
304 *
305 * @param message the message string to log.
306 */
307 void debug(String message);
308
309 /**
310 * Logs a message with parameters at the {@link Level#DEBUG DEBUG} level.
311 *
312 * @param message the message to log; the format depends on the message factory.
313 * @param params parameters to the message.
314 * @see #getMessageFactory()
315 */
316 void debug(String message, Object... params);
317
318 /**
319 * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#DEBUG
320 * DEBUG} level.
321 *
322 * @param message the message to log; the format depends on the message factory.
323 * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters.
324 * @since 2.4
325 */
326 void debug(String message, Supplier<?>... paramSuppliers);
327
328 /**
329 * Logs a message at the {@link Level#DEBUG DEBUG} level including the stack trace of the {@link Throwable}
330 * <code>t</code> passed as parameter.
331 *
332 * @param message the message to log.
333 * @param t the exception to log, including its stack trace.
334 */
335 void debug(String message, Throwable t);
336
337 /**
338 * Logs a message which is only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level.
339 *
340 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
341 * message factory.
342 * @since 2.4
343 */
344 void debug(Supplier<?> msgSupplier);
345
346 /**
347 * Logs a message (only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level) including the
348 * stack trace of the {@link Throwable} <code>t</code> passed as parameter.
349 *
350 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
351 * message factory.
352 * @param t the exception to log, including its stack trace.
353 * @since 2.4
354 */
355 void debug(Supplier<?> msgSupplier, Throwable t);
356
357 /**
358 * Logs a message with parameters at debug level.
359 *
360 * @param marker the marker data specific to this log statement
361 * @param message the message to log; the format depends on the message factory.
362 * @param p0 parameter to the message.
363 */
364 void debug(Marker marker, String message, Object p0);
365
366 /**
367 * Logs a message with parameters at debug level.
368 *
369 * @param marker the marker data specific to this log statement
370 * @param message the message to log; the format depends on the message factory.
371 * @param p0 parameter to the message.
372 * @param p1 parameter to the message.
373 */
374 void debug(Marker marker, String message, Object p0, Object p1);
375
376 /**
377 * Logs a message with parameters at debug level.
378 *
379 * @param marker the marker data specific to this log statement
380 * @param message the message to log; the format depends on the message factory.
381 * @param p0 parameter to the message.
382 * @param p1 parameter to the message.
383 * @param p2 parameter to the message.
384 */
385 void debug(Marker marker, String message, Object p0, Object p1, Object p2);
386
387 /**
388 * Logs a message with parameters at debug level.
389 *
390 * @param marker the marker data specific to this log statement
391 * @param message the message to log; the format depends on the message factory.
392 * @param p0 parameter to the message.
393 * @param p1 parameter to the message.
394 * @param p2 parameter to the message.
395 * @param p3 parameter to the message.
396 */
397 void debug(Marker marker, String message, Object p0, Object p1, Object p2, Object p3);
398
399 /**
400 * Logs a message with parameters at debug level.
401 *
402 * @param marker the marker data specific to this log statement
403 * @param message the message to log; the format depends on the message factory.
404 * @param p0 parameter to the message.
405 * @param p1 parameter to the message.
406 * @param p2 parameter to the message.
407 * @param p3 parameter to the message.
408 * @param p4 parameter to the message.
409 */
410 void debug(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4);
411
412 /**
413 * Logs a message with parameters at debug level.
414 *
415 * @param marker the marker data specific to this log statement
416 * @param message the message to log; the format depends on the message factory.
417 * @param p0 parameter to the message.
418 * @param p1 parameter to the message.
419 * @param p2 parameter to the message.
420 * @param p3 parameter to the message.
421 * @param p4 parameter to the message.
422 * @param p5 parameter to the message.
423 */
424 void debug(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5);
425
426 /**
427 * Logs a message with parameters at debug level.
428 *
429 * @param marker the marker data specific to this log statement
430 * @param message the message to log; the format depends on the message factory.
431 * @param p0 parameter to the message.
432 * @param p1 parameter to the message.
433 * @param p2 parameter to the message.
434 * @param p3 parameter to the message.
435 * @param p4 parameter to the message.
436 * @param p5 parameter to the message.
437 * @param p6 parameter to the message.
438 */
439 void debug(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5,
440 Object p6);
441
442 /**
443 * Logs a message with parameters at debug level.
444 *
445 * @param marker the marker data specific to this log statement
446 * @param message the message to log; the format depends on the message factory.
447 * @param p0 parameter to the message.
448 * @param p1 parameter to the message.
449 * @param p2 parameter to the message.
450 * @param p3 parameter to the message.
451 * @param p4 parameter to the message.
452 * @param p5 parameter to the message.
453 * @param p6 parameter to the message.
454 * @param p7 parameter to the message.
455 */
456 void debug(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
457 Object p7);
458
459 /**
460 * Logs a message with parameters at debug level.
461 *
462 * @param marker the marker data specific to this log statement
463 * @param message the message to log; the format depends on the message factory.
464 * @param p0 parameter to the message.
465 * @param p1 parameter to the message.
466 * @param p2 parameter to the message.
467 * @param p3 parameter to the message.
468 * @param p4 parameter to the message.
469 * @param p5 parameter to the message.
470 * @param p6 parameter to the message.
471 * @param p7 parameter to the message.
472 * @param p8 parameter to the message.
473 */
474 void debug(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
475 Object p7, Object p8);
476
477 /**
478 * Logs a message with parameters at debug level.
479 *
480 * @param marker the marker data specific to this log statement
481 * @param message the message to log; the format depends on the message factory.
482 * @param p0 parameter to the message.
483 * @param p1 parameter to the message.
484 * @param p2 parameter to the message.
485 * @param p3 parameter to the message.
486 * @param p4 parameter to the message.
487 * @param p5 parameter to the message.
488 * @param p6 parameter to the message.
489 * @param p7 parameter to the message.
490 * @param p8 parameter to the message.
491 * @param p9 parameter to the message.
492 */
493 void debug(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
494 Object p7, Object p8, Object p9);
495
496 /**
497 * Logs a message with parameters at debug level.
498 *
499 * @param message the message to log; the format depends on the message factory.
500 * @param p0 parameter to the message.
501 */
502 void debug(String message, Object p0);
503
504 /**
505 * Logs a message with parameters at debug level.
506 *
507 * @param message the message to log; the format depends on the message factory.
508 * @param p0 parameter to the message.
509 * @param p1 parameter to the message.
510 */
511 void debug(String message, Object p0, Object p1);
512
513 /**
514 * Logs a message with parameters at debug level.
515 *
516 * @param message the message to log; the format depends on the message factory.
517 * @param p0 parameter to the message.
518 * @param p1 parameter to the message.
519 * @param p2 parameter to the message.
520 */
521 void debug(String message, Object p0, Object p1, Object p2);
522
523 /**
524 * Logs a message with parameters at debug level.
525 *
526 * @param message the message to log; the format depends on the message factory.
527 * @param p0 parameter to the message.
528 * @param p1 parameter to the message.
529 * @param p2 parameter to the message.
530 * @param p3 parameter to the message.
531 */
532 void debug(String message, Object p0, Object p1, Object p2, Object p3);
533
534 /**
535 * Logs a message with parameters at debug level.
536 *
537 * @param message the message to log; the format depends on the message factory.
538 * @param p0 parameter to the message.
539 * @param p1 parameter to the message.
540 * @param p2 parameter to the message.
541 * @param p3 parameter to the message.
542 * @param p4 parameter to the message.
543 */
544 void debug(String message, Object p0, Object p1, Object p2, Object p3, Object p4);
545
546 /**
547 * Logs a message with parameters at debug level.
548 *
549 * @param message the message to log; the format depends on the message factory.
550 * @param p0 parameter to the message.
551 * @param p1 parameter to the message.
552 * @param p2 parameter to the message.
553 * @param p3 parameter to the message.
554 * @param p4 parameter to the message.
555 * @param p5 parameter to the message.
556 */
557 void debug(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5);
558
559 /**
560 * Logs a message with parameters at debug level.
561 *
562 * @param message the message to log; the format depends on the message factory.
563 * @param p0 parameter to the message.
564 * @param p1 parameter to the message.
565 * @param p2 parameter to the message.
566 * @param p3 parameter to the message.
567 * @param p4 parameter to the message.
568 * @param p5 parameter to the message.
569 * @param p6 parameter to the message.
570 */
571 void debug(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6);
572
573 /**
574 * Logs a message with parameters at debug level.
575 *
576 * @param message the message to log; the format depends on the message factory.
577 * @param p0 parameter to the message.
578 * @param p1 parameter to the message.
579 * @param p2 parameter to the message.
580 * @param p3 parameter to the message.
581 * @param p4 parameter to the message.
582 * @param p5 parameter to the message.
583 * @param p6 parameter to the message.
584 * @param p7 parameter to the message.
585 */
586 void debug(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7);
587
588 /**
589 * Logs a message with parameters at debug level.
590 *
591 * @param message the message to log; the format depends on the message factory.
592 * @param p0 parameter to the message.
593 * @param p1 parameter to the message.
594 * @param p2 parameter to the message.
595 * @param p3 parameter to the message.
596 * @param p4 parameter to the message.
597 * @param p5 parameter to the message.
598 * @param p6 parameter to the message.
599 * @param p7 parameter to the message.
600 * @param p8 parameter to the message.
601 */
602 void debug(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7,
603 Object p8);
604
605 /**
606 * Logs a message with parameters at debug level.
607 *
608 * @param message the message to log; the format depends on the message factory.
609 * @param p0 parameter to the message.
610 * @param p1 parameter to the message.
611 * @param p2 parameter to the message.
612 * @param p3 parameter to the message.
613 * @param p4 parameter to the message.
614 * @param p5 parameter to the message.
615 * @param p6 parameter to the message.
616 * @param p7 parameter to the message.
617 * @param p8 parameter to the message.
618 * @param p9 parameter to the message.
619 */
620 void debug(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7,
621 Object p8, Object p9);
622
623 /**
624 * Logs entry to a method. Used when the method in question has no parameters or when the parameters should not be
625 * logged.
626 * @deprecated Use {@link #traceEntry()} instead which performs the same function.
627 */
628 @Deprecated
629 void entry();
630
631 /**
632 * Logs entry to a method along with its parameters (consider using one of the {@code traceEntry(...)} methods instead.)
633 * <p>
634 * For example:
635 * </p>
636 * <pre>
637 * public void doSomething(String foo, int bar) {
638 * LOGGER.entry(foo, bar);
639 * // do something
640 * }
641 * </pre>
642 * <p>
643 * The use of methods such as this are more effective when combined with aspect-oriented programming or other
644 * bytecode manipulation tools. It can be rather tedious (and messy) to use this type of method manually.
645 * </p>
646 *
647 * @param params The parameters to the method.
648 */
649 void entry(Object... params);
650
651 /**
652 * Logs a message with the specific Marker at the {@link Level#ERROR ERROR} level.
653 *
654 * @param marker the marker data specific to this log statement
655 * @param msg the message string to be logged
656 */
657 void error(Marker marker, Message msg);
658
659 /**
660 * Logs a message with the specific Marker at the {@link Level#ERROR ERROR} level.
661 *
662 * @param marker the marker data specific to this log statement
663 * @param msg the message string to be logged
664 * @param t A Throwable or null.
665 */
666 void error(Marker marker, Message msg, Throwable t);
667
668 /**
669 * Logs a message which is only to be constructed if the logging level is the {@link Level#ERROR ERROR} level with
670 * the specified Marker. The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the
671 * {@code Message}.
672 *
673 * @param marker the marker data specific to this log statement
674 * @param msgSupplier A function, which when called, produces the desired log message.
675 * @since 2.4
676 */
677 void error(Marker marker, MessageSupplier msgSupplier);
678
679 /**
680 * Logs a message (only to be constructed if the logging level is the {@link Level#ERROR ERROR} level) with the
681 * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. The
682 * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}.
683 *
684 * @param marker the marker data specific to this log statement
685 * @param msgSupplier A function, which when called, produces the desired log message.
686 * @param t A Throwable or null.
687 * @since 2.4
688 */
689 void error(Marker marker, MessageSupplier msgSupplier, Throwable t);
690
691 /**
692 * Logs a message CharSequence with the {@link Level#ERROR ERROR} level.
693 *
694 * @param marker the marker data specific to this log statement.
695 * @param message the message CharSequence to log.
696 */
697 void error(Marker marker, CharSequence message);
698
699 /**
700 * Logs a CharSequence at the {@link Level#ERROR ERROR} level including the stack trace of the {@link Throwable}
701 * <code>t</code> passed as parameter.
702 *
703 * @param marker the marker data specific to this log statement.
704 * @param message the message CharSequence to log.
705 * @param t the exception to log, including its stack trace.
706 */
707 void error(Marker marker, CharSequence message, Throwable t);
708
709 /**
710 * Logs a message object with the {@link Level#ERROR ERROR} level.
711 *
712 * @param marker the marker data specific to this log statement.
713 * @param message the message object to log.
714 */
715 void error(Marker marker, Object message);
716
717 /**
718 * Logs a message at the {@link Level#ERROR ERROR} level including the stack trace of the {@link Throwable}
719 * <code>t</code> passed as parameter.
720 *
721 * @param marker the marker data specific to this log statement.
722 * @param message the message object to log.
723 * @param t the exception to log, including its stack trace.
724 */
725 void error(Marker marker, Object message, Throwable t);
726
727 /**
728 * Logs a message object with the {@link Level#ERROR ERROR} level.
729 *
730 * @param marker the marker data specific to this log statement.
731 * @param message the message object to log.
732 */
733 void error(Marker marker, String message);
734
735 /**
736 * Logs a message with parameters at the {@link Level#ERROR ERROR} level.
737 *
738 * @param marker the marker data specific to this log statement.
739 * @param message the message to log; the format depends on the message factory.
740 * @param params parameters to the message.
741 * @see #getMessageFactory()
742 */
743 void error(Marker marker, String message, Object... params);
744
745 /**
746 * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#ERROR
747 * ERROR} level.
748 *
749 * @param marker the marker data specific to this log statement
750 * @param message the message to log; the format depends on the message factory.
751 * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters.
752 * @since 2.4
753 */
754 void error(Marker marker, String message, Supplier<?>... paramSuppliers);
755
756 /**
757 * Logs a message at the {@link Level#ERROR ERROR} level including the stack trace of the {@link Throwable}
758 * <code>t</code> passed as parameter.
759 *
760 * @param marker the marker data specific to this log statement.
761 * @param message the message object to log.
762 * @param t the exception to log, including its stack trace.
763 */
764 void error(Marker marker, String message, Throwable t);
765
766 /**
767 * Logs a message which is only to be constructed if the logging level is the {@link Level#ERROR ERROR} level with
768 * the specified Marker.
769 *
770 * @param marker the marker data specific to this log statement
771 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
772 * message factory.
773 * @since 2.4
774 */
775 void error(Marker marker, Supplier<?> msgSupplier);
776
777 /**
778 * Logs a message (only to be constructed if the logging level is the {@link Level#ERROR ERROR} level) with the
779 * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter.
780 *
781 * @param marker the marker data specific to this log statement
782 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
783 * message factory.
784 * @param t A Throwable or null.
785 * @since 2.4
786 */
787 void error(Marker marker, Supplier<?> msgSupplier, Throwable t);
788
789 /**
790 * Logs a message with the specific Marker at the {@link Level#ERROR ERROR} level.
791 *
792 * @param msg the message string to be logged
793 */
794 void error(Message msg);
795
796 /**
797 * Logs a message with the specific Marker at the {@link Level#ERROR ERROR} level.
798 *
799 * @param msg the message string to be logged
800 * @param t A Throwable or null.
801 */
802 void error(Message msg, Throwable t);
803
804 /**
805 * Logs a message which is only to be constructed if the logging level is the {@link Level#ERROR ERROR} level. The
806 * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}.
807 *
808 * @param msgSupplier A function, which when called, produces the desired log message.
809 * @since 2.4
810 */
811 void error(MessageSupplier msgSupplier);
812
813 /**
814 * Logs a message (only to be constructed if the logging level is the {@link Level#ERROR ERROR} level) including the
815 * stack trace of the {@link Throwable} <code>t</code> passed as parameter. The {@code MessageSupplier} may or may
816 * not use the {@link MessageFactory} to construct the {@code Message}.
817 *
818 * @param msgSupplier A function, which when called, produces the desired log message.
819 * @param t the exception to log, including its stack trace.
820 * @since 2.4
821 */
822 void error(MessageSupplier msgSupplier, Throwable t);
823
824 /**
825 * Logs a message CharSequence with the {@link Level#ERROR ERROR} level.
826 *
827 * @param message the message CharSequence to log.
828 */
829 void error(CharSequence message);
830
831 /**
832 * Logs a CharSequence at the {@link Level#ERROR ERROR} level including the stack trace of the {@link Throwable}
833 * <code>t</code> passed as parameter.
834 *
835 * @param message the message CharSequence to log.
836 * @param t the exception to log, including its stack trace.
837 */
838 void error(CharSequence message, Throwable t);
839
840 /**
841 * Logs a message object with the {@link Level#ERROR ERROR} level.
842 *
843 * @param message the message object to log.
844 */
845 void error(Object message);
846
847 /**
848 * Logs a message at the {@link Level#ERROR ERROR} level including the stack trace of the {@link Throwable}
849 * <code>t</code> passed as parameter.
850 *
851 * @param message the message object to log.
852 * @param t the exception to log, including its stack trace.
853 */
854 void error(Object message, Throwable t);
855
856 /**
857 * Logs a message object with the {@link Level#ERROR ERROR} level.
858 *
859 * @param message the message string to log.
860 */
861 void error(String message);
862
863 /**
864 * Logs a message with parameters at the {@link Level#ERROR ERROR} level.
865 *
866 * @param message the message to log; the format depends on the message factory.
867 * @param params parameters to the message.
868 * @see #getMessageFactory()
869 */
870 void error(String message, Object... params);
871
872 /**
873 * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#ERROR
874 * ERROR} level.
875 *
876 * @param message the message to log; the format depends on the message factory.
877 * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters.
878 * @since 2.4
879 */
880 void error(String message, Supplier<?>... paramSuppliers);
881
882 /**
883 * Logs a message at the {@link Level#ERROR ERROR} level including the stack trace of the {@link Throwable}
884 * <code>t</code> passed as parameter.
885 *
886 * @param message the message object to log.
887 * @param t the exception to log, including its stack trace.
888 */
889 void error(String message, Throwable t);
890
891 /**
892 * Logs a message which is only to be constructed if the logging level is the {@link Level#ERROR ERROR} level.
893 *
894 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
895 * message factory.
896 * @since 2.4
897 */
898 void error(Supplier<?> msgSupplier);
899
900 /**
901 * Logs a message (only to be constructed if the logging level is the {@link Level#ERROR ERROR} level) including the
902 * stack trace of the {@link Throwable} <code>t</code> passed as parameter.
903 *
904 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
905 * message factory.
906 * @param t the exception to log, including its stack trace.
907 * @since 2.4
908 */
909 void error(Supplier<?> msgSupplier, Throwable t);
910
911 /**
912 * Logs a message with parameters at error level.
913 *
914 * @param marker the marker data specific to this log statement
915 * @param message the message to log; the format depends on the message factory.
916 * @param p0 parameter to the message.
917 */
918 void error(Marker marker, String message, Object p0);
919
920 /**
921 * Logs a message with parameters at error level.
922 *
923 * @param marker the marker data specific to this log statement
924 * @param message the message to log; the format depends on the message factory.
925 * @param p0 parameter to the message.
926 * @param p1 parameter to the message.
927 */
928 void error(Marker marker, String message, Object p0, Object p1);
929
930 /**
931 * Logs a message with parameters at error level.
932 *
933 * @param marker the marker data specific to this log statement
934 * @param message the message to log; the format depends on the message factory.
935 * @param p0 parameter to the message.
936 * @param p1 parameter to the message.
937 * @param p2 parameter to the message.
938 */
939 void error(Marker marker, String message, Object p0, Object p1, Object p2);
940
941 /**
942 * Logs a message with parameters at error level.
943 *
944 * @param marker the marker data specific to this log statement
945 * @param message the message to log; the format depends on the message factory.
946 * @param p0 parameter to the message.
947 * @param p1 parameter to the message.
948 * @param p2 parameter to the message.
949 * @param p3 parameter to the message.
950 */
951 void error(Marker marker, String message, Object p0, Object p1, Object p2, Object p3);
952
953 /**
954 * Logs a message with parameters at error level.
955 *
956 * @param marker the marker data specific to this log statement
957 * @param message the message to log; the format depends on the message factory.
958 * @param p0 parameter to the message.
959 * @param p1 parameter to the message.
960 * @param p2 parameter to the message.
961 * @param p3 parameter to the message.
962 * @param p4 parameter to the message.
963 */
964 void error(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4);
965
966 /**
967 * Logs a message with parameters at error level.
968 *
969 * @param marker the marker data specific to this log statement
970 * @param message the message to log; the format depends on the message factory.
971 * @param p0 parameter to the message.
972 * @param p1 parameter to the message.
973 * @param p2 parameter to the message.
974 * @param p3 parameter to the message.
975 * @param p4 parameter to the message.
976 * @param p5 parameter to the message.
977 */
978 void error(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5);
979
980 /**
981 * Logs a message with parameters at error level.
982 *
983 * @param marker the marker data specific to this log statement
984 * @param message the message to log; the format depends on the message factory.
985 * @param p0 parameter to the message.
986 * @param p1 parameter to the message.
987 * @param p2 parameter to the message.
988 * @param p3 parameter to the message.
989 * @param p4 parameter to the message.
990 * @param p5 parameter to the message.
991 * @param p6 parameter to the message.
992 */
993 void error(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5,
994 Object p6);
995
996 /**
997 * Logs a message with parameters at error level.
998 *
999 * @param marker the marker data specific to this log statement
1000 * @param message the message to log; the format depends on the message factory.
1001 * @param p0 parameter to the message.
1002 * @param p1 parameter to the message.
1003 * @param p2 parameter to the message.
1004 * @param p3 parameter to the message.
1005 * @param p4 parameter to the message.
1006 * @param p5 parameter to the message.
1007 * @param p6 parameter to the message.
1008 * @param p7 parameter to the message.
1009 */
1010 void error(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
1011 Object p7);
1012
1013 /**
1014 * Logs a message with parameters at error level.
1015 *
1016 * @param marker the marker data specific to this log statement
1017 * @param message the message to log; the format depends on the message factory.
1018 * @param p0 parameter to the message.
1019 * @param p1 parameter to the message.
1020 * @param p2 parameter to the message.
1021 * @param p3 parameter to the message.
1022 * @param p4 parameter to the message.
1023 * @param p5 parameter to the message.
1024 * @param p6 parameter to the message.
1025 * @param p7 parameter to the message.
1026 * @param p8 parameter to the message.
1027 */
1028 void error(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
1029 Object p7, Object p8);
1030
1031 /**
1032 * Logs a message with parameters at error level.
1033 *
1034 * @param marker the marker data specific to this log statement
1035 * @param message the message to log; the format depends on the message factory.
1036 * @param p0 parameter to the message.
1037 * @param p1 parameter to the message.
1038 * @param p2 parameter to the message.
1039 * @param p3 parameter to the message.
1040 * @param p4 parameter to the message.
1041 * @param p5 parameter to the message.
1042 * @param p6 parameter to the message.
1043 * @param p7 parameter to the message.
1044 * @param p8 parameter to the message.
1045 * @param p9 parameter to the message.
1046 */
1047 void error(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
1048 Object p7, Object p8, Object p9);
1049
1050 /**
1051 * Logs a message with parameters at error level.
1052 *
1053 * @param message the message to log; the format depends on the message factory.
1054 * @param p0 parameter to the message.
1055 */
1056 void error(String message, Object p0);
1057
1058 /**
1059 * Logs a message with parameters at error level.
1060 *
1061 * @param message the message to log; the format depends on the message factory.
1062 * @param p0 parameter to the message.
1063 * @param p1 parameter to the message.
1064 */
1065 void error(String message, Object p0, Object p1);
1066
1067 /**
1068 * Logs a message with parameters at error level.
1069 *
1070 * @param message the message to log; the format depends on the message factory.
1071 * @param p0 parameter to the message.
1072 * @param p1 parameter to the message.
1073 * @param p2 parameter to the message.
1074 */
1075 void error(String message, Object p0, Object p1, Object p2);
1076
1077 /**
1078 * Logs a message with parameters at error level.
1079 *
1080 * @param message the message to log; the format depends on the message factory.
1081 * @param p0 parameter to the message.
1082 * @param p1 parameter to the message.
1083 * @param p2 parameter to the message.
1084 * @param p3 parameter to the message.
1085 */
1086 void error(String message, Object p0, Object p1, Object p2, Object p3);
1087
1088 /**
1089 * Logs a message with parameters at error level.
1090 *
1091 * @param message the message to log; the format depends on the message factory.
1092 * @param p0 parameter to the message.
1093 * @param p1 parameter to the message.
1094 * @param p2 parameter to the message.
1095 * @param p3 parameter to the message.
1096 * @param p4 parameter to the message.
1097 */
1098 void error(String message, Object p0, Object p1, Object p2, Object p3, Object p4);
1099
1100 /**
1101 * Logs a message with parameters at error level.
1102 *
1103 * @param message the message to log; the format depends on the message factory.
1104 * @param p0 parameter to the message.
1105 * @param p1 parameter to the message.
1106 * @param p2 parameter to the message.
1107 * @param p3 parameter to the message.
1108 * @param p4 parameter to the message.
1109 * @param p5 parameter to the message.
1110 */
1111 void error(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5);
1112
1113 /**
1114 * Logs a message with parameters at error level.
1115 *
1116 * @param message the message to log; the format depends on the message factory.
1117 * @param p0 parameter to the message.
1118 * @param p1 parameter to the message.
1119 * @param p2 parameter to the message.
1120 * @param p3 parameter to the message.
1121 * @param p4 parameter to the message.
1122 * @param p5 parameter to the message.
1123 * @param p6 parameter to the message.
1124 */
1125 void error(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6);
1126
1127 /**
1128 * Logs a message with parameters at error level.
1129 *
1130 * @param message the message to log; the format depends on the message factory.
1131 * @param p0 parameter to the message.
1132 * @param p1 parameter to the message.
1133 * @param p2 parameter to the message.
1134 * @param p3 parameter to the message.
1135 * @param p4 parameter to the message.
1136 * @param p5 parameter to the message.
1137 * @param p6 parameter to the message.
1138 * @param p7 parameter to the message.
1139 */
1140 void error(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7);
1141
1142 /**
1143 * Logs a message with parameters at error level.
1144 *
1145 * @param message the message to log; the format depends on the message factory.
1146 * @param p0 parameter to the message.
1147 * @param p1 parameter to the message.
1148 * @param p2 parameter to the message.
1149 * @param p3 parameter to the message.
1150 * @param p4 parameter to the message.
1151 * @param p5 parameter to the message.
1152 * @param p6 parameter to the message.
1153 * @param p7 parameter to the message.
1154 * @param p8 parameter to the message.
1155 */
1156 void error(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7,
1157 Object p8);
1158
1159 /**
1160 * Logs a message with parameters at error level.
1161 *
1162 * @param message the message to log; the format depends on the message factory.
1163 * @param p0 parameter to the message.
1164 * @param p1 parameter to the message.
1165 * @param p2 parameter to the message.
1166 * @param p3 parameter to the message.
1167 * @param p4 parameter to the message.
1168 * @param p5 parameter to the message.
1169 * @param p6 parameter to the message.
1170 * @param p7 parameter to the message.
1171 * @param p8 parameter to the message.
1172 * @param p9 parameter to the message.
1173 */
1174 void error(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7,
1175 Object p8, Object p9);
1176
1177 /**
1178 * Logs exit from a method. Used for methods that do not return anything.
1179 * @deprecated Use {@link #traceExit()} instead which performs the same function.
1180 */
1181 @Deprecated
1182 void exit();
1183
1184 /**
1185 * Logs exiting from a method with the result. This may be coded as:
1186 *
1187 * <pre>
1188 * return LOGGER.exit(myResult);
1189 * </pre>
1190 *
1191 * @param <R> The type of the parameter and object being returned.
1192 * @param result The result being returned from the method call.
1193 * @return the result.
1194 * @deprecated Use {@link #traceExit(Object)} instead which performs the same function.
1195 */
1196 @Deprecated
1197 <R> R exit(R result);
1198
1199 /**
1200 * Logs a message with the specific Marker at the {@link Level#FATAL FATAL} level.
1201 *
1202 * @param marker the marker data specific to this log statement
1203 * @param msg the message string to be logged
1204 */
1205 void fatal(Marker marker, Message msg);
1206
1207 /**
1208 * Logs a message with the specific Marker at the {@link Level#FATAL FATAL} level.
1209 *
1210 * @param marker the marker data specific to this log statement
1211 * @param msg the message string to be logged
1212 * @param t A Throwable or null.
1213 */
1214 void fatal(Marker marker, Message msg, Throwable t);
1215
1216 /**
1217 * Logs a message which is only to be constructed if the logging level is the {@link Level#FATAL FATAL} level with
1218 * the specified Marker. The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the
1219 * {@code Message}.
1220 *
1221 * @param marker the marker data specific to this log statement
1222 * @param msgSupplier A function, which when called, produces the desired log message.
1223 * @since 2.4
1224 */
1225 void fatal(Marker marker, MessageSupplier msgSupplier);
1226
1227 /**
1228 * Logs a message (only to be constructed if the logging level is the {@link Level#FATAL FATAL} level) with the
1229 * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. The
1230 * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}.
1231 *
1232 * @param marker the marker data specific to this log statement
1233 * @param msgSupplier A function, which when called, produces the desired log message.
1234 * @param t A Throwable or null.
1235 * @since 2.4
1236 */
1237 void fatal(Marker marker, MessageSupplier msgSupplier, Throwable t);
1238
1239 /**
1240 * Logs a message CharSequence with the {@link Level#FATAL FATAL} level.
1241 *
1242 * @param marker The marker data specific to this log statement.
1243 * @param message the message CharSequence to log.
1244 */
1245 void fatal(Marker marker, CharSequence message);
1246
1247 /**
1248 * Logs a CharSequence at the {@link Level#FATAL FATAL} level including the stack trace of the {@link Throwable}
1249 * <code>t</code> passed as parameter.
1250 *
1251 * @param marker The marker data specific to this log statement.
1252 * @param message the message CharSequence to log.
1253 * @param t the exception to log, including its stack trace.
1254 */
1255 void fatal(Marker marker, CharSequence message, Throwable t);
1256
1257 /**
1258 * Logs a message object with the {@link Level#FATAL FATAL} level.
1259 *
1260 * @param marker The marker data specific to this log statement.
1261 * @param message the message object to log.
1262 */
1263 void fatal(Marker marker, Object message);
1264
1265 /**
1266 * Logs a message at the {@link Level#FATAL FATAL} level including the stack trace of the {@link Throwable}
1267 * <code>t</code> passed as parameter.
1268 *
1269 * @param marker The marker data specific to this log statement.
1270 * @param message the message object to log.
1271 * @param t the exception to log, including its stack trace.
1272 */
1273 void fatal(Marker marker, Object message, Throwable t);
1274
1275 /**
1276 * Logs a message object with the {@link Level#FATAL FATAL} level.
1277 *
1278 * @param marker The marker data specific to this log statement.
1279 * @param message the message object to log.
1280 */
1281 void fatal(Marker marker, String message);
1282
1283 /**
1284 * Logs a message with parameters at the {@link Level#FATAL FATAL} level.
1285 *
1286 * @param marker The marker data specific to this log statement.
1287 * @param message the message to log; the format depends on the message factory.
1288 * @param params parameters to the message.
1289 * @see #getMessageFactory()
1290 */
1291 void fatal(Marker marker, String message, Object... params);
1292
1293 /**
1294 * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#FATAL
1295 * FATAL} level.
1296 *
1297 * @param marker the marker data specific to this log statement
1298 * @param message the message to log; the format depends on the message factory.
1299 * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters.
1300 * @since 2.4
1301 */
1302 void fatal(Marker marker, String message, Supplier<?>... paramSuppliers);
1303
1304 /**
1305 * Logs a message at the {@link Level#FATAL FATAL} level including the stack trace of the {@link Throwable}
1306 * <code>t</code> passed as parameter.
1307 *
1308 * @param marker The marker data specific to this log statement.
1309 * @param message the message object to log.
1310 * @param t the exception to log, including its stack trace.
1311 */
1312 void fatal(Marker marker, String message, Throwable t);
1313
1314 /**
1315 * Logs a message which is only to be constructed if the logging level is the {@link Level#FATAL FATAL} level with
1316 * the specified Marker.
1317 *
1318 * @param marker the marker data specific to this log statement
1319 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
1320 * message factory.
1321 * @since 2.4
1322 */
1323 void fatal(Marker marker, Supplier<?> msgSupplier);
1324
1325 /**
1326 * Logs a message (only to be constructed if the logging level is the {@link Level#FATAL FATAL} level) with the
1327 * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter.
1328 *
1329 * @param marker the marker data specific to this log statement
1330 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
1331 * message factory.
1332 * @param t A Throwable or null.
1333 * @since 2.4
1334 */
1335 void fatal(Marker marker, Supplier<?> msgSupplier, Throwable t);
1336
1337 /**
1338 * Logs a message with the specific Marker at the {@link Level#FATAL FATAL} level.
1339 *
1340 * @param msg the message string to be logged
1341 */
1342 void fatal(Message msg);
1343
1344 /**
1345 * Logs a message with the specific Marker at the {@link Level#FATAL FATAL} level.
1346 *
1347 * @param msg the message string to be logged
1348 * @param t A Throwable or null.
1349 */
1350 void fatal(Message msg, Throwable t);
1351
1352 /**
1353 * Logs a message which is only to be constructed if the logging level is the {@link Level#FATAL FATAL} level. The
1354 * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}.
1355 *
1356 * @param msgSupplier A function, which when called, produces the desired log message.
1357 * @since 2.4
1358 */
1359 void fatal(MessageSupplier msgSupplier);
1360
1361 /**
1362 * Logs a message (only to be constructed if the logging level is the {@link Level#FATAL FATAL} level) including the
1363 * stack trace of the {@link Throwable} <code>t</code> passed as parameter. The {@code MessageSupplier} may or may
1364 * not use the {@link MessageFactory} to construct the {@code Message}.
1365 *
1366 * @param msgSupplier A function, which when called, produces the desired log message.
1367 * @param t the exception to log, including its stack trace.
1368 * @since 2.4
1369 */
1370 void fatal(MessageSupplier msgSupplier, Throwable t);
1371
1372 /**
1373 * Logs a message CharSequence with the {@link Level#FATAL FATAL} level.
1374 *
1375 * @param message the message CharSequence to log.
1376 */
1377 void fatal(CharSequence message);
1378
1379 /**
1380 * Logs a CharSequence at the {@link Level#FATAL FATAL} level including the stack trace of the {@link Throwable}
1381 * <code>t</code> passed as parameter.
1382 *
1383 * @param message the message CharSequence to log.
1384 * @param t the exception to log, including its stack trace.
1385 */
1386 void fatal(CharSequence message, Throwable t);
1387
1388 /**
1389 * Logs a message object with the {@link Level#FATAL FATAL} level.
1390 *
1391 * @param message the message object to log.
1392 */
1393 void fatal(Object message);
1394
1395 /**
1396 * Logs a message at the {@link Level#FATAL FATAL} level including the stack trace of the {@link Throwable}
1397 * <code>t</code> passed as parameter.
1398 *
1399 * @param message the message object to log.
1400 * @param t the exception to log, including its stack trace.
1401 */
1402 void fatal(Object message, Throwable t);
1403
1404 /**
1405 * Logs a message object with the {@link Level#FATAL FATAL} level.
1406 *
1407 * @param message the message string to log.
1408 */
1409 void fatal(String message);
1410
1411 /**
1412 * Logs a message with parameters at the {@link Level#FATAL FATAL} level.
1413 *
1414 * @param message the message to log; the format depends on the message factory.
1415 * @param params parameters to the message.
1416 * @see #getMessageFactory()
1417 */
1418 void fatal(String message, Object... params);
1419
1420 /**
1421 * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#FATAL
1422 * FATAL} level.
1423 *
1424 * @param message the message to log; the format depends on the message factory.
1425 * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters.
1426 * @since 2.4
1427 */
1428 void fatal(String message, Supplier<?>... paramSuppliers);
1429
1430 /**
1431 * Logs a message at the {@link Level#FATAL FATAL} level including the stack trace of the {@link Throwable}
1432 * <code>t</code> passed as parameter.
1433 *
1434 * @param message the message object to log.
1435 * @param t the exception to log, including its stack trace.
1436 */
1437 void fatal(String message, Throwable t);
1438
1439 /**
1440 * Logs a message which is only to be constructed if the logging level is the {@link Level#FATAL FATAL} level.
1441 *
1442 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
1443 * message factory.
1444 * @since 2.4
1445 */
1446 void fatal(Supplier<?> msgSupplier);
1447
1448 /**
1449 * Logs a message (only to be constructed if the logging level is the {@link Level#FATAL FATAL} level) including the
1450 * stack trace of the {@link Throwable} <code>t</code> passed as parameter.
1451 *
1452 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
1453 * message factory.
1454 * @param t the exception to log, including its stack trace.
1455 * @since 2.4
1456 */
1457 void fatal(Supplier<?> msgSupplier, Throwable t);
1458
1459 /**
1460 * Logs a message with parameters at fatal level.
1461 *
1462 * @param marker the marker data specific to this log statement
1463 * @param message the message to log; the format depends on the message factory.
1464 * @param p0 parameter to the message.
1465 */
1466 void fatal(Marker marker, String message, Object p0);
1467
1468 /**
1469 * Logs a message with parameters at fatal level.
1470 *
1471 * @param marker the marker data specific to this log statement
1472 * @param message the message to log; the format depends on the message factory.
1473 * @param p0 parameter to the message.
1474 * @param p1 parameter to the message.
1475 */
1476 void fatal(Marker marker, String message, Object p0, Object p1);
1477
1478 /**
1479 * Logs a message with parameters at fatal level.
1480 *
1481 * @param marker the marker data specific to this log statement
1482 * @param message the message to log; the format depends on the message factory.
1483 * @param p0 parameter to the message.
1484 * @param p1 parameter to the message.
1485 * @param p2 parameter to the message.
1486 */
1487 void fatal(Marker marker, String message, Object p0, Object p1, Object p2);
1488
1489 /**
1490 * Logs a message with parameters at fatal level.
1491 *
1492 * @param marker the marker data specific to this log statement
1493 * @param message the message to log; the format depends on the message factory.
1494 * @param p0 parameter to the message.
1495 * @param p1 parameter to the message.
1496 * @param p2 parameter to the message.
1497 * @param p3 parameter to the message.
1498 */
1499 void fatal(Marker marker, String message, Object p0, Object p1, Object p2, Object p3);
1500
1501 /**
1502 * Logs a message with parameters at fatal level.
1503 *
1504 * @param marker the marker data specific to this log statement
1505 * @param message the message to log; the format depends on the message factory.
1506 * @param p0 parameter to the message.
1507 * @param p1 parameter to the message.
1508 * @param p2 parameter to the message.
1509 * @param p3 parameter to the message.
1510 * @param p4 parameter to the message.
1511 */
1512 void fatal(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4);
1513
1514 /**
1515 * Logs a message with parameters at fatal level.
1516 *
1517 * @param marker the marker data specific to this log statement
1518 * @param message the message to log; the format depends on the message factory.
1519 * @param p0 parameter to the message.
1520 * @param p1 parameter to the message.
1521 * @param p2 parameter to the message.
1522 * @param p3 parameter to the message.
1523 * @param p4 parameter to the message.
1524 * @param p5 parameter to the message.
1525 */
1526 void fatal(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5);
1527
1528 /**
1529 * Logs a message with parameters at fatal level.
1530 *
1531 * @param marker the marker data specific to this log statement
1532 * @param message the message to log; the format depends on the message factory.
1533 * @param p0 parameter to the message.
1534 * @param p1 parameter to the message.
1535 * @param p2 parameter to the message.
1536 * @param p3 parameter to the message.
1537 * @param p4 parameter to the message.
1538 * @param p5 parameter to the message.
1539 * @param p6 parameter to the message.
1540 */
1541 void fatal(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5,
1542 Object p6);
1543
1544 /**
1545 * Logs a message with parameters at fatal level.
1546 *
1547 * @param marker the marker data specific to this log statement
1548 * @param message the message to log; the format depends on the message factory.
1549 * @param p0 parameter to the message.
1550 * @param p1 parameter to the message.
1551 * @param p2 parameter to the message.
1552 * @param p3 parameter to the message.
1553 * @param p4 parameter to the message.
1554 * @param p5 parameter to the message.
1555 * @param p6 parameter to the message.
1556 * @param p7 parameter to the message.
1557 */
1558 void fatal(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
1559 Object p7);
1560
1561 /**
1562 * Logs a message with parameters at fatal level.
1563 *
1564 * @param marker the marker data specific to this log statement
1565 * @param message the message to log; the format depends on the message factory.
1566 * @param p0 parameter to the message.
1567 * @param p1 parameter to the message.
1568 * @param p2 parameter to the message.
1569 * @param p3 parameter to the message.
1570 * @param p4 parameter to the message.
1571 * @param p5 parameter to the message.
1572 * @param p6 parameter to the message.
1573 * @param p7 parameter to the message.
1574 * @param p8 parameter to the message.
1575 */
1576 void fatal(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
1577 Object p7, Object p8);
1578
1579 /**
1580 * Logs a message with parameters at fatal level.
1581 *
1582 * @param marker the marker data specific to this log statement
1583 * @param message the message to log; the format depends on the message factory.
1584 * @param p0 parameter to the message.
1585 * @param p1 parameter to the message.
1586 * @param p2 parameter to the message.
1587 * @param p3 parameter to the message.
1588 * @param p4 parameter to the message.
1589 * @param p5 parameter to the message.
1590 * @param p6 parameter to the message.
1591 * @param p7 parameter to the message.
1592 * @param p8 parameter to the message.
1593 * @param p9 parameter to the message.
1594 */
1595 void fatal(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
1596 Object p7, Object p8, Object p9);
1597
1598 /**
1599 * Logs a message with parameters at fatal level.
1600 *
1601 * @param message the message to log; the format depends on the message factory.
1602 * @param p0 parameter to the message.
1603 */
1604 void fatal(String message, Object p0);
1605
1606 /**
1607 * Logs a message with parameters at fatal level.
1608 *
1609 * @param message the message to log; the format depends on the message factory.
1610 * @param p0 parameter to the message.
1611 * @param p1 parameter to the message.
1612 */
1613 void fatal(String message, Object p0, Object p1);
1614
1615 /**
1616 * Logs a message with parameters at fatal level.
1617 *
1618 * @param message the message to log; the format depends on the message factory.
1619 * @param p0 parameter to the message.
1620 * @param p1 parameter to the message.
1621 * @param p2 parameter to the message.
1622 */
1623 void fatal(String message, Object p0, Object p1, Object p2);
1624
1625 /**
1626 * Logs a message with parameters at fatal level.
1627 *
1628 * @param message the message to log; the format depends on the message factory.
1629 * @param p0 parameter to the message.
1630 * @param p1 parameter to the message.
1631 * @param p2 parameter to the message.
1632 * @param p3 parameter to the message.
1633 */
1634 void fatal(String message, Object p0, Object p1, Object p2, Object p3);
1635
1636 /**
1637 * Logs a message with parameters at fatal level.
1638 *
1639 * @param message the message to log; the format depends on the message factory.
1640 * @param p0 parameter to the message.
1641 * @param p1 parameter to the message.
1642 * @param p2 parameter to the message.
1643 * @param p3 parameter to the message.
1644 * @param p4 parameter to the message.
1645 */
1646 void fatal(String message, Object p0, Object p1, Object p2, Object p3, Object p4);
1647
1648 /**
1649 * Logs a message with parameters at fatal level.
1650 *
1651 * @param message the message to log; the format depends on the message factory.
1652 * @param p0 parameter to the message.
1653 * @param p1 parameter to the message.
1654 * @param p2 parameter to the message.
1655 * @param p3 parameter to the message.
1656 * @param p4 parameter to the message.
1657 * @param p5 parameter to the message.
1658 */
1659 void fatal(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5);
1660
1661 /**
1662 * Logs a message with parameters at fatal level.
1663 *
1664 * @param message the message to log; the format depends on the message factory.
1665 * @param p0 parameter to the message.
1666 * @param p1 parameter to the message.
1667 * @param p2 parameter to the message.
1668 * @param p3 parameter to the message.
1669 * @param p4 parameter to the message.
1670 * @param p5 parameter to the message.
1671 * @param p6 parameter to the message.
1672 */
1673 void fatal(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6);
1674
1675 /**
1676 * Logs a message with parameters at fatal level.
1677 *
1678 * @param message the message to log; the format depends on the message factory.
1679 * @param p0 parameter to the message.
1680 * @param p1 parameter to the message.
1681 * @param p2 parameter to the message.
1682 * @param p3 parameter to the message.
1683 * @param p4 parameter to the message.
1684 * @param p5 parameter to the message.
1685 * @param p6 parameter to the message.
1686 * @param p7 parameter to the message.
1687 */
1688 void fatal(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7);
1689
1690 /**
1691 * Logs a message with parameters at fatal level.
1692 *
1693 * @param message the message to log; the format depends on the message factory.
1694 * @param p0 parameter to the message.
1695 * @param p1 parameter to the message.
1696 * @param p2 parameter to the message.
1697 * @param p3 parameter to the message.
1698 * @param p4 parameter to the message.
1699 * @param p5 parameter to the message.
1700 * @param p6 parameter to the message.
1701 * @param p7 parameter to the message.
1702 * @param p8 parameter to the message.
1703 */
1704 void fatal(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7,
1705 Object p8);
1706
1707 /**
1708 * Logs a message with parameters at fatal level.
1709 *
1710 * @param message the message to log; the format depends on the message factory.
1711 * @param p0 parameter to the message.
1712 * @param p1 parameter to the message.
1713 * @param p2 parameter to the message.
1714 * @param p3 parameter to the message.
1715 * @param p4 parameter to the message.
1716 * @param p5 parameter to the message.
1717 * @param p6 parameter to the message.
1718 * @param p7 parameter to the message.
1719 * @param p8 parameter to the message.
1720 * @param p9 parameter to the message.
1721 */
1722 void fatal(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7,
1723 Object p8, Object p9);
1724
1725 /**
1726 * Gets the Level associated with the Logger.
1727 *
1728 * @return the Level associate with the Logger.
1729 */
1730 Level getLevel();
1731
1732 /**
1733 * Gets the message factory used to convert message Objects and Strings/CharSequences into actual log Messages.
1734 *
1735 * Since version 2.6, Log4j internally uses message factories that implement the {@link MessageFactory2} interface.
1736 * From version 2.6.2, the return type of this method was changed from {@link MessageFactory} to
1737 * {@code <MF extends MessageFactory> MF}. The returned factory will always implement {@link MessageFactory2},
1738 * but the return type of this method could not be changed to {@link MessageFactory2} without breaking binary
1739 * compatibility.
1740 *
1741 * @return the message factory, as an instance of {@link MessageFactory2}
1742 */
1743 <MF extends MessageFactory> MF getMessageFactory();
1744
1745 /**
1746 * Gets the logger name.
1747 *
1748 * @return the logger name.
1749 */
1750 String getName();
1751
1752 /**
1753 * Logs a message with the specific Marker at the {@link Level#INFO INFO} level.
1754 *
1755 * @param marker the marker data specific to this log statement
1756 * @param msg the message string to be logged
1757 */
1758 void info(Marker marker, Message msg);
1759
1760 /**
1761 * Logs a message with the specific Marker at the {@link Level#INFO INFO} level.
1762 *
1763 * @param marker the marker data specific to this log statement
1764 * @param msg the message string to be logged
1765 * @param t A Throwable or null.
1766 */
1767 void info(Marker marker, Message msg, Throwable t);
1768
1769 /**
1770 * Logs a message which is only to be constructed if the logging level is the {@link Level#INFO INFO} level with the
1771 * specified Marker. The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the
1772 * {@code Message}.
1773 *
1774 * @param marker the marker data specific to this log statement
1775 * @param msgSupplier A function, which when called, produces the desired log message.
1776 * @since 2.4
1777 */
1778 void info(Marker marker, MessageSupplier msgSupplier);
1779
1780 /**
1781 * Logs a message (only to be constructed if the logging level is the {@link Level#INFO INFO} level) with the
1782 * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. The
1783 * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}.
1784 *
1785 * @param marker the marker data specific to this log statement
1786 * @param msgSupplier A function, which when called, produces the desired log message.
1787 * @param t A Throwable or null.
1788 * @since 2.4
1789 */
1790 void info(Marker marker, MessageSupplier msgSupplier, Throwable t);
1791
1792 /**
1793 * Logs a message CharSequence with the {@link Level#INFO INFO} level.
1794 *
1795 * @param marker the marker data specific to this log statement
1796 * @param message the message CharSequence to log.
1797 */
1798 void info(Marker marker, CharSequence message);
1799
1800 /**
1801 * Logs a CharSequence at the {@link Level#INFO INFO} level including the stack trace of the {@link Throwable}
1802 * <code>t</code> passed as parameter.
1803 *
1804 * @param marker the marker data specific to this log statement
1805 * @param message the message CharSequence to log.
1806 * @param t the exception to log, including its stack trace.
1807 */
1808 void info(Marker marker, CharSequence message, Throwable t);
1809
1810 /**
1811 * Logs a message object with the {@link Level#INFO INFO} level.
1812 *
1813 * @param marker the marker data specific to this log statement
1814 * @param message the message object to log.
1815 */
1816 void info(Marker marker, Object message);
1817
1818 /**
1819 * Logs a message at the {@link Level#INFO INFO} level including the stack trace of the {@link Throwable}
1820 * <code>t</code> passed as parameter.
1821 *
1822 * @param marker the marker data specific to this log statement
1823 * @param message the message object to log.
1824 * @param t the exception to log, including its stack trace.
1825 */
1826 void info(Marker marker, Object message, Throwable t);
1827
1828 /**
1829 * Logs a message object with the {@link Level#INFO INFO} level.
1830 *
1831 * @param marker the marker data specific to this log statement
1832 * @param message the message object to log.
1833 */
1834 void info(Marker marker, String message);
1835
1836 /**
1837 * Logs a message with parameters at the {@link Level#INFO INFO} level.
1838 *
1839 * @param marker the marker data specific to this log statement
1840 * @param message the message to log; the format depends on the message factory.
1841 * @param params parameters to the message.
1842 * @see #getMessageFactory()
1843 */
1844 void info(Marker marker, String message, Object... params);
1845
1846 /**
1847 * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#INFO
1848 * INFO} level.
1849 *
1850 * @param marker the marker data specific to this log statement
1851 * @param message the message to log; the format depends on the message factory.
1852 * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters.
1853 * @since 2.4
1854 */
1855 void info(Marker marker, String message, Supplier<?>... paramSuppliers);
1856
1857 /**
1858 * Logs a message at the {@link Level#INFO INFO} level including the stack trace of the {@link Throwable}
1859 * <code>t</code> passed as parameter.
1860 *
1861 * @param marker the marker data specific to this log statement
1862 * @param message the message object to log.
1863 * @param t the exception to log, including its stack trace.
1864 */
1865 void info(Marker marker, String message, Throwable t);
1866
1867 /**
1868 * Logs a message which is only to be constructed if the logging level is the {@link Level#INFO INFO} level with the
1869 * specified Marker.
1870 *
1871 * @param marker the marker data specific to this log statement
1872 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
1873 * message factory.
1874 * @since 2.4
1875 */
1876 void info(Marker marker, Supplier<?> msgSupplier);
1877
1878 /**
1879 * Logs a message (only to be constructed if the logging level is the {@link Level#INFO INFO} level) with the
1880 * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter.
1881 *
1882 * @param marker the marker data specific to this log statement
1883 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
1884 * message factory.
1885 * @param t A Throwable or null.
1886 * @since 2.4
1887 */
1888 void info(Marker marker, Supplier<?> msgSupplier, Throwable t);
1889
1890 /**
1891 * Logs a message with the specific Marker at the {@link Level#INFO INFO} level.
1892 *
1893 * @param msg the message string to be logged
1894 */
1895 void info(Message msg);
1896
1897 /**
1898 * Logs a message with the specific Marker at the {@link Level#INFO INFO} level.
1899 *
1900 * @param msg the message string to be logged
1901 * @param t A Throwable or null.
1902 */
1903 void info(Message msg, Throwable t);
1904
1905 /**
1906 * Logs a message which is only to be constructed if the logging level is the {@link Level#INFO INFO} level. The
1907 * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}.
1908 *
1909 * @param msgSupplier A function, which when called, produces the desired log message.
1910 * @since 2.4
1911 */
1912 void info(MessageSupplier msgSupplier);
1913
1914 /**
1915 * Logs a message (only to be constructed if the logging level is the {@link Level#INFO INFO} level) including the
1916 * stack trace of the {@link Throwable} <code>t</code> passed as parameter. The {@code MessageSupplier} may or may
1917 * not use the {@link MessageFactory} to construct the {@code Message}.
1918 *
1919 * @param msgSupplier A function, which when called, produces the desired log message.
1920 * @param t the exception to log, including its stack trace.
1921 * @since 2.4
1922 */
1923 void info(MessageSupplier msgSupplier, Throwable t);
1924
1925 /**
1926 * Logs a message CharSequence with the {@link Level#INFO INFO} level.
1927 *
1928 * @param message the message CharSequence to log.
1929 */
1930 void info(CharSequence message);
1931
1932 /**
1933 * Logs a CharSequence at the {@link Level#INFO INFO} level including the stack trace of the {@link Throwable}
1934 * <code>t</code> passed as parameter.
1935 *
1936 * @param message the message CharSequence to log.
1937 * @param t the exception to log, including its stack trace.
1938 */
1939 void info(CharSequence message, Throwable t);
1940
1941 /**
1942 * Logs a message object with the {@link Level#INFO INFO} level.
1943 *
1944 * @param message the message object to log.
1945 */
1946 void info(Object message);
1947
1948 /**
1949 * Logs a message at the {@link Level#INFO INFO} level including the stack trace of the {@link Throwable}
1950 * <code>t</code> passed as parameter.
1951 *
1952 * @param message the message object to log.
1953 * @param t the exception to log, including its stack trace.
1954 */
1955 void info(Object message, Throwable t);
1956
1957 /**
1958 * Logs a message object with the {@link Level#INFO INFO} level.
1959 *
1960 * @param message the message string to log.
1961 */
1962 void info(String message);
1963
1964 /**
1965 * Logs a message with parameters at the {@link Level#INFO INFO} level.
1966 *
1967 * @param message the message to log; the format depends on the message factory.
1968 * @param params parameters to the message.
1969 * @see #getMessageFactory()
1970 */
1971 void info(String message, Object... params);
1972
1973 /**
1974 * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#INFO
1975 * INFO} level.
1976 *
1977 * @param message the message to log; the format depends on the message factory.
1978 * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters.
1979 * @since 2.4
1980 */
1981 void info(String message, Supplier<?>... paramSuppliers);
1982
1983 /**
1984 * Logs a message at the {@link Level#INFO INFO} level including the stack trace of the {@link Throwable}
1985 * <code>t</code> passed as parameter.
1986 *
1987 * @param message the message object to log.
1988 * @param t the exception to log, including its stack trace.
1989 */
1990 void info(String message, Throwable t);
1991
1992 /**
1993 * Logs a message which is only to be constructed if the logging level is the {@link Level#INFO INFO} level.
1994 *
1995 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
1996 * message factory.
1997 * @since 2.4
1998 */
1999 void info(Supplier<?> msgSupplier);
2000
2001 /**
2002 * Logs a message (only to be constructed if the logging level is the {@link Level#INFO INFO} level) including the
2003 * stack trace of the {@link Throwable} <code>t</code> passed as parameter.
2004 *
2005 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
2006 * message factory.
2007 * @param t the exception to log, including its stack trace.
2008 * @since 2.4
2009 */
2010 void info(Supplier<?> msgSupplier, Throwable t);
2011
2012 /**
2013 * Logs a message with parameters at info level.
2014 *
2015 * @param marker the marker data specific to this log statement
2016 * @param message the message to log; the format depends on the message factory.
2017 * @param p0 parameter to the message.
2018 */
2019 void info(Marker marker, String message, Object p0);
2020
2021 /**
2022 * Logs a message with parameters at info level.
2023 *
2024 * @param marker the marker data specific to this log statement
2025 * @param message the message to log; the format depends on the message factory.
2026 * @param p0 parameter to the message.
2027 * @param p1 parameter to the message.
2028 */
2029 void info(Marker marker, String message, Object p0, Object p1);
2030
2031 /**
2032 * Logs a message with parameters at info level.
2033 *
2034 * @param marker the marker data specific to this log statement
2035 * @param message the message to log; the format depends on the message factory.
2036 * @param p0 parameter to the message.
2037 * @param p1 parameter to the message.
2038 * @param p2 parameter to the message.
2039 */
2040 void info(Marker marker, String message, Object p0, Object p1, Object p2);
2041
2042 /**
2043 * Logs a message with parameters at info level.
2044 *
2045 * @param marker the marker data specific to this log statement
2046 * @param message the message to log; the format depends on the message factory.
2047 * @param p0 parameter to the message.
2048 * @param p1 parameter to the message.
2049 * @param p2 parameter to the message.
2050 * @param p3 parameter to the message.
2051 */
2052 void info(Marker marker, String message, Object p0, Object p1, Object p2, Object p3);
2053
2054 /**
2055 * Logs a message with parameters at info level.
2056 *
2057 * @param marker the marker data specific to this log statement
2058 * @param message the message to log; the format depends on the message factory.
2059 * @param p0 parameter to the message.
2060 * @param p1 parameter to the message.
2061 * @param p2 parameter to the message.
2062 * @param p3 parameter to the message.
2063 * @param p4 parameter to the message.
2064 */
2065 void info(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4);
2066
2067 /**
2068 * Logs a message with parameters at info level.
2069 *
2070 * @param marker the marker data specific to this log statement
2071 * @param message the message to log; the format depends on the message factory.
2072 * @param p0 parameter to the message.
2073 * @param p1 parameter to the message.
2074 * @param p2 parameter to the message.
2075 * @param p3 parameter to the message.
2076 * @param p4 parameter to the message.
2077 * @param p5 parameter to the message.
2078 */
2079 void info(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5);
2080
2081 /**
2082 * Logs a message with parameters at info level.
2083 *
2084 * @param marker the marker data specific to this log statement
2085 * @param message the message to log; the format depends on the message factory.
2086 * @param p0 parameter to the message.
2087 * @param p1 parameter to the message.
2088 * @param p2 parameter to the message.
2089 * @param p3 parameter to the message.
2090 * @param p4 parameter to the message.
2091 * @param p5 parameter to the message.
2092 * @param p6 parameter to the message.
2093 */
2094 void info(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5,
2095 Object p6);
2096
2097 /**
2098 * Logs a message with parameters at info level.
2099 *
2100 * @param marker the marker data specific to this log statement
2101 * @param message the message to log; the format depends on the message factory.
2102 * @param p0 parameter to the message.
2103 * @param p1 parameter to the message.
2104 * @param p2 parameter to the message.
2105 * @param p3 parameter to the message.
2106 * @param p4 parameter to the message.
2107 * @param p5 parameter to the message.
2108 * @param p6 parameter to the message.
2109 * @param p7 parameter to the message.
2110 */
2111 void info(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
2112 Object p7);
2113
2114 /**
2115 * Logs a message with parameters at info level.
2116 *
2117 * @param marker the marker data specific to this log statement
2118 * @param message the message to log; the format depends on the message factory.
2119 * @param p0 parameter to the message.
2120 * @param p1 parameter to the message.
2121 * @param p2 parameter to the message.
2122 * @param p3 parameter to the message.
2123 * @param p4 parameter to the message.
2124 * @param p5 parameter to the message.
2125 * @param p6 parameter to the message.
2126 * @param p7 parameter to the message.
2127 * @param p8 parameter to the message.
2128 */
2129 void info(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
2130 Object p7, Object p8);
2131
2132 /**
2133 * Logs a message with parameters at info level.
2134 *
2135 * @param marker the marker data specific to this log statement
2136 * @param message the message to log; the format depends on the message factory.
2137 * @param p0 parameter to the message.
2138 * @param p1 parameter to the message.
2139 * @param p2 parameter to the message.
2140 * @param p3 parameter to the message.
2141 * @param p4 parameter to the message.
2142 * @param p5 parameter to the message.
2143 * @param p6 parameter to the message.
2144 * @param p7 parameter to the message.
2145 * @param p8 parameter to the message.
2146 * @param p9 parameter to the message.
2147 */
2148 void info(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
2149 Object p7, Object p8, Object p9);
2150
2151 /**
2152 * Logs a message with parameters at info level.
2153 *
2154 * @param message the message to log; the format depends on the message factory.
2155 * @param p0 parameter to the message.
2156 */
2157 void info(String message, Object p0);
2158
2159 /**
2160 * Logs a message with parameters at info level.
2161 *
2162 * @param message the message to log; the format depends on the message factory.
2163 * @param p0 parameter to the message.
2164 * @param p1 parameter to the message.
2165 */
2166 void info(String message, Object p0, Object p1);
2167
2168 /**
2169 * Logs a message with parameters at info level.
2170 *
2171 * @param message the message to log; the format depends on the message factory.
2172 * @param p0 parameter to the message.
2173 * @param p1 parameter to the message.
2174 * @param p2 parameter to the message.
2175 */
2176 void info(String message, Object p0, Object p1, Object p2);
2177
2178 /**
2179 * Logs a message with parameters at info level.
2180 *
2181 * @param message the message to log; the format depends on the message factory.
2182 * @param p0 parameter to the message.
2183 * @param p1 parameter to the message.
2184 * @param p2 parameter to the message.
2185 * @param p3 parameter to the message.
2186 */
2187 void info(String message, Object p0, Object p1, Object p2, Object p3);
2188
2189 /**
2190 * Logs a message with parameters at info level.
2191 *
2192 * @param message the message to log; the format depends on the message factory.
2193 * @param p0 parameter to the message.
2194 * @param p1 parameter to the message.
2195 * @param p2 parameter to the message.
2196 * @param p3 parameter to the message.
2197 * @param p4 parameter to the message.
2198 */
2199 void info(String message, Object p0, Object p1, Object p2, Object p3, Object p4);
2200
2201 /**
2202 * Logs a message with parameters at info level.
2203 *
2204 * @param message the message to log; the format depends on the message factory.
2205 * @param p0 parameter to the message.
2206 * @param p1 parameter to the message.
2207 * @param p2 parameter to the message.
2208 * @param p3 parameter to the message.
2209 * @param p4 parameter to the message.
2210 * @param p5 parameter to the message.
2211 */
2212 void info(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5);
2213
2214 /**
2215 * Logs a message with parameters at info level.
2216 *
2217 * @param message the message to log; the format depends on the message factory.
2218 * @param p0 parameter to the message.
2219 * @param p1 parameter to the message.
2220 * @param p2 parameter to the message.
2221 * @param p3 parameter to the message.
2222 * @param p4 parameter to the message.
2223 * @param p5 parameter to the message.
2224 * @param p6 parameter to the message.
2225 */
2226 void info(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6);
2227
2228 /**
2229 * Logs a message with parameters at info level.
2230 *
2231 * @param message the message to log; the format depends on the message factory.
2232 * @param p0 parameter to the message.
2233 * @param p1 parameter to the message.
2234 * @param p2 parameter to the message.
2235 * @param p3 parameter to the message.
2236 * @param p4 parameter to the message.
2237 * @param p5 parameter to the message.
2238 * @param p6 parameter to the message.
2239 * @param p7 parameter to the message.
2240 */
2241 void info(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7);
2242
2243 /**
2244 * Logs a message with parameters at info level.
2245 *
2246 * @param message the message to log; the format depends on the message factory.
2247 * @param p0 parameter to the message.
2248 * @param p1 parameter to the message.
2249 * @param p2 parameter to the message.
2250 * @param p3 parameter to the message.
2251 * @param p4 parameter to the message.
2252 * @param p5 parameter to the message.
2253 * @param p6 parameter to the message.
2254 * @param p7 parameter to the message.
2255 * @param p8 parameter to the message.
2256 */
2257 void info(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7,
2258 Object p8);
2259
2260 /**
2261 * Logs a message with parameters at info level.
2262 *
2263 * @param message the message to log; the format depends on the message factory.
2264 * @param p0 parameter to the message.
2265 * @param p1 parameter to the message.
2266 * @param p2 parameter to the message.
2267 * @param p3 parameter to the message.
2268 * @param p4 parameter to the message.
2269 * @param p5 parameter to the message.
2270 * @param p6 parameter to the message.
2271 * @param p7 parameter to the message.
2272 * @param p8 parameter to the message.
2273 * @param p9 parameter to the message.
2274 */
2275 void info(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7,
2276 Object p8, Object p9);
2277
2278 /**
2279 * Checks whether this Logger is enabled for the {@link Level#DEBUG DEBUG} Level.
2280 *
2281 * @return boolean - {@code true} if this Logger is enabled for level DEBUG, {@code false} otherwise.
2282 */
2283 boolean isDebugEnabled();
2284
2285 /**
2286 * Checks whether this Logger is enabled for the {@link Level#DEBUG DEBUG} Level.
2287 *
2288 * @param marker The Marker to check
2289 * @return boolean - {@code true} if this Logger is enabled for level DEBUG, {@code false} otherwise.
2290 */
2291 boolean isDebugEnabled(Marker marker);
2292
2293 /**
2294 * Checks whether this Logger is enabled for the given Level.
2295 * <p>
2296 * Note that passing in {@link Level#OFF OFF} always returns {@code true}.
2297 * </p>
2298 *
2299 * @param level the Level to check
2300 * @return boolean - {@code true} if this Logger is enabled for level, {@code false} otherwise.
2301 */
2302 boolean isEnabled(Level level);
2303
2304 /**
2305 * Checks whether this Logger is enabled for the given Level and Marker.
2306 *
2307 * @param level The Level to check
2308 * @param marker The Marker to check
2309 * @return boolean - {@code true} if this Logger is enabled for level and marker, {@code false} otherwise.
2310 */
2311 boolean isEnabled(Level level, Marker marker);
2312
2313 /**
2314 * Checks whether this Logger is enabled for the {@link Level#ERROR ERROR} Level.
2315 *
2316 * @return boolean - {@code true} if this Logger is enabled for level {@link Level#ERROR ERROR}, {@code false}
2317 * otherwise.
2318 */
2319 boolean isErrorEnabled();
2320
2321 /**
2322 * Checks whether this Logger is enabled for the {@link Level#ERROR ERROR} Level.
2323 *
2324 * @param marker The Marker to check
2325 * @return boolean - {@code true} if this Logger is enabled for level {@link Level#ERROR ERROR}, {@code false}
2326 * otherwise.
2327 */
2328 boolean isErrorEnabled(Marker marker);
2329
2330 /**
2331 * Checks whether this Logger is enabled for the {@link Level#FATAL FATAL} Level.
2332 *
2333 * @return boolean - {@code true} if this Logger is enabled for level {@link Level#FATAL FATAL}, {@code false}
2334 * otherwise.
2335 */
2336 boolean isFatalEnabled();
2337
2338 /**
2339 * Checks whether this Logger is enabled for the {@link Level#FATAL FATAL} Level.
2340 *
2341 * @param marker The Marker to check
2342 * @return boolean - {@code true} if this Logger is enabled for level {@link Level#FATAL FATAL}, {@code false}
2343 * otherwise.
2344 */
2345 boolean isFatalEnabled(Marker marker);
2346
2347 /**
2348 * Checks whether this Logger is enabled for the {@link Level#INFO INFO} Level.
2349 *
2350 * @return boolean - {@code true} if this Logger is enabled for level INFO, {@code false} otherwise.
2351 */
2352 boolean isInfoEnabled();
2353
2354 /**
2355 * Checks whether this Logger is enabled for the {@link Level#INFO INFO} Level.
2356 *
2357 * @param marker The Marker to check
2358 * @return boolean - {@code true} if this Logger is enabled for level INFO, {@code false} otherwise.
2359 */
2360 boolean isInfoEnabled(Marker marker);
2361
2362 /**
2363 * Checks whether this Logger is enabled for the {@link Level#TRACE TRACE} level.
2364 *
2365 * @return boolean - {@code true} if this Logger is enabled for level TRACE, {@code false} otherwise.
2366 */
2367 boolean isTraceEnabled();
2368
2369 /**
2370 * Checks whether this Logger is enabled for the {@link Level#TRACE TRACE} level.
2371 *
2372 * @param marker The Marker to check
2373 * @return boolean - {@code true} if this Logger is enabled for level TRACE, {@code false} otherwise.
2374 */
2375 boolean isTraceEnabled(Marker marker);
2376
2377 /**
2378 * Checks whether this Logger is enabled for the {@link Level#WARN WARN} Level.
2379 *
2380 * @return boolean - {@code true} if this Logger is enabled for level {@link Level#WARN WARN}, {@code false}
2381 * otherwise.
2382 */
2383 boolean isWarnEnabled();
2384
2385 /**
2386 * Checks whether this Logger is enabled for the {@link Level#WARN WARN} Level.
2387 *
2388 * @param marker The Marker to check
2389 * @return boolean - {@code true} if this Logger is enabled for level {@link Level#WARN WARN}, {@code false}
2390 * otherwise.
2391 */
2392 boolean isWarnEnabled(Marker marker);
2393
2394 /**
2395 * Logs a message with the specific Marker at the given level.
2396 *
2397 * @param level the logging level
2398 * @param marker the marker data specific to this log statement
2399 * @param msg the message string to be logged
2400 */
2401 void log(Level level, Marker marker, Message msg);
2402
2403 /**
2404 * Logs a message with the specific Marker at the given level.
2405 *
2406 * @param level the logging level
2407 * @param marker the marker data specific to this log statement
2408 * @param msg the message string to be logged
2409 * @param t A Throwable or null.
2410 */
2411 void log(Level level, Marker marker, Message msg, Throwable t);
2412
2413 /**
2414 * Logs a message which is only to be constructed if the logging level is the specified level with the specified
2415 * Marker. The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the
2416 * {@code Message}.
2417 *
2418 * @param level the logging level
2419 * @param marker the marker data specific to this log statement
2420 * @param msgSupplier A function, which when called, produces the desired log message.
2421 * @since 2.4
2422 */
2423 void log(Level level, Marker marker, MessageSupplier msgSupplier);
2424
2425 /**
2426 * Logs a message (only to be constructed if the logging level is the specified level) with the specified Marker and
2427 * including the stack log of the {@link Throwable} <code>t</code> passed as parameter. The {@code MessageSupplier}
2428 * may or may not use the {@link MessageFactory} to construct the {@code Message}.
2429 *
2430 * @param level the logging level
2431 * @param marker the marker data specific to this log statement
2432 * @param msgSupplier A function, which when called, produces the desired log message.
2433 * @param t A Throwable or null.
2434 * @since 2.4
2435 */
2436 void log(Level level, Marker marker, MessageSupplier msgSupplier, Throwable t);
2437
2438 /**
2439 * Logs a message CharSequence with the given level.
2440 *
2441 * @param level the logging level
2442 * @param marker the marker data specific to this log statement
2443 * @param message the message CharSequence to log.
2444 */
2445 void log(Level level, Marker marker, CharSequence message);
2446
2447 /**
2448 * Logs a CharSequence at the given level including the stack trace of the {@link Throwable} <code>t</code> passed as
2449 * parameter.
2450 *
2451 * @param level the logging level
2452 * @param marker the marker data specific to this log statement
2453 * @param message the message CharSequence to log.
2454 * @param t the exception to log, including its stack trace.
2455 */
2456 void log(Level level, Marker marker, CharSequence message, Throwable t);
2457
2458 /**
2459 * Logs a message object with the given level.
2460 *
2461 * @param level the logging level
2462 * @param marker the marker data specific to this log statement
2463 * @param message the message object to log.
2464 */
2465 void log(Level level, Marker marker, Object message);
2466
2467 /**
2468 * Logs a message at the given level including the stack trace of the {@link Throwable} <code>t</code> passed as
2469 * parameter.
2470 *
2471 * @param level the logging level
2472 * @param marker the marker data specific to this log statement
2473 * @param message the message to log.
2474 * @param t the exception to log, including its stack trace.
2475 */
2476 void log(Level level, Marker marker, Object message, Throwable t);
2477
2478 /**
2479 * Logs a message object with the given level.
2480 *
2481 * @param level the logging level
2482 * @param marker the marker data specific to this log statement
2483 * @param message the message object to log.
2484 */
2485 void log(Level level, Marker marker, String message);
2486
2487 /**
2488 * Logs a message with parameters at the given level.
2489 *
2490 * @param level the logging level
2491 * @param marker the marker data specific to this log statement
2492 * @param message the message to log; the format depends on the message factory.
2493 * @param params parameters to the message.
2494 * @see #getMessageFactory()
2495 */
2496 void log(Level level, Marker marker, String message, Object... params);
2497
2498 /**
2499 * Logs a message with parameters which are only to be constructed if the logging level is the specified level.
2500 *
2501 * @param level the logging level
2502 * @param marker the marker data specific to this log statement
2503 * @param message the message to log; the format depends on the message factory.
2504 * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters.
2505 * @since 2.4
2506 */
2507 void log(Level level, Marker marker, String message, Supplier<?>... paramSuppliers);
2508
2509 /**
2510 * Logs a message at the given level including the stack trace of the {@link Throwable} <code>t</code> passed as
2511 * parameter.
2512 *
2513 * @param level the logging level
2514 * @param marker the marker data specific to this log statement
2515 * @param message the message to log.
2516 * @param t the exception to log, including its stack trace.
2517 */
2518 void log(Level level, Marker marker, String message, Throwable t);
2519
2520 /**
2521 * Logs a message (only to be constructed if the logging level is the specified level) with the specified Marker.
2522 *
2523 * @param level the logging level
2524 * @param marker the marker data specific to this log statement
2525 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
2526 * message factory.
2527 * @since 2.4
2528 */
2529 void log(Level level, Marker marker, Supplier<?> msgSupplier);
2530
2531 /**
2532 * Logs a message (only to be constructed if the logging level is the specified level) with the specified Marker and
2533 * including the stack log of the {@link Throwable} <code>t</code> passed as parameter.
2534 *
2535 * @param level the logging level
2536 * @param marker the marker data specific to this log statement
2537 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
2538 * message factory.
2539 * @param t A Throwable or null.
2540 * @since 2.4
2541 */
2542 void log(Level level, Marker marker, Supplier<?> msgSupplier, Throwable t);
2543
2544 /**
2545 * Logs a message with the specific Marker at the given level.
2546 *
2547 * @param level the logging level
2548 * @param msg the message string to be logged
2549 */
2550 void log(Level level, Message msg);
2551
2552 /**
2553 * Logs a message with the specific Marker at the given level.
2554 *
2555 * @param level the logging level
2556 * @param msg the message string to be logged
2557 * @param t A Throwable or null.
2558 */
2559 void log(Level level, Message msg, Throwable t);
2560
2561 /**
2562 * Logs a message which is only to be constructed if the logging level is the specified level. The
2563 * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}.
2564 *
2565 * @param level the logging level
2566 * @param msgSupplier A function, which when called, produces the desired log message.
2567 * @since 2.4
2568 */
2569 void log(Level level, MessageSupplier msgSupplier);
2570
2571 /**
2572 * Logs a message (only to be constructed if the logging level is the specified level) including the stack log of
2573 * the {@link Throwable} <code>t</code> passed as parameter. The {@code MessageSupplier} may or may not use the
2574 * {@link MessageFactory} to construct the {@code Message}.
2575 *
2576 * @param level the logging level
2577 * @param msgSupplier A function, which when called, produces the desired log message.
2578 * @param t the exception to log, including its stack log.
2579 * @since 2.4
2580 */
2581 void log(Level level, MessageSupplier msgSupplier, Throwable t);
2582
2583 /**
2584 * Logs a message CharSequence with the given level.
2585 *
2586 * @param level the logging level
2587 * @param message the message CharSequence to log.
2588 */
2589 void log(Level level, CharSequence message);
2590
2591 /**
2592 * Logs a CharSequence at the given level including the stack trace of the {@link Throwable} <code>t</code> passed as
2593 * parameter.
2594 *
2595 * @param level the logging level
2596 * @param message the message CharSequence to log.
2597 * @param t the exception to log, including its stack trace.
2598 */
2599 void log(Level level, CharSequence message, Throwable t);
2600
2601 /**
2602 * Logs a message object with the given level.
2603 *
2604 * @param level the logging level
2605 * @param message the message object to log.
2606 */
2607 void log(Level level, Object message);
2608
2609 /**
2610 * Logs a message at the given level including the stack trace of the {@link Throwable} <code>t</code> passed as
2611 * parameter.
2612 *
2613 * @param level the logging level
2614 * @param message the message to log.
2615 * @param t the exception to log, including its stack trace.
2616 */
2617 void log(Level level, Object message, Throwable t);
2618
2619 /**
2620 * Logs a message object with the given level.
2621 *
2622 * @param level the logging level
2623 * @param message the message string to log.
2624 */
2625 void log(Level level, String message);
2626
2627 /**
2628 * Logs a message with parameters at the given level.
2629 *
2630 * @param level the logging level
2631 * @param message the message to log; the format depends on the message factory.
2632 * @param params parameters to the message.
2633 * @see #getMessageFactory()
2634 */
2635 void log(Level level, String message, Object... params);
2636
2637 /**
2638 * Logs a message with parameters which are only to be constructed if the logging level is the specified level.
2639 *
2640 * @param level the logging level
2641 * @param message the message to log; the format depends on the message factory.
2642 * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters.
2643 * @since 2.4
2644 */
2645 void log(Level level, String message, Supplier<?>... paramSuppliers);
2646
2647 /**
2648 * Logs a message at the given level including the stack trace of the {@link Throwable} <code>t</code> passed as
2649 * parameter.
2650 *
2651 * @param level the logging level
2652 * @param message the message to log.
2653 * @param t the exception to log, including its stack trace.
2654 */
2655 void log(Level level, String message, Throwable t);
2656
2657 /**
2658 * Logs a message which is only to be constructed if the logging level is the specified level.
2659 *
2660 * @param level the logging level
2661 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
2662 * message factory.
2663 * @since 2.4
2664 */
2665 void log(Level level, Supplier<?> msgSupplier);
2666
2667 /**
2668 * Logs a message (only to be constructed if the logging level is the specified level) including the stack log of
2669 * the {@link Throwable} <code>t</code> passed as parameter.
2670 *
2671 * @param level the logging level
2672 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
2673 * message factory.
2674 * @param t the exception to log, including its stack log.
2675 * @since 2.4
2676 */
2677 void log(Level level, Supplier<?> msgSupplier, Throwable t);
2678
2679 /**
2680 * Logs a message with parameters at the specified level.
2681 *
2682 * @param level the logging level
2683 * @param marker the marker data specific to this log statement
2684 * @param message the message to log; the format depends on the message factory.
2685 * @param p0 parameter to the message.
2686 */
2687 void log(Level level, Marker marker, String message, Object p0);
2688
2689 /**
2690 * Logs a message with parameters at the specified level.
2691 *
2692 * @param level the logging level
2693 * @param marker the marker data specific to this log statement
2694 * @param message the message to log; the format depends on the message factory.
2695 * @param p0 parameter to the message.
2696 * @param p1 parameter to the message.
2697 */
2698 void log(Level level, Marker marker, String message, Object p0, Object p1);
2699
2700 /**
2701 * Logs a message with parameters at the specified level.
2702 *
2703 * @param level the logging level
2704 * @param marker the marker data specific to this log statement
2705 * @param message the message to log; the format depends on the message factory.
2706 * @param p0 parameter to the message.
2707 * @param p1 parameter to the message.
2708 * @param p2 parameter to the message.
2709 */
2710 void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2);
2711
2712 /**
2713 * Logs a message with parameters at the specified level.
2714 *
2715 * @param level the logging level
2716 * @param marker the marker data specific to this log statement
2717 * @param message the message to log; the format depends on the message factory.
2718 * @param p0 parameter to the message.
2719 * @param p1 parameter to the message.
2720 * @param p2 parameter to the message.
2721 * @param p3 parameter to the message.
2722 */
2723 void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2, Object p3);
2724
2725 /**
2726 * Logs a message with parameters at the specified level.
2727 *
2728 * @param level the logging level
2729 * @param marker the marker data specific to this log statement
2730 * @param message the message to log; the format depends on the message factory.
2731 * @param p0 parameter to the message.
2732 * @param p1 parameter to the message.
2733 * @param p2 parameter to the message.
2734 * @param p3 parameter to the message.
2735 * @param p4 parameter to the message.
2736 */
2737 void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4);
2738
2739 /**
2740 * Logs a message with parameters at the specified level.
2741 *
2742 * @param level the logging level
2743 * @param marker the marker data specific to this log statement
2744 * @param message the message to log; the format depends on the message factory.
2745 * @param p0 parameter to the message.
2746 * @param p1 parameter to the message.
2747 * @param p2 parameter to the message.
2748 * @param p3 parameter to the message.
2749 * @param p4 parameter to the message.
2750 * @param p5 parameter to the message.
2751 */
2752 void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5);
2753
2754 /**
2755 * Logs a message with parameters at the specified level.
2756 *
2757 * @param level the logging level
2758 * @param marker the marker data specific to this log statement
2759 * @param message the message to log; the format depends on the message factory.
2760 * @param p0 parameter to the message.
2761 * @param p1 parameter to the message.
2762 * @param p2 parameter to the message.
2763 * @param p3 parameter to the message.
2764 * @param p4 parameter to the message.
2765 * @param p5 parameter to the message.
2766 * @param p6 parameter to the message.
2767 */
2768 void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5,
2769 Object p6);
2770
2771 /**
2772 * Logs a message with parameters at the specified level.
2773 *
2774 * @param level the logging level
2775 * @param marker the marker data specific to this log statement
2776 * @param message the message to log; the format depends on the message factory.
2777 * @param p0 parameter to the message.
2778 * @param p1 parameter to the message.
2779 * @param p2 parameter to the message.
2780 * @param p3 parameter to the message.
2781 * @param p4 parameter to the message.
2782 * @param p5 parameter to the message.
2783 * @param p6 parameter to the message.
2784 * @param p7 parameter to the message.
2785 */
2786 void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
2787 Object p7);
2788
2789 /**
2790 * Logs a message with parameters at the specified level.
2791 *
2792 * @param level the logging level
2793 * @param marker the marker data specific to this log statement
2794 * @param message the message to log; the format depends on the message factory.
2795 * @param p0 parameter to the message.
2796 * @param p1 parameter to the message.
2797 * @param p2 parameter to the message.
2798 * @param p3 parameter to the message.
2799 * @param p4 parameter to the message.
2800 * @param p5 parameter to the message.
2801 * @param p6 parameter to the message.
2802 * @param p7 parameter to the message.
2803 * @param p8 parameter to the message.
2804 */
2805 void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
2806 Object p7, Object p8);
2807
2808 /**
2809 * Logs a message with parameters at the specified level.
2810 *
2811 * @param level the logging level
2812 * @param marker the marker data specific to this log statement
2813 * @param message the message to log; the format depends on the message factory.
2814 * @param p0 parameter to the message.
2815 * @param p1 parameter to the message.
2816 * @param p2 parameter to the message.
2817 * @param p3 parameter to the message.
2818 * @param p4 parameter to the message.
2819 * @param p5 parameter to the message.
2820 * @param p6 parameter to the message.
2821 * @param p7 parameter to the message.
2822 * @param p8 parameter to the message.
2823 * @param p9 parameter to the message.
2824 */
2825 void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
2826 Object p7, Object p8, Object p9);
2827
2828 /**
2829 * Logs a message with parameters at the specified level.
2830 *
2831 * @param level the logging level
2832 * @param message the message to log; the format depends on the message factory.
2833 * @param p0 parameter to the message.
2834 */
2835 void log(Level level, String message, Object p0);
2836
2837 /**
2838 * Logs a message with parameters at the specified level.
2839 *
2840 * @param level the logging level
2841 * @param message the message to log; the format depends on the message factory.
2842 * @param p0 parameter to the message.
2843 * @param p1 parameter to the message.
2844 */
2845 void log(Level level, String message, Object p0, Object p1);
2846
2847 /**
2848 * Logs a message with parameters at the specified level.
2849 *
2850 * @param level the logging level
2851 * @param message the message to log; the format depends on the message factory.
2852 * @param p0 parameter to the message.
2853 * @param p1 parameter to the message.
2854 * @param p2 parameter to the message.
2855 */
2856 void log(Level level, String message, Object p0, Object p1, Object p2);
2857
2858 /**
2859 * Logs a message with parameters at the specified level.
2860 *
2861 * @param level the logging level
2862 * @param message the message to log; the format depends on the message factory.
2863 * @param p0 parameter to the message.
2864 * @param p1 parameter to the message.
2865 * @param p2 parameter to the message.
2866 * @param p3 parameter to the message.
2867 */
2868 void log(Level level, String message, Object p0, Object p1, Object p2, Object p3);
2869
2870 /**
2871 * Logs a message with parameters at the specified level.
2872 *
2873 * @param level the logging level
2874 * @param message the message to log; the format depends on the message factory.
2875 * @param p0 parameter to the message.
2876 * @param p1 parameter to the message.
2877 * @param p2 parameter to the message.
2878 * @param p3 parameter to the message.
2879 * @param p4 parameter to the message.
2880 */
2881 void log(Level level, String message, Object p0, Object p1, Object p2, Object p3, Object p4);
2882
2883 /**
2884 * Logs a message with parameters at the specified level.
2885 *
2886 * @param level the logging level
2887 * @param message the message to log; the format depends on the message factory.
2888 * @param p0 parameter to the message.
2889 * @param p1 parameter to the message.
2890 * @param p2 parameter to the message.
2891 * @param p3 parameter to the message.
2892 * @param p4 parameter to the message.
2893 * @param p5 parameter to the message.
2894 */
2895 void log(Level level, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5);
2896
2897 /**
2898 * Logs a message with parameters at the specified level.
2899 *
2900 * @param level the logging level
2901 * @param message the message to log; the format depends on the message factory.
2902 * @param p0 parameter to the message.
2903 * @param p1 parameter to the message.
2904 * @param p2 parameter to the message.
2905 * @param p3 parameter to the message.
2906 * @param p4 parameter to the message.
2907 * @param p5 parameter to the message.
2908 * @param p6 parameter to the message.
2909 */
2910 void log(Level level, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6);
2911
2912 /**
2913 * Logs a message with parameters at the specified level.
2914 *
2915 * @param level the logging level
2916 * @param message the message to log; the format depends on the message factory.
2917 * @param p0 parameter to the message.
2918 * @param p1 parameter to the message.
2919 * @param p2 parameter to the message.
2920 * @param p3 parameter to the message.
2921 * @param p4 parameter to the message.
2922 * @param p5 parameter to the message.
2923 * @param p6 parameter to the message.
2924 * @param p7 parameter to the message.
2925 */
2926 void log(Level level, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7);
2927
2928 /**
2929 * Logs a message with parameters at the specified level.
2930 *
2931 * @param level the logging level
2932 * @param message the message to log; the format depends on the message factory.
2933 * @param p0 parameter to the message.
2934 * @param p1 parameter to the message.
2935 * @param p2 parameter to the message.
2936 * @param p3 parameter to the message.
2937 * @param p4 parameter to the message.
2938 * @param p5 parameter to the message.
2939 * @param p6 parameter to the message.
2940 * @param p7 parameter to the message.
2941 * @param p8 parameter to the message.
2942 */
2943 void log(Level level, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7,
2944 Object p8);
2945
2946 /**
2947 * Logs a message with parameters at the specified level.
2948 *
2949 * @param level the logging level
2950 * @param message the message to log; the format depends on the message factory.
2951 * @param p0 parameter to the message.
2952 * @param p1 parameter to the message.
2953 * @param p2 parameter to the message.
2954 * @param p3 parameter to the message.
2955 * @param p4 parameter to the message.
2956 * @param p5 parameter to the message.
2957 * @param p6 parameter to the message.
2958 * @param p7 parameter to the message.
2959 * @param p8 parameter to the message.
2960 * @param p9 parameter to the message.
2961 */
2962 void log(Level level, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7,
2963 Object p8, Object p9);
2964
2965 /**
2966 * Logs a formatted message using the specified format string and arguments.
2967 *
2968 * @param level The logging Level.
2969 * @param marker the marker data specific to this log statement.
2970 * @param format The format String.
2971 * @param params Arguments specified by the format.
2972 */
2973 void printf(Level level, Marker marker, String format, Object... params);
2974
2975 /**
2976 * Logs a formatted message using the specified format string and arguments.
2977 *
2978 * @param level The logging Level.
2979 * @param format The format String.
2980 * @param params Arguments specified by the format.
2981 */
2982 void printf(Level level, String format, Object... params);
2983
2984 /**
2985 * Logs an exception or error to be thrown. This may be coded as:
2986 *
2987 * <pre>
2988 * throw logger.throwing(Level.DEBUG, myException);
2989 * </pre>
2990 *
2991 * @param <T> the Throwable type.
2992 * @param level The logging Level.
2993 * @param t The Throwable.
2994 * @return the Throwable.
2995 */
2996 <T extends Throwable> T throwing(Level level, T t);
2997
2998 /**
2999 * Logs an exception or error to be thrown. This may be coded as:
3000 *
3001 * <pre>
3002 * throw logger.throwing(myException);
3003 * </pre>
3004 *
3005 * @param <T> the Throwable type.
3006 * @param t The Throwable.
3007 * @return the Throwable.
3008 */
3009 <T extends Throwable> T throwing(T t);
3010
3011 /**
3012 * Logs a message with the specific Marker at the {@link Level#TRACE TRACE} level.
3013 *
3014 * @param marker the marker data specific to this log statement
3015 * @param msg the message string to be logged
3016 */
3017 void trace(Marker marker, Message msg);
3018
3019 /**
3020 * Logs a message with the specific Marker at the {@link Level#TRACE TRACE} level.
3021 *
3022 * @param marker the marker data specific to this log statement
3023 * @param msg the message string to be logged
3024 * @param t A Throwable or null.
3025 */
3026 void trace(Marker marker, Message msg, Throwable t);
3027
3028 /**
3029 * Logs a message which is only to be constructed if the logging level is the {@link Level#TRACE TRACE} level with
3030 * the specified Marker. The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the
3031 * {@code Message}.
3032 *
3033 * @param marker the marker data specific to this log statement
3034 * @param msgSupplier A function, which when called, produces the desired log message.
3035 * @since 2.4
3036 */
3037 void trace(Marker marker, MessageSupplier msgSupplier);
3038
3039 /**
3040 * Logs a message (only to be constructed if the logging level is the {@link Level#TRACE TRACE} level) with the
3041 * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. The
3042 * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}.
3043 *
3044 * @param marker the marker data specific to this log statement
3045 * @param msgSupplier A function, which when called, produces the desired log message.
3046 * @param t A Throwable or null.
3047 * @since 2.4
3048 */
3049 void trace(Marker marker, MessageSupplier msgSupplier, Throwable t);
3050
3051 /**
3052 * Logs a message CharSequence with the {@link Level#TRACE TRACE} level.
3053 *
3054 * @param marker the marker data specific to this log statement
3055 * @param message the message CharSequence to log.
3056 */
3057 void trace(Marker marker, CharSequence message);
3058
3059 /**
3060 * Logs a CharSequence at the {@link Level#TRACE TRACE} level including the stack trace of the {@link Throwable}
3061 * <code>t</code> passed as parameter.
3062 *
3063 * @param marker the marker data specific to this log statement
3064 * @param message the message CharSequence to log.
3065 * @param t the exception to log, including its stack trace.
3066 * @see #debug(String)
3067 */
3068 void trace(Marker marker, CharSequence message, Throwable t);
3069
3070 /**
3071 * Logs a message object with the {@link Level#TRACE TRACE} level.
3072 *
3073 * @param marker the marker data specific to this log statement
3074 * @param message the message object to log.
3075 */
3076 void trace(Marker marker, Object message);
3077
3078 /**
3079 * Logs a message at the {@link Level#TRACE TRACE} level including the stack trace of the {@link Throwable}
3080 * <code>t</code> passed as parameter.
3081 *
3082 * @param marker the marker data specific to this log statement
3083 * @param message the message object to log.
3084 * @param t the exception to log, including its stack trace.
3085 * @see #debug(String)
3086 */
3087 void trace(Marker marker, Object message, Throwable t);
3088
3089 /**
3090 * Logs a message object with the {@link Level#TRACE TRACE} level.
3091 *
3092 * @param marker the marker data specific to this log statement
3093 * @param message the message string to log.
3094 */
3095 void trace(Marker marker, String message);
3096
3097 /**
3098 * Logs a message with parameters at the {@link Level#TRACE TRACE} level.
3099 *
3100 * @param marker the marker data specific to this log statement
3101 * @param message the message to log; the format depends on the message factory.
3102 * @param params parameters to the message.
3103 * @see #getMessageFactory()
3104 */
3105 void trace(Marker marker, String message, Object... params);
3106
3107 /**
3108 * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#TRACE
3109 * TRACE} level.
3110 *
3111 * @param marker the marker data specific to this log statement
3112 * @param message the message to log; the format depends on the message factory.
3113 * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters.
3114 * @since 2.4
3115 */
3116 void trace(Marker marker, String message, Supplier<?>... paramSuppliers);
3117
3118 /**
3119 * Logs a message at the {@link Level#TRACE TRACE} level including the stack trace of the {@link Throwable}
3120 * <code>t</code> passed as parameter.
3121 *
3122 * @param marker the marker data specific to this log statement
3123 * @param message the message object to log.
3124 * @param t the exception to log, including its stack trace.
3125 * @see #debug(String)
3126 */
3127 void trace(Marker marker, String message, Throwable t);
3128
3129 /**
3130 * Logs a message which is only to be constructed if the logging level is the {@link Level#TRACE TRACE} level with
3131 * the specified Marker.
3132 *
3133 * @param marker the marker data specific to this log statement
3134 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
3135 * message factory.
3136 * @since 2.4
3137 */
3138 void trace(Marker marker, Supplier<?> msgSupplier);
3139
3140 /**
3141 * Logs a message (only to be constructed if the logging level is the {@link Level#TRACE TRACE} level) with the
3142 * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter.
3143 *
3144 * @param marker the marker data specific to this log statement
3145 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
3146 * message factory.
3147 * @param t A Throwable or null.
3148 * @since 2.4
3149 */
3150 void trace(Marker marker, Supplier<?> msgSupplier, Throwable t);
3151
3152 /**
3153 * Logs a message with the specific Marker at the {@link Level#TRACE TRACE} level.
3154 *
3155 * @param msg the message string to be logged
3156 */
3157 void trace(Message msg);
3158
3159 /**
3160 * Logs a message with the specific Marker at the {@link Level#TRACE TRACE} level.
3161 *
3162 * @param msg the message string to be logged
3163 * @param t A Throwable or null.
3164 */
3165 void trace(Message msg, Throwable t);
3166
3167 /**
3168 * Logs a message which is only to be constructed if the logging level is the {@link Level#TRACE TRACE} level. The
3169 * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}.
3170 *
3171 * @param msgSupplier A function, which when called, produces the desired log message.
3172 * @since 2.4
3173 */
3174 void trace(MessageSupplier msgSupplier);
3175
3176 /**
3177 * Logs a message (only to be constructed if the logging level is the {@link Level#TRACE TRACE} level) including the
3178 * stack trace of the {@link Throwable} <code>t</code> passed as parameter. The {@code MessageSupplier} may or may
3179 * not use the {@link MessageFactory} to construct the {@code Message}.
3180 *
3181 * @param msgSupplier A function, which when called, produces the desired log message.
3182 * @param t the exception to log, including its stack trace.
3183 * @since 2.4
3184 */
3185 void trace(MessageSupplier msgSupplier, Throwable t);
3186
3187 /**
3188 * Logs a message CharSequence with the {@link Level#TRACE TRACE} level.
3189 *
3190 * @param message the message CharSequence to log.
3191 */
3192 void trace(CharSequence message);
3193
3194 /**
3195 * Logs a CharSequence at the {@link Level#TRACE TRACE} level including the stack trace of the {@link Throwable}
3196 * <code>t</code> passed as parameter.
3197 *
3198 * @param message the message CharSequence to log.
3199 * @param t the exception to log, including its stack trace.
3200 * @see #debug(String)
3201 */
3202 void trace(CharSequence message, Throwable t);
3203
3204 /**
3205 * Logs a message object with the {@link Level#TRACE TRACE} level.
3206 *
3207 * @param message the message object to log.
3208 */
3209 void trace(Object message);
3210
3211 /**
3212 * Logs a message at the {@link Level#TRACE TRACE} level including the stack trace of the {@link Throwable}
3213 * <code>t</code> passed as parameter.
3214 *
3215 * @param message the message object to log.
3216 * @param t the exception to log, including its stack trace.
3217 * @see #debug(String)
3218 */
3219 void trace(Object message, Throwable t);
3220
3221 /**
3222 * Logs a message object with the {@link Level#TRACE TRACE} level.
3223 *
3224 * @param message the message string to log.
3225 */
3226 void trace(String message);
3227
3228 /**
3229 * Logs a message with parameters at the {@link Level#TRACE TRACE} level.
3230 *
3231 * @param message the message to log; the format depends on the message factory.
3232 * @param params parameters to the message.
3233 * @see #getMessageFactory()
3234 */
3235 void trace(String message, Object... params);
3236
3237 /**
3238 * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#TRACE
3239 * TRACE} level.
3240 *
3241 * @param message the message to log; the format depends on the message factory.
3242 * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters.
3243 * @since 2.4
3244 */
3245 void trace(String message, Supplier<?>... paramSuppliers);
3246
3247 /**
3248 * Logs a message at the {@link Level#TRACE TRACE} level including the stack trace of the {@link Throwable}
3249 * <code>t</code> passed as parameter.
3250 *
3251 * @param message the message object to log.
3252 * @param t the exception to log, including its stack trace.
3253 * @see #debug(String)
3254 */
3255 void trace(String message, Throwable t);
3256
3257 /**
3258 * Logs a message which is only to be constructed if the logging level is the {@link Level#TRACE TRACE} level.
3259 *
3260 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
3261 * message factory.
3262 * @since 2.4
3263 */
3264 void trace(Supplier<?> msgSupplier);
3265
3266 /**
3267 * Logs a message (only to be constructed if the logging level is the {@link Level#TRACE TRACE} level) including the
3268 * stack trace of the {@link Throwable} <code>t</code> passed as parameter.
3269 *
3270 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
3271 * message factory.
3272 * @param t the exception to log, including its stack trace.
3273 * @since 2.4
3274 */
3275 void trace(Supplier<?> msgSupplier, Throwable t);
3276
3277 /**
3278 * Logs a message with parameters at trace level.
3279 *
3280 * @param marker the marker data specific to this log statement
3281 * @param message the message to log; the format depends on the message factory.
3282 * @param p0 parameter to the message.
3283 */
3284 void trace(Marker marker, String message, Object p0);
3285
3286 /**
3287 * Logs a message with parameters at trace level.
3288 *
3289 * @param marker the marker data specific to this log statement
3290 * @param message the message to log; the format depends on the message factory.
3291 * @param p0 parameter to the message.
3292 * @param p1 parameter to the message.
3293 */
3294 void trace(Marker marker, String message, Object p0, Object p1);
3295
3296 /**
3297 * Logs a message with parameters at trace level.
3298 *
3299 * @param marker the marker data specific to this log statement
3300 * @param message the message to log; the format depends on the message factory.
3301 * @param p0 parameter to the message.
3302 * @param p1 parameter to the message.
3303 * @param p2 parameter to the message.
3304 */
3305 void trace(Marker marker, String message, Object p0, Object p1, Object p2);
3306
3307 /**
3308 * Logs a message with parameters at trace level.
3309 *
3310 * @param marker the marker data specific to this log statement
3311 * @param message the message to log; the format depends on the message factory.
3312 * @param p0 parameter to the message.
3313 * @param p1 parameter to the message.
3314 * @param p2 parameter to the message.
3315 * @param p3 parameter to the message.
3316 */
3317 void trace(Marker marker, String message, Object p0, Object p1, Object p2, Object p3);
3318
3319 /**
3320 * Logs a message with parameters at trace level.
3321 *
3322 * @param marker the marker data specific to this log statement
3323 * @param message the message to log; the format depends on the message factory.
3324 * @param p0 parameter to the message.
3325 * @param p1 parameter to the message.
3326 * @param p2 parameter to the message.
3327 * @param p3 parameter to the message.
3328 * @param p4 parameter to the message.
3329 */
3330 void trace(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4);
3331
3332 /**
3333 * Logs a message with parameters at trace level.
3334 *
3335 * @param marker the marker data specific to this log statement
3336 * @param message the message to log; the format depends on the message factory.
3337 * @param p0 parameter to the message.
3338 * @param p1 parameter to the message.
3339 * @param p2 parameter to the message.
3340 * @param p3 parameter to the message.
3341 * @param p4 parameter to the message.
3342 * @param p5 parameter to the message.
3343 */
3344 void trace(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5);
3345
3346 /**
3347 * Logs a message with parameters at trace level.
3348 *
3349 * @param marker the marker data specific to this log statement
3350 * @param message the message to log; the format depends on the message factory.
3351 * @param p0 parameter to the message.
3352 * @param p1 parameter to the message.
3353 * @param p2 parameter to the message.
3354 * @param p3 parameter to the message.
3355 * @param p4 parameter to the message.
3356 * @param p5 parameter to the message.
3357 * @param p6 parameter to the message.
3358 */
3359 void trace(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5,
3360 Object p6);
3361
3362 /**
3363 * Logs a message with parameters at trace level.
3364 *
3365 * @param marker the marker data specific to this log statement
3366 * @param message the message to log; the format depends on the message factory.
3367 * @param p0 parameter to the message.
3368 * @param p1 parameter to the message.
3369 * @param p2 parameter to the message.
3370 * @param p3 parameter to the message.
3371 * @param p4 parameter to the message.
3372 * @param p5 parameter to the message.
3373 * @param p6 parameter to the message.
3374 * @param p7 parameter to the message.
3375 */
3376 void trace(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
3377 Object p7);
3378
3379 /**
3380 * Logs a message with parameters at trace level.
3381 *
3382 * @param marker the marker data specific to this log statement
3383 * @param message the message to log; the format depends on the message factory.
3384 * @param p0 parameter to the message.
3385 * @param p1 parameter to the message.
3386 * @param p2 parameter to the message.
3387 * @param p3 parameter to the message.
3388 * @param p4 parameter to the message.
3389 * @param p5 parameter to the message.
3390 * @param p6 parameter to the message.
3391 * @param p7 parameter to the message.
3392 * @param p8 parameter to the message.
3393 */
3394 void trace(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
3395 Object p7, Object p8);
3396
3397 /**
3398 * Logs a message with parameters at trace level.
3399 *
3400 * @param marker the marker data specific to this log statement
3401 * @param message the message to log; the format depends on the message factory.
3402 * @param p0 parameter to the message.
3403 * @param p1 parameter to the message.
3404 * @param p2 parameter to the message.
3405 * @param p3 parameter to the message.
3406 * @param p4 parameter to the message.
3407 * @param p5 parameter to the message.
3408 * @param p6 parameter to the message.
3409 * @param p7 parameter to the message.
3410 * @param p8 parameter to the message.
3411 * @param p9 parameter to the message.
3412 */
3413 void trace(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
3414 Object p7, Object p8, Object p9);
3415
3416 /**
3417 * Logs a message with parameters at trace level.
3418 *
3419 * @param message the message to log; the format depends on the message factory.
3420 * @param p0 parameter to the message.
3421 */
3422 void trace(String message, Object p0);
3423
3424 /**
3425 * Logs a message with parameters at trace level.
3426 *
3427 * @param message the message to log; the format depends on the message factory.
3428 * @param p0 parameter to the message.
3429 * @param p1 parameter to the message.
3430 */
3431 void trace(String message, Object p0, Object p1);
3432
3433 /**
3434 * Logs a message with parameters at trace level.
3435 *
3436 * @param message the message to log; the format depends on the message factory.
3437 * @param p0 parameter to the message.
3438 * @param p1 parameter to the message.
3439 * @param p2 parameter to the message.
3440 */
3441 void trace(String message, Object p0, Object p1, Object p2);
3442
3443 /**
3444 * Logs a message with parameters at trace level.
3445 *
3446 * @param message the message to log; the format depends on the message factory.
3447 * @param p0 parameter to the message.
3448 * @param p1 parameter to the message.
3449 * @param p2 parameter to the message.
3450 * @param p3 parameter to the message.
3451 */
3452 void trace(String message, Object p0, Object p1, Object p2, Object p3);
3453
3454 /**
3455 * Logs a message with parameters at trace level.
3456 *
3457 * @param message the message to log; the format depends on the message factory.
3458 * @param p0 parameter to the message.
3459 * @param p1 parameter to the message.
3460 * @param p2 parameter to the message.
3461 * @param p3 parameter to the message.
3462 * @param p4 parameter to the message.
3463 */
3464 void trace(String message, Object p0, Object p1, Object p2, Object p3, Object p4);
3465
3466 /**
3467 * Logs a message with parameters at trace level.
3468 *
3469 * @param message the message to log; the format depends on the message factory.
3470 * @param p0 parameter to the message.
3471 * @param p1 parameter to the message.
3472 * @param p2 parameter to the message.
3473 * @param p3 parameter to the message.
3474 * @param p4 parameter to the message.
3475 * @param p5 parameter to the message.
3476 */
3477 void trace(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5);
3478
3479 /**
3480 * Logs a message with parameters at trace level.
3481 *
3482 * @param message the message to log; the format depends on the message factory.
3483 * @param p0 parameter to the message.
3484 * @param p1 parameter to the message.
3485 * @param p2 parameter to the message.
3486 * @param p3 parameter to the message.
3487 * @param p4 parameter to the message.
3488 * @param p5 parameter to the message.
3489 * @param p6 parameter to the message.
3490 */
3491 void trace(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6);
3492
3493 /**
3494 * Logs a message with parameters at trace level.
3495 *
3496 * @param message the message to log; the format depends on the message factory.
3497 * @param p0 parameter to the message.
3498 * @param p1 parameter to the message.
3499 * @param p2 parameter to the message.
3500 * @param p3 parameter to the message.
3501 * @param p4 parameter to the message.
3502 * @param p5 parameter to the message.
3503 * @param p6 parameter to the message.
3504 * @param p7 parameter to the message.
3505 */
3506 void trace(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7);
3507
3508 /**
3509 * Logs a message with parameters at trace level.
3510 *
3511 * @param message the message to log; the format depends on the message factory.
3512 * @param p0 parameter to the message.
3513 * @param p1 parameter to the message.
3514 * @param p2 parameter to the message.
3515 * @param p3 parameter to the message.
3516 * @param p4 parameter to the message.
3517 * @param p5 parameter to the message.
3518 * @param p6 parameter to the message.
3519 * @param p7 parameter to the message.
3520 * @param p8 parameter to the message.
3521 */
3522 void trace(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7,
3523 Object p8);
3524
3525 /**
3526 * Logs a message with parameters at trace level.
3527 *
3528 * @param message the message to log; the format depends on the message factory.
3529 * @param p0 parameter to the message.
3530 * @param p1 parameter to the message.
3531 * @param p2 parameter to the message.
3532 * @param p3 parameter to the message.
3533 * @param p4 parameter to the message.
3534 * @param p5 parameter to the message.
3535 * @param p6 parameter to the message.
3536 * @param p7 parameter to the message.
3537 * @param p8 parameter to the message.
3538 * @param p9 parameter to the message.
3539 */
3540 void trace(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7,
3541 Object p8, Object p9);
3542
3543 /**
3544 * Logs entry to a method. Used when the method in question has no parameters or when the parameters should not be
3545 * logged.
3546 *
3547 * @return built message
3548 * @since 2.6
3549 */
3550 EntryMessage traceEntry();
3551
3552 /**
3553 * Logs entry to a method along with its parameters. For example,
3554 *
3555 * <pre>
3556 * public void doSomething(String foo, int bar) {
3557 * LOGGER.traceEntry("Parameters: {} and {}", foo, bar);
3558 * // do something
3559 * }
3560 * </pre>
3561 * or:
3562 * <pre>
3563 * public int doSomething(String foo, int bar) {
3564 * Message m = LOGGER.traceEntry("doSomething(foo={}, bar={})", foo, bar);
3565 * // do something
3566 * return traceExit(m, value);
3567 * }
3568 * </pre>
3569 *
3570 * @param format The format String for the parameters.
3571 * @param params The parameters to the method.
3572 * @return The built Message
3573 *
3574 * @since 2.6
3575 */
3576 EntryMessage traceEntry(String format, Object... params);
3577
3578 /**
3579 * Logs entry to a method along with its parameters. For example,
3580 *
3581 * <pre>
3582 * public void doSomething(Request foo) {
3583 * LOGGER.traceEntry(()->gson.toJson(foo));
3584 * // do something
3585 * }
3586 * </pre>
3587 *
3588 * @param paramSuppliers The Suppliers for the parameters to the method.
3589 * @return built message
3590 *
3591 * @since 2.6
3592 */
3593 EntryMessage traceEntry(Supplier<?>... paramSuppliers);
3594
3595 /**
3596 * Logs entry to a method along with its parameters. For example,
3597 *
3598 * <pre>
3599 * public void doSomething(String foo, int bar) {
3600 * LOGGER.traceEntry("Parameters: {} and {}", ()->gson.toJson(foo), ()-> bar);
3601 * // do something
3602 * }
3603 * </pre>
3604 *
3605 * @param format The format String for the parameters.
3606 * @param paramSuppliers The Suppliers for the parameters to the method.
3607 * @return built message
3608 *
3609 * @since 2.6
3610 */
3611 EntryMessage traceEntry(String format, Supplier<?>... paramSuppliers);
3612
3613 /**
3614 * Logs entry to a method using a Message to describe the parameters.
3615 * <pre>
3616 * public void doSomething(Request foo) {
3617 * LOGGER.traceEntry(new JsonMessage(foo));
3618 * // do something
3619 * }
3620 * </pre>
3621 * <p>
3622 * Avoid passing a {@code ReusableMessage} to this method (therefore, also avoid passing messages created by
3623 * calling {@code logger.getMessageFactory().newMessage("some message")}): Log4j will replace such messages with
3624 * an immutable message to prevent situations where the reused message instance is modified by subsequent calls to
3625 * the logger before the returned {@code EntryMessage} is fully processed.
3626 * </p>
3627 *
3628 * @param message The message. Avoid specifying a ReusableMessage, use immutable messages instead.
3629 * @return the built message
3630 *
3631 * @since 2.6
3632 * @see org.apache.logging.log4j.message.ReusableMessage
3633 */
3634 EntryMessage traceEntry(Message message);
3635
3636 /**
3637 * Logs exit from a method. Used for methods that do not return anything.
3638 *
3639 * @since 2.6
3640 */
3641 void traceExit();
3642
3643 /**
3644 * Logs exiting from a method with the result. This may be coded as:
3645 *
3646 * <pre>
3647 * return LOGGER.traceExit(myResult);
3648 * </pre>
3649 *
3650 * @param <R> The type of the parameter and object being returned.
3651 * @param result The result being returned from the method call.
3652 * @return the result.
3653 *
3654 * @since 2.6
3655 */
3656 <R> R traceExit(R result);
3657
3658 /**
3659 * Logs exiting from a method with the result. This may be coded as:
3660 *
3661 * <pre>
3662 * return LOGGER.traceExit("Result: {}", myResult);
3663 * </pre>
3664 *
3665 * @param <R> The type of the parameter and object being returned.
3666 * @param format The format String for the result.
3667 * @param result The result being returned from the method call.
3668 * @return the result.
3669 *
3670 * @since 2.6
3671 */
3672 <R> R traceExit(String format, R result);
3673
3674 /**
3675 * Logs exiting from a method with no result. Allows custom formatting of the result. This may be coded as:
3676 *
3677 * <pre>
3678 * public long doSomething(int a, int b) {
3679 * EntryMessage m = traceEntry("doSomething(a={}, b={})", a, b);
3680 * // ...
3681 * return LOGGER.traceExit(m);
3682 * }
3683 * </pre>
3684 * @param message The Message containing the formatted result.
3685 *
3686 * @since 2.6
3687 */
3688 void traceExit(EntryMessage message);
3689
3690 /**
3691 * Logs exiting from a method with the result. Allows custom formatting of the result. This may be coded as:
3692 *
3693 * <pre>
3694 * public long doSomething(int a, int b) {
3695 * EntryMessage m = traceEntry("doSomething(a={}, b={})", a, b);
3696 * // ...
3697 * return LOGGER.traceExit(m, myResult);
3698 * }
3699 * </pre>
3700 * @param message The Message containing the formatted result.
3701 * @param result The result being returned from the method call.
3702 *
3703 * @param <R> The type of the parameter and object being returned.
3704 * @return the result.
3705 *
3706 * @since 2.6
3707 */
3708 <R> R traceExit(EntryMessage message, R result);
3709
3710 /**
3711 * Logs exiting from a method with the result. Allows custom formatting of the result. This may be coded as:
3712 *
3713 * <pre>
3714 * return LOGGER.traceExit(new JsonMessage(myResult), myResult);
3715 * </pre>
3716 * @param message The Message containing the formatted result.
3717 * @param result The result being returned from the method call.
3718 *
3719 * @param <R> The type of the parameter and object being returned.
3720 * @return the result.
3721 *
3722 * @since 2.6
3723 */
3724 <R> R traceExit(Message message, R result);
3725
3726 /**
3727 * Logs a message with the specific Marker at the {@link Level#WARN WARN} level.
3728 *
3729 * @param marker the marker data specific to this log statement
3730 * @param msg the message string to be logged
3731 */
3732 void warn(Marker marker, Message msg);
3733
3734 /**
3735 * Logs a message with the specific Marker at the {@link Level#WARN WARN} level.
3736 *
3737 * @param marker the marker data specific to this log statement
3738 * @param msg the message string to be logged
3739 * @param t A Throwable or null.
3740 */
3741 void warn(Marker marker, Message msg, Throwable t);
3742
3743 /**
3744 * Logs a message which is only to be constructed if the logging level is the {@link Level#WARN WARN} level with the
3745 * specified Marker. The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the
3746 * {@code Message}.
3747 *
3748 * @param marker the marker data specific to this log statement
3749 * @param msgSupplier A function, which when called, produces the desired log message.
3750 * @since 2.4
3751 */
3752 void warn(Marker marker, MessageSupplier msgSupplier);
3753
3754 /**
3755 * Logs a message (only to be constructed if the logging level is the {@link Level#WARN WARN} level) with the
3756 * specified Marker and including the stack warn of the {@link Throwable} <code>t</code> passed as parameter. The
3757 * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}.
3758 *
3759 * @param marker the marker data specific to this log statement
3760 * @param msgSupplier A function, which when called, produces the desired log message.
3761 * @param t A Throwable or null.
3762 * @since 2.4
3763 */
3764 void warn(Marker marker, MessageSupplier msgSupplier, Throwable t);
3765
3766 /**
3767 * Logs a message CharSequence with the {@link Level#WARN WARN} level.
3768 *
3769 * @param marker the marker data specific to this log statement
3770 * @param message the message CharSequence to log.
3771 */
3772 void warn(Marker marker, CharSequence message);
3773
3774 /**
3775 * Logs a CharSequence at the {@link Level#WARN WARN} level including the stack trace of the {@link Throwable}
3776 * <code>t</code> passed as parameter.
3777 *
3778 * @param marker the marker data specific to this log statement
3779 * @param message the message CharSequence to log.
3780 * @param t the exception to log, including its stack trace.
3781 */
3782 void warn(Marker marker, CharSequence message, Throwable t);
3783
3784 /**
3785 * Logs a message object with the {@link Level#WARN WARN} level.
3786 *
3787 * @param marker the marker data specific to this log statement
3788 * @param message the message object to log.
3789 */
3790 void warn(Marker marker, Object message);
3791
3792 /**
3793 * Logs a message at the {@link Level#WARN WARN} level including the stack trace of the {@link Throwable}
3794 * <code>t</code> passed as parameter.
3795 *
3796 * @param marker the marker data specific to this log statement
3797 * @param message the message object to log.
3798 * @param t the exception to log, including its stack trace.
3799 */
3800 void warn(Marker marker, Object message, Throwable t);
3801
3802 /**
3803 * Logs a message object with the {@link Level#WARN WARN} level.
3804 *
3805 * @param marker the marker data specific to this log statement
3806 * @param message the message object to log.
3807 */
3808 void warn(Marker marker, String message);
3809
3810 /**
3811 * Logs a message with parameters at the {@link Level#WARN WARN} level.
3812 *
3813 * @param marker the marker data specific to this log statement.
3814 * @param message the message to log; the format depends on the message factory.
3815 * @param params parameters to the message.
3816 * @see #getMessageFactory()
3817 */
3818 void warn(Marker marker, String message, Object... params);
3819
3820 /**
3821 * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#WARN
3822 * WARN} level.
3823 *
3824 * @param marker the marker data specific to this log statement
3825 * @param message the message to log; the format depends on the message factory.
3826 * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters.
3827 * @since 2.4
3828 */
3829 void warn(Marker marker, String message, Supplier<?>... paramSuppliers);
3830
3831 /**
3832 * Logs a message at the {@link Level#WARN WARN} level including the stack trace of the {@link Throwable}
3833 * <code>t</code> passed as parameter.
3834 *
3835 * @param marker the marker data specific to this log statement
3836 * @param message the message object to log.
3837 * @param t the exception to log, including its stack trace.
3838 */
3839 void warn(Marker marker, String message, Throwable t);
3840
3841 /**
3842 * Logs a message which is only to be constructed if the logging level is the {@link Level#WARN WARN} level with the
3843 * specified Marker.
3844 *
3845 * @param marker the marker data specific to this log statement
3846 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
3847 * message factory.
3848 * @since 2.4
3849 */
3850 void warn(Marker marker, Supplier<?> msgSupplier);
3851
3852 /**
3853 * Logs a message (only to be constructed if the logging level is the {@link Level#WARN WARN} level) with the
3854 * specified Marker and including the stack warn of the {@link Throwable} <code>t</code> passed as parameter.
3855 *
3856 * @param marker the marker data specific to this log statement
3857 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
3858 * message factory.
3859 * @param t A Throwable or null.
3860 * @since 2.4
3861 */
3862 void warn(Marker marker, Supplier<?> msgSupplier, Throwable t);
3863
3864 /**
3865 * Logs a message with the specific Marker at the {@link Level#WARN WARN} level.
3866 *
3867 * @param msg the message string to be logged
3868 */
3869 void warn(Message msg);
3870
3871 /**
3872 * Logs a message with the specific Marker at the {@link Level#WARN WARN} level.
3873 *
3874 * @param msg the message string to be logged
3875 * @param t A Throwable or null.
3876 */
3877 void warn(Message msg, Throwable t);
3878
3879 /**
3880 * Logs a message which is only to be constructed if the logging level is the {@link Level#WARN WARN} level. The
3881 * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}.
3882 *
3883 * @param msgSupplier A function, which when called, produces the desired log message.
3884 * @since 2.4
3885 */
3886 void warn(MessageSupplier msgSupplier);
3887
3888 /**
3889 * Logs a message (only to be constructed if the logging level is the {@link Level#WARN WARN} level) including the
3890 * stack warn of the {@link Throwable} <code>t</code> passed as parameter. The {@code MessageSupplier} may or may
3891 * not use the {@link MessageFactory} to construct the {@code Message}.
3892 *
3893 * @param msgSupplier A function, which when called, produces the desired log message.
3894 * @param t the exception to log, including its stack warn.
3895 * @since 2.4
3896 */
3897 void warn(MessageSupplier msgSupplier, Throwable t);
3898
3899 /**
3900 * Logs a message CharSequence with the {@link Level#WARN WARN} level.
3901 *
3902 * @param message the message CharSequence to log.
3903 */
3904 void warn(CharSequence message);
3905
3906 /**
3907 * Logs a CharSequence at the {@link Level#WARN WARN} level including the stack trace of the {@link Throwable}
3908 * <code>t</code> passed as parameter.
3909 *
3910 * @param message the message CharSequence to log.
3911 * @param t the exception to log, including its stack trace.
3912 */
3913 void warn(CharSequence message, Throwable t);
3914
3915 /**
3916 * Logs a message object with the {@link Level#WARN WARN} level.
3917 *
3918 * @param message the message object to log.
3919 */
3920 void warn(Object message);
3921
3922 /**
3923 * Logs a message at the {@link Level#WARN WARN} level including the stack trace of the {@link Throwable}
3924 * <code>t</code> passed as parameter.
3925 *
3926 * @param message the message object to log.
3927 * @param t the exception to log, including its stack trace.
3928 */
3929 void warn(Object message, Throwable t);
3930
3931 /**
3932 * Logs a message object with the {@link Level#WARN WARN} level.
3933 *
3934 * @param message the message string to log.
3935 */
3936 void warn(String message);
3937
3938 /**
3939 * Logs a message with parameters at the {@link Level#WARN WARN} level.
3940 *
3941 * @param message the message to log; the format depends on the message factory.
3942 * @param params parameters to the message.
3943 * @see #getMessageFactory()
3944 */
3945 void warn(String message, Object... params);
3946
3947 /**
3948 * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#WARN
3949 * WARN} level.
3950 *
3951 * @param message the message to log; the format depends on the message factory.
3952 * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters.
3953 * @since 2.4
3954 */
3955 void warn(String message, Supplier<?>... paramSuppliers);
3956
3957 /**
3958 * Logs a message at the {@link Level#WARN WARN} level including the stack trace of the {@link Throwable}
3959 * <code>t</code> passed as parameter.
3960 *
3961 * @param message the message object to log.
3962 * @param t the exception to log, including its stack trace.
3963 */
3964 void warn(String message, Throwable t);
3965
3966 /**
3967 * Logs a message which is only to be constructed if the logging level is the {@link Level#WARN WARN} level.
3968 *
3969 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
3970 * message factory.
3971 * @since 2.4
3972 */
3973 void warn(Supplier<?> msgSupplier);
3974
3975 /**
3976 * Logs a message (only to be constructed if the logging level is the {@link Level#WARN WARN} level) including the
3977 * stack warn of the {@link Throwable} <code>t</code> passed as parameter.
3978 *
3979 * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the
3980 * message factory.
3981 * @param t the exception to log, including its stack warn.
3982 * @since 2.4
3983 */
3984 void warn(Supplier<?> msgSupplier, Throwable t);
3985
3986 /**
3987 * Logs a message with parameters at warn level.
3988 *
3989 * @param marker the marker data specific to this log statement
3990 * @param message the message to log; the format depends on the message factory.
3991 * @param p0 parameter to the message.
3992 */
3993 void warn(Marker marker, String message, Object p0);
3994
3995 /**
3996 * Logs a message with parameters at warn level.
3997 *
3998 * @param marker the marker data specific to this log statement
3999 * @param message the message to log; the format depends on the message factory.
4000 * @param p0 parameter to the message.
4001 * @param p1 parameter to the message.
4002 */
4003 void warn(Marker marker, String message, Object p0, Object p1);
4004
4005 /**
4006 * Logs a message with parameters at warn level.
4007 *
4008 * @param marker the marker data specific to this log statement
4009 * @param message the message to log; the format depends on the message factory.
4010 * @param p0 parameter to the message.
4011 * @param p1 parameter to the message.
4012 * @param p2 parameter to the message.
4013 */
4014 void warn(Marker marker, String message, Object p0, Object p1, Object p2);
4015
4016 /**
4017 * Logs a message with parameters at warn level.
4018 *
4019 * @param marker the marker data specific to this log statement
4020 * @param message the message to log; the format depends on the message factory.
4021 * @param p0 parameter to the message.
4022 * @param p1 parameter to the message.
4023 * @param p2 parameter to the message.
4024 * @param p3 parameter to the message.
4025 */
4026 void warn(Marker marker, String message, Object p0, Object p1, Object p2, Object p3);
4027
4028 /**
4029 * Logs a message with parameters at warn level.
4030 *
4031 * @param marker the marker data specific to this log statement
4032 * @param message the message to log; the format depends on the message factory.
4033 * @param p0 parameter to the message.
4034 * @param p1 parameter to the message.
4035 * @param p2 parameter to the message.
4036 * @param p3 parameter to the message.
4037 * @param p4 parameter to the message.
4038 */
4039 void warn(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4);
4040
4041 /**
4042 * Logs a message with parameters at warn level.
4043 *
4044 * @param marker the marker data specific to this log statement
4045 * @param message the message to log; the format depends on the message factory.
4046 * @param p0 parameter to the message.
4047 * @param p1 parameter to the message.
4048 * @param p2 parameter to the message.
4049 * @param p3 parameter to the message.
4050 * @param p4 parameter to the message.
4051 * @param p5 parameter to the message.
4052 */
4053 void warn(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5);
4054
4055 /**
4056 * Logs a message with parameters at warn level.
4057 *
4058 * @param marker the marker data specific to this log statement
4059 * @param message the message to log; the format depends on the message factory.
4060 * @param p0 parameter to the message.
4061 * @param p1 parameter to the message.
4062 * @param p2 parameter to the message.
4063 * @param p3 parameter to the message.
4064 * @param p4 parameter to the message.
4065 * @param p5 parameter to the message.
4066 * @param p6 parameter to the message.
4067 */
4068 void warn(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5,
4069 Object p6);
4070
4071 /**
4072 * Logs a message with parameters at warn level.
4073 *
4074 * @param marker the marker data specific to this log statement
4075 * @param message the message to log; the format depends on the message factory.
4076 * @param p0 parameter to the message.
4077 * @param p1 parameter to the message.
4078 * @param p2 parameter to the message.
4079 * @param p3 parameter to the message.
4080 * @param p4 parameter to the message.
4081 * @param p5 parameter to the message.
4082 * @param p6 parameter to the message.
4083 * @param p7 parameter to the message.
4084 */
4085 void warn(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
4086 Object p7);
4087
4088 /**
4089 * Logs a message with parameters at warn level.
4090 *
4091 * @param marker the marker data specific to this log statement
4092 * @param message the message to log; the format depends on the message factory.
4093 * @param p0 parameter to the message.
4094 * @param p1 parameter to the message.
4095 * @param p2 parameter to the message.
4096 * @param p3 parameter to the message.
4097 * @param p4 parameter to the message.
4098 * @param p5 parameter to the message.
4099 * @param p6 parameter to the message.
4100 * @param p7 parameter to the message.
4101 * @param p8 parameter to the message.
4102 */
4103 void warn(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
4104 Object p7, Object p8);
4105
4106 /**
4107 * Logs a message with parameters at warn level.
4108 *
4109 * @param marker the marker data specific to this log statement
4110 * @param message the message to log; the format depends on the message factory.
4111 * @param p0 parameter to the message.
4112 * @param p1 parameter to the message.
4113 * @param p2 parameter to the message.
4114 * @param p3 parameter to the message.
4115 * @param p4 parameter to the message.
4116 * @param p5 parameter to the message.
4117 * @param p6 parameter to the message.
4118 * @param p7 parameter to the message.
4119 * @param p8 parameter to the message.
4120 * @param p9 parameter to the message.
4121 */
4122 void warn(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6,
4123 Object p7, Object p8, Object p9);
4124
4125 /**
4126 * Logs a message with parameters at warn level.
4127 *
4128 * @param message the message to log; the format depends on the message factory.
4129 * @param p0 parameter to the message.
4130 */
4131 void warn(String message, Object p0);
4132
4133 /**
4134 * Logs a message with parameters at warn level.
4135 *
4136 * @param message the message to log; the format depends on the message factory.
4137 * @param p0 parameter to the message.
4138 * @param p1 parameter to the message.
4139 */
4140 void warn(String message, Object p0, Object p1);
4141
4142 /**
4143 * Logs a message with parameters at warn level.
4144 *
4145 * @param message the message to log; the format depends on the message factory.
4146 * @param p0 parameter to the message.
4147 * @param p1 parameter to the message.
4148 * @param p2 parameter to the message.
4149 */
4150 void warn(String message, Object p0, Object p1, Object p2);
4151
4152 /**
4153 * Logs a message with parameters at warn level.
4154 *
4155 * @param message the message to log; the format depends on the message factory.
4156 * @param p0 parameter to the message.
4157 * @param p1 parameter to the message.
4158 * @param p2 parameter to the message.
4159 * @param p3 parameter to the message.
4160 */
4161 void warn(String message, Object p0, Object p1, Object p2, Object p3);
4162
4163 /**
4164 * Logs a message with parameters at warn level.
4165 *
4166 * @param message the message to log; the format depends on the message factory.
4167 * @param p0 parameter to the message.
4168 * @param p1 parameter to the message.
4169 * @param p2 parameter to the message.
4170 * @param p3 parameter to the message.
4171 * @param p4 parameter to the message.
4172 */
4173 void warn(String message, Object p0, Object p1, Object p2, Object p3, Object p4);
4174
4175 /**
4176 * Logs a message with parameters at warn level.
4177 *
4178 * @param message the message to log; the format depends on the message factory.
4179 * @param p0 parameter to the message.
4180 * @param p1 parameter to the message.
4181 * @param p2 parameter to the message.
4182 * @param p3 parameter to the message.
4183 * @param p4 parameter to the message.
4184 * @param p5 parameter to the message.
4185 */
4186 void warn(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5);
4187
4188 /**
4189 * Logs a message with parameters at warn level.
4190 *
4191 * @param message the message to log; the format depends on the message factory.
4192 * @param p0 parameter to the message.
4193 * @param p1 parameter to the message.
4194 * @param p2 parameter to the message.
4195 * @param p3 parameter to the message.
4196 * @param p4 parameter to the message.
4197 * @param p5 parameter to the message.
4198 * @param p6 parameter to the message.
4199 */
4200 void warn(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6);
4201
4202 /**
4203 * Logs a message with parameters at warn level.
4204 *
4205 * @param message the message to log; the format depends on the message factory.
4206 * @param p0 parameter to the message.
4207 * @param p1 parameter to the message.
4208 * @param p2 parameter to the message.
4209 * @param p3 parameter to the message.
4210 * @param p4 parameter to the message.
4211 * @param p5 parameter to the message.
4212 * @param p6 parameter to the message.
4213 * @param p7 parameter to the message.
4214 */
4215 void warn(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7);
4216
4217 /**
4218 * Logs a message with parameters at warn level.
4219 *
4220 * @param message the message to log; the format depends on the message factory.
4221 * @param p0 parameter to the message.
4222 * @param p1 parameter to the message.
4223 * @param p2 parameter to the message.
4224 * @param p3 parameter to the message.
4225 * @param p4 parameter to the message.
4226 * @param p5 parameter to the message.
4227 * @param p6 parameter to the message.
4228 * @param p7 parameter to the message.
4229 * @param p8 parameter to the message.
4230 */
4231 void warn(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7,
4232 Object p8);
4233
4234 /**
4235 * Logs a message with parameters at warn level.
4236 *
4237 * @param message the message to log; the format depends on the message factory.
4238 * @param p0 parameter to the message.
4239 * @param p1 parameter to the message.
4240 * @param p2 parameter to the message.
4241 * @param p3 parameter to the message.
4242 * @param p4 parameter to the message.
4243 * @param p5 parameter to the message.
4244 * @param p6 parameter to the message.
4245 * @param p7 parameter to the message.
4246 * @param p8 parameter to the message.
4247 * @param p9 parameter to the message.
4248 */
4249 void warn(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7,
4250 Object p8, Object p9);
4251
4252 }