1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17 package org.apache.logging.log4j.core.appender;
18
19 import java.io.Serializable;
20 import java.util.HashMap;
21 import java.util.Map;
22
23 import org.apache.logging.log4j.core.Filter;
24 import org.apache.logging.log4j.core.Layout;
25 import org.apache.logging.log4j.core.config.Configuration;
26 import org.apache.logging.log4j.core.config.plugins.Plugin;
27 import org.apache.logging.log4j.core.config.plugins.PluginAttribute;
28 import org.apache.logging.log4j.core.config.plugins.PluginConfiguration;
29 import org.apache.logging.log4j.core.config.plugins.PluginElement;
30 import org.apache.logging.log4j.core.config.plugins.PluginFactory;
31 import org.apache.logging.log4j.core.layout.PatternLayout;
32 import org.apache.logging.log4j.core.net.Advertiser;
33 import org.apache.logging.log4j.core.util.Booleans;
34 import org.apache.logging.log4j.core.util.Integers;
35
36
37
38
39 @Plugin(name = "File", category = "Core", elementType = "appender", printObject = true)
40 public final class FileAppender extends AbstractOutputStreamAppender<FileManager> {
41
42 private static final int DEFAULT_BUFFER_SIZE = 8192;
43 private final String fileName;
44 private final Advertiser advertiser;
45 private Object advertisement;
46
47 private FileAppender(final String name, final Layout<? extends Serializable> layout, final Filter filter, final FileManager manager,
48 final String filename, final boolean ignoreExceptions, final boolean immediateFlush,
49 final Advertiser advertiser) {
50 super(name, layout, filter, ignoreExceptions, immediateFlush, manager);
51 if (advertiser != null) {
52 final Map<String, String> configuration = new HashMap<String, String>(layout.getContentFormat());
53 configuration.putAll(manager.getContentFormat());
54 configuration.put("contentType", layout.getContentType());
55 configuration.put("name", name);
56 advertisement = advertiser.advertise(configuration);
57 }
58 this.fileName = filename;
59 this.advertiser = advertiser;
60 }
61
62 @Override
63 public void stop() {
64 super.stop();
65 if (advertiser != null) {
66 advertiser.unadvertise(advertisement);
67 }
68 }
69
70
71
72
73
74 public String getFileName() {
75 return this.fileName;
76 }
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99 @PluginFactory
100 public static FileAppender createAppender(
101
102 @PluginAttribute("fileName") final String fileName,
103 @PluginAttribute("append") final String append,
104 @PluginAttribute("locking") final String locking,
105 @PluginAttribute("name") final String name,
106 @PluginAttribute("immediateFlush") final String immediateFlush,
107 @PluginAttribute("ignoreExceptions") final String ignore,
108 @PluginAttribute("bufferedIo") final String bufferedIo,
109 @PluginAttribute("bufferSize") final String bufferSizeStr,
110 @PluginElement("Layout") Layout<? extends Serializable> layout,
111 @PluginElement("Filters") final Filter filter,
112 @PluginAttribute("advertise") final String advertise,
113 @PluginAttribute("advertiseUri") final String advertiseUri,
114 @PluginConfiguration final Configuration config) {
115
116 final boolean isAppend = Booleans.parseBoolean(append, true);
117 final boolean isLocking = Boolean.parseBoolean(locking);
118 boolean isBuffered = Booleans.parseBoolean(bufferedIo, true);
119 final boolean isAdvertise = Boolean.parseBoolean(advertise);
120 if (isLocking && isBuffered) {
121 if (bufferedIo != null) {
122 LOGGER.warn("Locking and buffering are mutually exclusive. No buffering will occur for " + fileName);
123 }
124 isBuffered = false;
125 }
126 final int bufferSize = Integers.parseInt(bufferSizeStr, DEFAULT_BUFFER_SIZE);
127 if (!isBuffered && bufferSize > 0) {
128 LOGGER.warn("The bufferSize is set to {} but bufferedIO is not true: {}", bufferSize, bufferedIo);
129 }
130 final boolean isFlush = Booleans.parseBoolean(immediateFlush, true);
131 final boolean ignoreExceptions = Booleans.parseBoolean(ignore, true);
132
133 if (name == null) {
134 LOGGER.error("No name provided for FileAppender");
135 return null;
136 }
137
138 if (fileName == null) {
139 LOGGER.error("No filename provided for FileAppender with name " + name);
140 return null;
141 }
142 if (layout == null) {
143 layout = PatternLayout.createDefaultLayout();
144 }
145
146 final FileManager manager = FileManager.getFileManager(fileName, isAppend, isLocking, isBuffered, advertiseUri,
147 layout, bufferSize);
148 if (manager == null) {
149 return null;
150 }
151
152 return new FileAppender(name, layout, filter, manager, fileName, ignoreExceptions, isFlush,
153 isAdvertise ? config.getAdvertiser() : null);
154 }
155 }