This class provides a special static "deprecation" logger. All deprecated code should use this logger to log messages into the deprecation logger. This makes it easier for users to find out if they're using deprecated stuff.
Additionally, it is possible to set the forbidden level of deprecation messages (default is to forbid ERROR, i.e. allow up to WARN). Messages equal to or above the forbidden level will lead to throwing a {@link DeprecationException}. Setting the forbidden level to FATAL_ERROR allows running legacy applications using deprecated features (tolerant mode), and setting the forbidden level to DEBUG will run in strict mode, forbidding all deprecations.
Note that according to the above, issuing a fatal
log message always raises an exception, and can therefore be used when detecting old features that have been completely removed.
@version $Id: Deprecation.java 587751 2007-10-24 02:41:36Z vgritsenko $