| 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
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 fatalError log always raises an exception, and
can therefore be used when detecting old features that have been totally removed.
version:
$Id: Deprecation.java 479306 2006-11-26 07:49:17Z antonio $ |
