1   /**
2    * Logback: the reliable, generic, fast and flexible logging framework.
3    * Copyright (C) 1999-2015, QOS.ch. All rights reserved.
4    *
5    * This program and the accompanying materials are dual-licensed under
6    * either the terms of the Eclipse Public License v1.0 as published by
7    * the Eclipse Foundation
8    *
9    *   or (per the licensee's choosing)
10   *
11   * under the terms of the GNU Lesser General Public License version 2.1
12   * as published by the Free Software Foundation.
13   */
14  package ch.qos.logback.classic;
15  
16  import java.util.HashMap;
17  import java.util.Map;
18  import java.util.function.Supplier;
19  
20  import ch.qos.logback.classic.pattern.*;
21  import ch.qos.logback.classic.pattern.color.HighlightingCompositeConverter;
22  import ch.qos.logback.classic.spi.ILoggingEvent;
23  import ch.qos.logback.core.CoreConstants;
24  import ch.qos.logback.core.pattern.DynamicConverter;
25  import ch.qos.logback.core.pattern.PatternLayoutBase;
26  import ch.qos.logback.core.pattern.color.*;
27  import ch.qos.logback.core.pattern.parser.Parser;
28  
29  /**
30   * <p>
31   * A flexible layout configurable with pattern string. The main method in this class is
32   * to {@link #doLayout(ILoggingEvent)}. It returns the results as a
33   * {#link String}. The format and contents of the result depends on the <em>conversion
34   * pattern</em>.
35   * <p>
36   * For more information about this layout, please refer to the online manual at
37   * http://logback.qos.ch/manual/layouts.html#PatternLayout
38   * 
39   */
40  
41  public class PatternLayout extends PatternLayoutBase<ILoggingEvent> {
42  
43      public static final Map<String, Supplier<DynamicConverter>> DEFAULT_CONVERTER_SUPPLIER_MAP = new HashMap<>();
44  
45      /**
46       * @deprecated replaced by {@link #DEFAULT_CONVERTER_SUPPLIER_MAP}
47       */
48      @Deprecated
49      public static final Map<String, String> DEFAULT_CONVERTER_MAP = new HashMap<>();
50      public static final Map<String, String> CONVERTER_CLASS_TO_KEY_MAP = new HashMap<String, String>();
51  
52      /**
53       * @deprecated replaced by {@link #DEFAULT_CONVERTER_MAP} in turn itself replaced  by
54       * {@link #DEFAULT_CONVERTER_SUPPLIER_MAP}
55       */
56      @Deprecated
57      public static final Map<String, String> defaultConverterMap = DEFAULT_CONVERTER_MAP;
58  
59      public static final String HEADER_PREFIX = "#logback.classic pattern: ";
60  
61      static {
62          DEFAULT_CONVERTER_SUPPLIER_MAP.putAll(Parser.DEFAULT_COMPOSITE_CONVERTER_MAP);
63  
64          DEFAULT_CONVERTER_SUPPLIER_MAP.put("d", DateConverter::new);
65          DEFAULT_CONVERTER_SUPPLIER_MAP.put("date", DateConverter::new);
66          // used by PrefixComposite converter
67          CONVERTER_CLASS_TO_KEY_MAP.put(DateConverter.class.getName(), "date");
68  
69          DEFAULT_CONVERTER_SUPPLIER_MAP.put("ms", MicrosecondConverter::new);
70          DEFAULT_CONVERTER_SUPPLIER_MAP.put("micros", MicrosecondConverter::new);
71          CONVERTER_CLASS_TO_KEY_MAP.put(MicrosecondConverter.class.getName(), "micros");
72  
73          DEFAULT_CONVERTER_SUPPLIER_MAP.put("ep", EpochConverter::new);
74          DEFAULT_CONVERTER_SUPPLIER_MAP.put("epoch", EpochConverter::new);
75          CONVERTER_CLASS_TO_KEY_MAP.put(EpochConverter.class.getName(), "epoch");
76  
77          DEFAULT_CONVERTER_SUPPLIER_MAP.put("r", RelativeTimeConverter::new);
78          DEFAULT_CONVERTER_SUPPLIER_MAP.put("relative", RelativeTimeConverter::new);
79          CONVERTER_CLASS_TO_KEY_MAP.put(RelativeTimeConverter.class.getName(), "relative");
80  
81          DEFAULT_CONVERTER_SUPPLIER_MAP.put("level", LevelConverter::new);
82          DEFAULT_CONVERTER_SUPPLIER_MAP.put("le", LevelConverter::new);
83          DEFAULT_CONVERTER_SUPPLIER_MAP.put("p", LevelConverter::new);
84          CONVERTER_CLASS_TO_KEY_MAP.put(LevelConverter.class.getName(), "level");
85  
86          DEFAULT_CONVERTER_SUPPLIER_MAP.put("t", ThreadConverter::new);
87          DEFAULT_CONVERTER_SUPPLIER_MAP.put("thread", ThreadConverter::new);
88          CONVERTER_CLASS_TO_KEY_MAP.put(ThreadConverter.class.getName(), "thread");
89  
90          DEFAULT_CONVERTER_SUPPLIER_MAP.put("lo", LoggerConverter::new);
91          DEFAULT_CONVERTER_SUPPLIER_MAP.put("logger", LoggerConverter::new);
92          DEFAULT_CONVERTER_SUPPLIER_MAP.put("c", LoggerConverter::new);
93          CONVERTER_CLASS_TO_KEY_MAP.put(LoggerConverter.class.getName(), "logger");
94  
95          DEFAULT_CONVERTER_SUPPLIER_MAP.put("m", MessageConverter::new);
96          DEFAULT_CONVERTER_SUPPLIER_MAP.put("msg", MessageConverter::new);
97          DEFAULT_CONVERTER_SUPPLIER_MAP.put("message", MessageConverter::new);
98          CONVERTER_CLASS_TO_KEY_MAP.put(MessageConverter.class.getName(), "message");
99  
100         DEFAULT_CONVERTER_SUPPLIER_MAP.put("C", ClassOfCallerConverter::new);
101         DEFAULT_CONVERTER_SUPPLIER_MAP.put("class", ClassOfCallerConverter::new);
102         CONVERTER_CLASS_TO_KEY_MAP.put(ClassOfCallerConverter.class.getName(), "class");
103 
104         DEFAULT_CONVERTER_SUPPLIER_MAP.put("M", MethodOfCallerConverter::new);
105         DEFAULT_CONVERTER_SUPPLIER_MAP.put("method", MethodOfCallerConverter::new);
106         CONVERTER_CLASS_TO_KEY_MAP.put(MethodOfCallerConverter.class.getName(), "method");
107 
108         DEFAULT_CONVERTER_SUPPLIER_MAP.put("L", LineOfCallerConverter::new);
109         DEFAULT_CONVERTER_SUPPLIER_MAP.put("line", LineOfCallerConverter::new);
110         CONVERTER_CLASS_TO_KEY_MAP.put(LineOfCallerConverter.class.getName(), "line");
111 
112         DEFAULT_CONVERTER_SUPPLIER_MAP.put("F", FileOfCallerConverter::new);
113         DEFAULT_CONVERTER_SUPPLIER_MAP.put("file", FileOfCallerConverter::new);
114         CONVERTER_CLASS_TO_KEY_MAP.put(FileOfCallerConverter.class.getName(), "file");
115 
116         DEFAULT_CONVERTER_SUPPLIER_MAP.put("X", MDCConverter::new);
117         DEFAULT_CONVERTER_SUPPLIER_MAP.put("mdc", MDCConverter::new);
118 
119         DEFAULT_CONVERTER_SUPPLIER_MAP.put("ex", ThrowableProxyConverter::new);
120         DEFAULT_CONVERTER_SUPPLIER_MAP.put("exception", ThrowableProxyConverter::new);
121         DEFAULT_CONVERTER_SUPPLIER_MAP.put("rEx", RootCauseFirstThrowableProxyConverter::new);
122         DEFAULT_CONVERTER_SUPPLIER_MAP.put("rootException", RootCauseFirstThrowableProxyConverter::new);
123         DEFAULT_CONVERTER_SUPPLIER_MAP.put("throwable", ThrowableProxyConverter::new);
124 
125         DEFAULT_CONVERTER_SUPPLIER_MAP.put("xEx", ExtendedThrowableProxyConverter::new);
126         DEFAULT_CONVERTER_SUPPLIER_MAP.put("xException", ExtendedThrowableProxyConverter::new);
127         DEFAULT_CONVERTER_SUPPLIER_MAP.put("xThrowable", ExtendedThrowableProxyConverter::new);
128 
129         DEFAULT_CONVERTER_SUPPLIER_MAP.put("nopex", NopThrowableInformationConverter::new);
130         DEFAULT_CONVERTER_SUPPLIER_MAP.put("nopexception", NopThrowableInformationConverter::new);
131 
132         DEFAULT_CONVERTER_SUPPLIER_MAP.put("cn", ContextNameConverter::new);
133         DEFAULT_CONVERTER_SUPPLIER_MAP.put("contextName", ContextNameConverter::new);
134         CONVERTER_CLASS_TO_KEY_MAP.put(ContextNameConverter.class.getName(), "contextName");
135 
136         DEFAULT_CONVERTER_SUPPLIER_MAP.put("caller", CallerDataConverter::new);
137         CONVERTER_CLASS_TO_KEY_MAP.put(CallerDataConverter.class.getName(), "caller");
138 
139         DEFAULT_CONVERTER_SUPPLIER_MAP.put("marker", MarkerConverter::new);
140         CONVERTER_CLASS_TO_KEY_MAP.put(MarkerConverter.class.getName(), "marker");
141 
142         DEFAULT_CONVERTER_SUPPLIER_MAP.put("kvp", KeyValuePairConverter::new);
143         CONVERTER_CLASS_TO_KEY_MAP.put(KeyValuePairConverter.class.getName(), "kvp");
144 
145         DEFAULT_CONVERTER_SUPPLIER_MAP.put("maskedKvp", MaskedKeyValuePairConverter::new);
146         CONVERTER_CLASS_TO_KEY_MAP.put(MaskedKeyValuePairConverter.class.getName(), "maskedKvp");
147 
148         DEFAULT_CONVERTER_SUPPLIER_MAP.put("property", PropertyConverter::new);
149 
150         DEFAULT_CONVERTER_SUPPLIER_MAP.put("n", LineSeparatorConverter::new);
151 
152         DEFAULT_CONVERTER_SUPPLIER_MAP.put("black", BlackCompositeConverter::new);
153         DEFAULT_CONVERTER_SUPPLIER_MAP.put("red", RedCompositeConverter::new);
154         DEFAULT_CONVERTER_SUPPLIER_MAP.put("green", GreenCompositeConverter::new);
155         DEFAULT_CONVERTER_SUPPLIER_MAP.put("yellow", YellowCompositeConverter::new);
156         DEFAULT_CONVERTER_SUPPLIER_MAP.put("blue", BlueCompositeConverter::new);
157         DEFAULT_CONVERTER_SUPPLIER_MAP.put("magenta", MagentaCompositeConverter::new);
158         DEFAULT_CONVERTER_SUPPLIER_MAP.put("cyan", CyanCompositeConverter::new);
159         DEFAULT_CONVERTER_SUPPLIER_MAP.put("white", WhiteCompositeConverter::new);
160         DEFAULT_CONVERTER_SUPPLIER_MAP.put("gray", GrayCompositeConverter::new);
161         DEFAULT_CONVERTER_SUPPLIER_MAP.put("boldRed", BoldRedCompositeConverter::new);
162         DEFAULT_CONVERTER_SUPPLIER_MAP.put("boldGreen", BoldGreenCompositeConverter::new);
163         DEFAULT_CONVERTER_SUPPLIER_MAP.put("boldYellow", BoldYellowCompositeConverter::new);
164         DEFAULT_CONVERTER_SUPPLIER_MAP.put("boldBlue", BoldBlueCompositeConverter::new);
165         DEFAULT_CONVERTER_SUPPLIER_MAP.put("boldMagenta", BoldMagentaCompositeConverter::new);
166         DEFAULT_CONVERTER_SUPPLIER_MAP.put("boldCyan", BoldCyanCompositeConverter::new);
167         DEFAULT_CONVERTER_SUPPLIER_MAP.put("boldWhite", BoldWhiteCompositeConverter::new);
168         DEFAULT_CONVERTER_SUPPLIER_MAP.put("highlight", HighlightingCompositeConverter::new);
169 
170         DEFAULT_CONVERTER_SUPPLIER_MAP.put("lsn", LocalSequenceNumberConverter::new);
171         CONVERTER_CLASS_TO_KEY_MAP.put(LocalSequenceNumberConverter.class.getName(), "lsn");
172 
173         DEFAULT_CONVERTER_SUPPLIER_MAP.put("sn", SequenceNumberConverter::new);
174         DEFAULT_CONVERTER_SUPPLIER_MAP.put("sequenceNumber", SequenceNumberConverter::new);
175         CONVERTER_CLASS_TO_KEY_MAP.put(SequenceNumberConverter.class.getName(), "sequenceNumber");
176 
177         DEFAULT_CONVERTER_SUPPLIER_MAP.put("prefix", PrefixCompositeConverter::new);
178 
179     }
180 
181     public PatternLayout() {
182         this.postCompileProcessor = new EnsureExceptionHandling();
183     }
184 
185     public Map<String, Supplier<DynamicConverter>> getDefaultConverterSupplierMap() {
186         return DEFAULT_CONVERTER_SUPPLIER_MAP;
187     }
188 
189     /**
190      * <p>BEWARE: The map of type String,String for mapping conversion words is deprecated.
191      * Use {@link #getDefaultConverterSupplierMap()} instead.</p>
192      *
193      * <p>Existing code such as getDefaultMap().put("k", X.class.getName()) should be replaced by
194      * getDefaultConverterSupplierMap().put("k", X::new) </p>
195      *
196      * <p>Note that values in the map will still be taken into account and processed correctly.</p>
197      *
198      * @return a map of keys and class names
199      */
200     @Deprecated
201     public Map<String, String> getDefaultConverterMap() {
202         return DEFAULT_CONVERTER_MAP;
203     }
204 
205     public String doLayout(ILoggingEvent event) {
206         if (!isStarted()) {
207             return CoreConstants.EMPTY_STRING;
208         }
209         return writeLoopOnConverters(event);
210     }
211 
212     @Override
213     protected String getPresentationHeaderPrefix() {
214         return HEADER_PREFIX;
215     }
216 }