001: /* ====================================================================
002: Licensed to the Apache Software Foundation (ASF) under one or more
003: contributor license agreements. See the NOTICE file distributed with
004: this work for additional information regarding copyright ownership.
005: The ASF licenses this file to You under the Apache License, Version 2.0
006: (the "License"); you may not use this file except in compliance with
007: the License. You may obtain a copy of the License at
008:
009: http://www.apache.org/licenses/LICENSE-2.0
010:
011: Unless required by applicable law or agreed to in writing, software
012: distributed under the License is distributed on an "AS IS" BASIS,
013: WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014: See the License for the specific language governing permissions and
015: limitations under the License.
016: ==================================================================== */
017:
018: package org.apache.poi.util;
019:
020: import java.util.*;
021:
022: /**
023: * A logger class that strives to make it as easy as possible for
024: * developers to write log calls, while simultaneously making those
025: * calls as cheap as possible by performing lazy evaluation of the log
026: * message.<p>
027: *
028: * @author Marc Johnson (mjohnson at apache dot org)
029: * @author Glen Stampoultzis (glens at apache.org)
030: * @author Nicola Ken Barozzi (nicolaken at apache.org)
031: */
032:
033: public class NullLogger extends POILogger {
034: public void initialize(final String cat) {
035: //do nothing
036: }
037:
038: /**
039: * Log a message
040: *
041: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
042: * @param obj1 The object to log.
043: */
044:
045: public void log(final int level, final Object obj1) {
046: //do nothing
047: }
048:
049: /**
050: * Check if a logger is enabled to log at the specified level
051: *
052: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
053: */
054:
055: public boolean check(final int level) {
056: return false;
057: }
058:
059: /**
060: * Log a message. Lazily appends Object parameters together.
061: *
062: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
063: * @param obj1 first object to place in the message
064: * @param obj2 second object to place in the message
065: */
066:
067: public void log(final int level, final Object obj1,
068: final Object obj2) {
069: //do nothing
070: }
071:
072: /**
073: * Log a message. Lazily appends Object parameters together.
074: *
075: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
076: * @param obj1 first Object to place in the message
077: * @param obj2 second Object to place in the message
078: * @param obj3 third Object to place in the message
079: */
080:
081: public void log(final int level, final Object obj1,
082: final Object obj2, final Object obj3) {
083: //do nothing
084: }
085:
086: /**
087: * Log a message. Lazily appends Object parameters together.
088: *
089: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
090: * @param obj1 first Object to place in the message
091: * @param obj2 second Object to place in the message
092: * @param obj3 third Object to place in the message
093: * @param obj4 fourth Object to place in the message
094: */
095:
096: public void log(final int level, final Object obj1,
097: final Object obj2, final Object obj3, final Object obj4) {
098: //do nothing
099: }
100:
101: /**
102: * Log a message. Lazily appends Object parameters together.
103: *
104: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
105: * @param obj1 first Object to place in the message
106: * @param obj2 second Object to place in the message
107: * @param obj3 third Object to place in the message
108: * @param obj4 fourth Object to place in the message
109: * @param obj5 fifth Object to place in the message
110: */
111:
112: public void log(final int level, final Object obj1,
113: final Object obj2, final Object obj3, final Object obj4,
114: final Object obj5) {
115: //do nothing
116: }
117:
118: /**
119: * Log a message. Lazily appends Object parameters together.
120: *
121: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
122: * @param obj1 first Object to place in the message
123: * @param obj2 second Object to place in the message
124: * @param obj3 third Object to place in the message
125: * @param obj4 fourth Object to place in the message
126: * @param obj5 fifth Object to place in the message
127: * @param obj6 sixth Object to place in the message
128: */
129:
130: public void log(final int level, final Object obj1,
131: final Object obj2, final Object obj3, final Object obj4,
132: final Object obj5, final Object obj6) {
133: //do nothing
134: }
135:
136: /**
137: * Log a message. Lazily appends Object parameters together.
138: *
139: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
140: * @param obj1 first Object to place in the message
141: * @param obj2 second Object to place in the message
142: * @param obj3 third Object to place in the message
143: * @param obj4 fourth Object to place in the message
144: * @param obj5 fifth Object to place in the message
145: * @param obj6 sixth Object to place in the message
146: * @param obj7 seventh Object to place in the message
147: */
148:
149: public void log(final int level, final Object obj1,
150: final Object obj2, final Object obj3, final Object obj4,
151: final Object obj5, final Object obj6, final Object obj7) {
152: //do nothing
153: }
154:
155: /**
156: * Log a message. Lazily appends Object parameters together.
157: *
158: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
159: * @param obj1 first Object to place in the message
160: * @param obj2 second Object to place in the message
161: * @param obj3 third Object to place in the message
162: * @param obj4 fourth Object to place in the message
163: * @param obj5 fifth Object to place in the message
164: * @param obj6 sixth Object to place in the message
165: * @param obj7 seventh Object to place in the message
166: * @param obj8 eighth Object to place in the message
167: */
168:
169: public void log(final int level, final Object obj1,
170: final Object obj2, final Object obj3, final Object obj4,
171: final Object obj5, final Object obj6, final Object obj7,
172: final Object obj8) {
173: //do nothing
174: }
175:
176: /**
177: * Log a message
178: *
179: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
180: * @param obj1 The object to log. This is converted to a string.
181: * @param exception An exception to be logged
182: */
183:
184: public void log(final int level, final Object obj1,
185: final Throwable exception) {
186: //do nothing
187: }
188:
189: /**
190: * Log a message. Lazily appends Object parameters together.
191: *
192: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
193: * @param obj1 first Object to place in the message
194: * @param obj2 second Object to place in the message
195: * @param exception An exception to be logged
196: */
197:
198: public void log(final int level, final Object obj1,
199: final Object obj2, final Throwable exception) {
200: //do nothing
201: }
202:
203: /**
204: * Log a message. Lazily appends Object parameters together.
205: *
206: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
207: * @param obj1 first Object to place in the message
208: * @param obj2 second Object to place in the message
209: * @param obj3 third object to place in the message
210: * @param exception An error message to be logged
211: */
212:
213: public void log(final int level, final Object obj1,
214: final Object obj2, final Object obj3,
215: final Throwable exception) {
216: //do nothing
217: }
218:
219: /**
220: * Log a message. Lazily appends Object parameters together.
221: *
222: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
223: * @param obj1 first Object to place in the message
224: * @param obj2 second Object to place in the message
225: * @param obj3 third object to place in the message
226: * @param obj4 fourth object to place in the message
227: * @param exception An exception to be logged
228: */
229:
230: public void log(final int level, final Object obj1,
231: final Object obj2, final Object obj3, final Object obj4,
232: final Throwable exception) {
233: //do nothing
234: }
235:
236: /**
237: * Log a message. Lazily appends Object parameters together.
238: *
239: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
240: * @param obj1 first Object to place in the message
241: * @param obj2 second Object to place in the message
242: * @param obj3 third object to place in the message
243: * @param obj4 fourth object to place in the message
244: * @param obj5 fifth object to place in the message
245: * @param exception An exception to be logged
246: */
247:
248: public void log(final int level, final Object obj1,
249: final Object obj2, final Object obj3, final Object obj4,
250: final Object obj5, final Throwable exception) {
251: //do nothing
252: }
253:
254: /**
255: * Log a message. Lazily appends Object parameters together.
256: *
257: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
258: * @param obj1 first Object to place in the message
259: * @param obj2 second Object to place in the message
260: * @param obj3 third object to place in the message
261: * @param obj4 fourth object to place in the message
262: * @param obj5 fifth object to place in the message
263: * @param obj6 sixth object to place in the message
264: * @param exception An exception to be logged
265: */
266:
267: public void log(final int level, final Object obj1,
268: final Object obj2, final Object obj3, final Object obj4,
269: final Object obj5, final Object obj6,
270: final Throwable exception) {
271: //do nothing
272: }
273:
274: /**
275: * Log a message. Lazily appends Object parameters together.
276: *
277: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
278: * @param obj1 first Object to place in the message
279: * @param obj2 second Object to place in the message
280: * @param obj3 third object to place in the message
281: * @param obj4 fourth object to place in the message
282: * @param obj5 fifth object to place in the message
283: * @param obj6 sixth object to place in the message
284: * @param obj7 seventh object to place in the message
285: * @param exception An exception to be logged
286: */
287:
288: public void log(final int level, final Object obj1,
289: final Object obj2, final Object obj3, final Object obj4,
290: final Object obj5, final Object obj6, final Object obj7,
291: final Throwable exception) {
292: //do nothing
293: }
294:
295: /**
296: * Log a message. Lazily appends Object parameters together.
297: *
298: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
299: * @param obj1 first Object to place in the message
300: * @param obj2 second Object to place in the message
301: * @param obj3 third object to place in the message
302: * @param obj4 fourth object to place in the message
303: * @param obj5 fifth object to place in the message
304: * @param obj6 sixth object to place in the message
305: * @param obj7 seventh object to place in the message
306: * @param obj8 eighth object to place in the message
307: * @param exception An exception to be logged
308: */
309:
310: public void log(final int level, final Object obj1,
311: final Object obj2, final Object obj3, final Object obj4,
312: final Object obj5, final Object obj6, final Object obj7,
313: final Object obj8, final Throwable exception) {
314: //do nothing
315: }
316:
317: /**
318: * Logs a formated message. The message itself may contain %
319: * characters as place holders. This routine will attempt to match
320: * the placeholder by looking at the type of parameter passed to
321: * obj1.<p>
322: *
323: * If the parameter is an array, it traverses the array first and
324: * matches parameters sequentially against the array items.
325: * Otherwise the parameters after <code>message</code> are matched
326: * in order.<p>
327: *
328: * If the place holder matches against a number it is printed as a
329: * whole number. This can be overridden by specifying a precision
330: * in the form %n.m where n is the padding for the whole part and
331: * m is the number of decimal places to display. n can be excluded
332: * if desired. n and m may not be more than 9.<p>
333: *
334: * If the last parameter (after flattening) is a Throwable it is
335: * logged specially.
336: *
337: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
338: * @param message The message to log.
339: * @param obj1 The first object to match against.
340: */
341:
342: public void logFormatted(final int level, final String message,
343: final Object obj1) {
344: //do nothing
345: }
346:
347: /**
348: * Logs a formated message. The message itself may contain %
349: * characters as place holders. This routine will attempt to match
350: * the placeholder by looking at the type of parameter passed to
351: * obj1.<p>
352: *
353: * If the parameter is an array, it traverses the array first and
354: * matches parameters sequentially against the array items.
355: * Otherwise the parameters after <code>message</code> are matched
356: * in order.<p>
357: *
358: * If the place holder matches against a number it is printed as a
359: * whole number. This can be overridden by specifying a precision
360: * in the form %n.m where n is the padding for the whole part and
361: * m is the number of decimal places to display. n can be excluded
362: * if desired. n and m may not be more than 9.<p>
363: *
364: * If the last parameter (after flattening) is a Throwable it is
365: * logged specially.
366: *
367: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
368: * @param message The message to log.
369: * @param obj1 The first object to match against.
370: * @param obj2 The second object to match against.
371: */
372:
373: public void logFormatted(final int level, final String message,
374: final Object obj1, final Object obj2) {
375: //do nothing
376: }
377:
378: /**
379: * Logs a formated message. The message itself may contain %
380: * characters as place holders. This routine will attempt to match
381: * the placeholder by looking at the type of parameter passed to
382: * obj1.<p>
383: *
384: * If the parameter is an array, it traverses the array first and
385: * matches parameters sequentially against the array items.
386: * Otherwise the parameters after <code>message</code> are matched
387: * in order.<p>
388: *
389: * If the place holder matches against a number it is printed as a
390: * whole number. This can be overridden by specifying a precision
391: * in the form %n.m where n is the padding for the whole part and
392: * m is the number of decimal places to display. n can be excluded
393: * if desired. n and m may not be more than 9.<p>
394: *
395: * If the last parameter (after flattening) is a Throwable it is
396: * logged specially.
397: *
398: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
399: * @param message The message to log.
400: * @param obj1 The first object to match against.
401: * @param obj2 The second object to match against.
402: * @param obj3 The third object to match against.
403: */
404:
405: public void logFormatted(final int level, final String message,
406: final Object obj1, final Object obj2, final Object obj3) {
407: //do nothing
408: }
409:
410: /**
411: * Logs a formated message. The message itself may contain %
412: * characters as place holders. This routine will attempt to match
413: * the placeholder by looking at the type of parameter passed to
414: * obj1.<p>
415: *
416: * If the parameter is an array, it traverses the array first and
417: * matches parameters sequentially against the array items.
418: * Otherwise the parameters after <code>message</code> are matched
419: * in order.<p>
420: *
421: * If the place holder matches against a number it is printed as a
422: * whole number. This can be overridden by specifying a precision
423: * in the form %n.m where n is the padding for the whole part and
424: * m is the number of decimal places to display. n can be excluded
425: * if desired. n and m may not be more than 9.<p>
426: *
427: * If the last parameter (after flattening) is a Throwable it is
428: * logged specially.
429: *
430: * @param level One of DEBUG, INFO, WARN, ERROR, FATAL
431: * @param message The message to log.
432: * @param obj1 The first object to match against.
433: * @param obj2 The second object to match against.
434: * @param obj3 The third object to match against.
435: * @param obj4 The forth object to match against.
436: */
437:
438: public void logFormatted(final int level, final String message,
439: final Object obj1, final Object obj2, final Object obj3,
440: final Object obj4) {
441: //do nothing
442: }
443:
444: }
|