| |
| /* ==================================================================== |
| Licensed to the Apache Software Foundation (ASF) under one or more |
| contributor license agreements. See the NOTICE file distributed with |
| this work for additional information regarding copyright ownership. |
| The ASF licenses this file to You under the Apache License, Version 2.0 |
| (the "License"); you may not use this file except in compliance with |
| the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| ==================================================================== */ |
| |
| |
| package org.apache.poi.util; |
| |
| import java.util.*; |
| |
| /** |
| * A logger class that strives to make it as easy as possible for |
| * developers to write log calls, while simultaneously making those |
| * calls as cheap as possible by performing lazy evaluation of the log |
| * message.<p> |
| * |
| * @author Marc Johnson (mjohnson at apache dot org) |
| * @author Glen Stampoultzis (glens at apache.org) |
| * @author Nicola Ken Barozzi (nicolaken at apache.org) |
| */ |
| |
| public class NullLogger extends POILogger |
| { |
| public void initialize(final String cat) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 The object to log. |
| */ |
| |
| public void log(final int level, final Object obj1) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Check if a logger is enabled to log at the specified level |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| */ |
| |
| public boolean check(final int level) |
| { |
| return false; |
| } |
| |
| /** |
| * Log a message. Lazily appends Object parameters together. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 first object to place in the message |
| * @param obj2 second object to place in the message |
| */ |
| |
| public void log(final int level, final Object obj1, final Object obj2) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message. Lazily appends Object parameters together. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 first Object to place in the message |
| * @param obj2 second Object to place in the message |
| * @param obj3 third Object to place in the message |
| */ |
| |
| public void log(final int level, final Object obj1, final Object obj2, |
| final Object obj3) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message. Lazily appends Object parameters together. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 first Object to place in the message |
| * @param obj2 second Object to place in the message |
| * @param obj3 third Object to place in the message |
| * @param obj4 fourth Object to place in the message |
| */ |
| |
| public void log(final int level, final Object obj1, final Object obj2, |
| final Object obj3, final Object obj4) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message. Lazily appends Object parameters together. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 first Object to place in the message |
| * @param obj2 second Object to place in the message |
| * @param obj3 third Object to place in the message |
| * @param obj4 fourth Object to place in the message |
| * @param obj5 fifth Object to place in the message |
| */ |
| |
| public void log(final int level, final Object obj1, final Object obj2, |
| final Object obj3, final Object obj4, final Object obj5) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message. Lazily appends Object parameters together. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 first Object to place in the message |
| * @param obj2 second Object to place in the message |
| * @param obj3 third Object to place in the message |
| * @param obj4 fourth Object to place in the message |
| * @param obj5 fifth Object to place in the message |
| * @param obj6 sixth Object to place in the message |
| */ |
| |
| public void log(final int level, final Object obj1, final Object obj2, |
| final Object obj3, final Object obj4, final Object obj5, |
| final Object obj6) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message. Lazily appends Object parameters together. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 first Object to place in the message |
| * @param obj2 second Object to place in the message |
| * @param obj3 third Object to place in the message |
| * @param obj4 fourth Object to place in the message |
| * @param obj5 fifth Object to place in the message |
| * @param obj6 sixth Object to place in the message |
| * @param obj7 seventh Object to place in the message |
| */ |
| |
| public void log(final int level, final Object obj1, final Object obj2, |
| final Object obj3, final Object obj4, final Object obj5, |
| final Object obj6, final Object obj7) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message. Lazily appends Object parameters together. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 first Object to place in the message |
| * @param obj2 second Object to place in the message |
| * @param obj3 third Object to place in the message |
| * @param obj4 fourth Object to place in the message |
| * @param obj5 fifth Object to place in the message |
| * @param obj6 sixth Object to place in the message |
| * @param obj7 seventh Object to place in the message |
| * @param obj8 eighth Object to place in the message |
| */ |
| |
| public void log(final int level, final Object obj1, final Object obj2, |
| final Object obj3, final Object obj4, final Object obj5, |
| final Object obj6, final Object obj7, final Object obj8) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 The object to log. This is converted to a string. |
| * @param exception An exception to be logged |
| */ |
| |
| public void log(final int level, final Object obj1, |
| final Throwable exception) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message. Lazily appends Object parameters together. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 first Object to place in the message |
| * @param obj2 second Object to place in the message |
| * @param exception An exception to be logged |
| */ |
| |
| public void log(final int level, final Object obj1, final Object obj2, |
| final Throwable exception) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message. Lazily appends Object parameters together. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 first Object to place in the message |
| * @param obj2 second Object to place in the message |
| * @param obj3 third object to place in the message |
| * @param exception An error message to be logged |
| */ |
| |
| public void log(final int level, final Object obj1, final Object obj2, |
| final Object obj3, final Throwable exception) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message. Lazily appends Object parameters together. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 first Object to place in the message |
| * @param obj2 second Object to place in the message |
| * @param obj3 third object to place in the message |
| * @param obj4 fourth object to place in the message |
| * @param exception An exception to be logged |
| */ |
| |
| public void log(final int level, final Object obj1, final Object obj2, |
| final Object obj3, final Object obj4, |
| final Throwable exception) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message. Lazily appends Object parameters together. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 first Object to place in the message |
| * @param obj2 second Object to place in the message |
| * @param obj3 third object to place in the message |
| * @param obj4 fourth object to place in the message |
| * @param obj5 fifth object to place in the message |
| * @param exception An exception to be logged |
| */ |
| |
| public void log(final int level, final Object obj1, final Object obj2, |
| final Object obj3, final Object obj4, final Object obj5, |
| final Throwable exception) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message. Lazily appends Object parameters together. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 first Object to place in the message |
| * @param obj2 second Object to place in the message |
| * @param obj3 third object to place in the message |
| * @param obj4 fourth object to place in the message |
| * @param obj5 fifth object to place in the message |
| * @param obj6 sixth object to place in the message |
| * @param exception An exception to be logged |
| */ |
| |
| public void log(final int level, final Object obj1, final Object obj2, |
| final Object obj3, final Object obj4, final Object obj5, |
| final Object obj6, final Throwable exception) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message. Lazily appends Object parameters together. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 first Object to place in the message |
| * @param obj2 second Object to place in the message |
| * @param obj3 third object to place in the message |
| * @param obj4 fourth object to place in the message |
| * @param obj5 fifth object to place in the message |
| * @param obj6 sixth object to place in the message |
| * @param obj7 seventh object to place in the message |
| * @param exception An exception to be logged |
| */ |
| |
| public void log(final int level, final Object obj1, final Object obj2, |
| final Object obj3, final Object obj4, final Object obj5, |
| final Object obj6, final Object obj7, |
| final Throwable exception) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Log a message. Lazily appends Object parameters together. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param obj1 first Object to place in the message |
| * @param obj2 second Object to place in the message |
| * @param obj3 third object to place in the message |
| * @param obj4 fourth object to place in the message |
| * @param obj5 fifth object to place in the message |
| * @param obj6 sixth object to place in the message |
| * @param obj7 seventh object to place in the message |
| * @param obj8 eighth object to place in the message |
| * @param exception An exception to be logged |
| */ |
| |
| public void log(final int level, final Object obj1, final Object obj2, |
| final Object obj3, final Object obj4, final Object obj5, |
| final Object obj6, final Object obj7, final Object obj8, |
| final Throwable exception) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Logs a formated message. The message itself may contain % |
| * characters as place holders. This routine will attempt to match |
| * the placeholder by looking at the type of parameter passed to |
| * obj1.<p> |
| * |
| * If the parameter is an array, it traverses the array first and |
| * matches parameters sequentially against the array items. |
| * Otherwise the parameters after <code>message</code> are matched |
| * in order.<p> |
| * |
| * If the place holder matches against a number it is printed as a |
| * whole number. This can be overridden by specifying a precision |
| * in the form %n.m where n is the padding for the whole part and |
| * m is the number of decimal places to display. n can be excluded |
| * if desired. n and m may not be more than 9.<p> |
| * |
| * If the last parameter (after flattening) is a Throwable it is |
| * logged specially. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param message The message to log. |
| * @param obj1 The first object to match against. |
| */ |
| |
| public void logFormatted(final int level, final String message, |
| final Object obj1) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Logs a formated message. The message itself may contain % |
| * characters as place holders. This routine will attempt to match |
| * the placeholder by looking at the type of parameter passed to |
| * obj1.<p> |
| * |
| * If the parameter is an array, it traverses the array first and |
| * matches parameters sequentially against the array items. |
| * Otherwise the parameters after <code>message</code> are matched |
| * in order.<p> |
| * |
| * If the place holder matches against a number it is printed as a |
| * whole number. This can be overridden by specifying a precision |
| * in the form %n.m where n is the padding for the whole part and |
| * m is the number of decimal places to display. n can be excluded |
| * if desired. n and m may not be more than 9.<p> |
| * |
| * If the last parameter (after flattening) is a Throwable it is |
| * logged specially. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param message The message to log. |
| * @param obj1 The first object to match against. |
| * @param obj2 The second object to match against. |
| */ |
| |
| public void logFormatted(final int level, final String message, |
| final Object obj1, final Object obj2) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Logs a formated message. The message itself may contain % |
| * characters as place holders. This routine will attempt to match |
| * the placeholder by looking at the type of parameter passed to |
| * obj1.<p> |
| * |
| * If the parameter is an array, it traverses the array first and |
| * matches parameters sequentially against the array items. |
| * Otherwise the parameters after <code>message</code> are matched |
| * in order.<p> |
| * |
| * If the place holder matches against a number it is printed as a |
| * whole number. This can be overridden by specifying a precision |
| * in the form %n.m where n is the padding for the whole part and |
| * m is the number of decimal places to display. n can be excluded |
| * if desired. n and m may not be more than 9.<p> |
| * |
| * If the last parameter (after flattening) is a Throwable it is |
| * logged specially. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param message The message to log. |
| * @param obj1 The first object to match against. |
| * @param obj2 The second object to match against. |
| * @param obj3 The third object to match against. |
| */ |
| |
| public void logFormatted(final int level, final String message, |
| final Object obj1, final Object obj2, |
| final Object obj3) |
| { |
| //do nothing |
| } |
| |
| /** |
| * Logs a formated message. The message itself may contain % |
| * characters as place holders. This routine will attempt to match |
| * the placeholder by looking at the type of parameter passed to |
| * obj1.<p> |
| * |
| * If the parameter is an array, it traverses the array first and |
| * matches parameters sequentially against the array items. |
| * Otherwise the parameters after <code>message</code> are matched |
| * in order.<p> |
| * |
| * If the place holder matches against a number it is printed as a |
| * whole number. This can be overridden by specifying a precision |
| * in the form %n.m where n is the padding for the whole part and |
| * m is the number of decimal places to display. n can be excluded |
| * if desired. n and m may not be more than 9.<p> |
| * |
| * If the last parameter (after flattening) is a Throwable it is |
| * logged specially. |
| * |
| * @param level One of DEBUG, INFO, WARN, ERROR, FATAL |
| * @param message The message to log. |
| * @param obj1 The first object to match against. |
| * @param obj2 The second object to match against. |
| * @param obj3 The third object to match against. |
| * @param obj4 The forth object to match against. |
| */ |
| |
| public void logFormatted(final int level, final String message, |
| final Object obj1, final Object obj2, |
| final Object obj3, final Object obj4) |
| { |
| //do nothing |
| } |
| |
| } |
| |