/lib/apache-log4j/site/apidocs/org/apache/log4j/Category.html

https://bitbucket.org/arkban/somersault · HTML · 1951 lines · 1734 code · 193 blank · 24 comment · 0 complexity · 8c0903ea5bec27968fbc4cc2bcf8ce9d MD5 · raw file

Large files are truncated click here to view the full file

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <!--NewPage-->
  3. <HTML>
  4. <HEAD>
  5. <!-- Generated by javadoc (build 1.6.0_16) -->
  6. <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
  7. <TITLE>
  8. Category (Apache Log4j 1.2.16 API)
  9. </TITLE>
  10. <META NAME="date" CONTENT="2010-03-30">
  11. <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
  12. <SCRIPT type="text/javascript">
  13. function windowTitle()
  14. {
  15. if (location.href.indexOf('is-external=true') == -1) {
  16. parent.document.title="Category (Apache Log4j 1.2.16 API)";
  17. }
  18. }
  19. </SCRIPT>
  20. <NOSCRIPT>
  21. </NOSCRIPT>
  22. </HEAD>
  23. <BODY BGCOLOR="white" onload="windowTitle();">
  24. <HR>
  25. <!-- ========= START OF TOP NAVBAR ======= -->
  26. <A NAME="navbar_top"><!-- --></A>
  27. <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
  28. <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
  29. <TR>
  30. <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  31. <A NAME="navbar_top_firstrow"><!-- --></A>
  32. <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  33. <TR ALIGN="center" VALIGN="top">
  34. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  35. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  36. <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  37. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/Category.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  38. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  39. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  40. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  41. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  42. </TR>
  43. </TABLE>
  44. </TD>
  45. <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  46. </EM>
  47. </TD>
  48. </TR>
  49. <TR>
  50. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  51. &nbsp;<A HREF="../../../org/apache/log4j/BasicConfigurator.html" title="class in org.apache.log4j"><B>PREV CLASS</B></A>&nbsp;
  52. &nbsp;<A HREF="../../../org/apache/log4j/ConsoleAppender.html" title="class in org.apache.log4j"><B>NEXT CLASS</B></A></FONT></TD>
  53. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  54. <A HREF="../../../index.html?org/apache/log4j/Category.html" target="_top"><B>FRAMES</B></A> &nbsp;
  55. &nbsp;<A HREF="Category.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
  56. &nbsp;<SCRIPT type="text/javascript">
  57. <!--
  58. if(window==top) {
  59. document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  60. }
  61. //-->
  62. </SCRIPT>
  63. <NOSCRIPT>
  64. <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
  65. </NOSCRIPT>
  66. </FONT></TD>
  67. </TR>
  68. <TR>
  69. <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  70. SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  71. <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  72. DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  73. </TR>
  74. </TABLE>
  75. <A NAME="skip-navbar_top"></A>
  76. <!-- ========= END OF TOP NAVBAR ========= -->
  77. <HR>
  78. <!-- ======== START OF CLASS DATA ======== -->
  79. <H2>
  80. <FONT SIZE="-1">
  81. org.apache.log4j</FONT>
  82. <BR>
  83. Class Category</H2>
  84. <PRE>
  85. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</A>
  86. <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>org.apache.log4j.Category</B>
  87. </PRE>
  88. <DL>
  89. <DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../org/apache/log4j/spi/AppenderAttachable.html" title="interface in org.apache.log4j.spi">AppenderAttachable</A></DD>
  90. </DL>
  91. <DL>
  92. <DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../org/apache/log4j/Logger.html" title="class in org.apache.log4j">Logger</A></DD>
  93. </DL>
  94. <HR>
  95. <DL>
  96. <DT><PRE>public class <B>Category</B><DT>extends <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A><DT>implements <A HREF="../../../org/apache/log4j/spi/AppenderAttachable.html" title="interface in org.apache.log4j.spi">AppenderAttachable</A></DL>
  97. </PRE>
  98. <P>
  99. <font color="#AA2222"><b>This class has been deprecated and
  100. replaced by the <A HREF="../../../org/apache/log4j/Logger.html" title="class in org.apache.log4j"><CODE>Logger</CODE></A> <em>subclass</em></b></font>. It
  101. will be kept around to preserve backward compatibility until mid
  102. 2003.
  103. <p><code>Logger</code> is a subclass of Category, i.e. it extends
  104. Category. In other words, a logger <em>is</em> a category. Thus,
  105. all operations that can be performed on a category can be
  106. performed on a logger. Internally, whenever log4j is asked to
  107. produce a Category object, it will instead produce a Logger
  108. object. Log4j 1.2 will <em>never</em> produce Category objects but
  109. only <code>Logger</code> instances. In order to preserve backward
  110. compatibility, methods that previously accepted category objects
  111. still continue to accept category objects.
  112. <p>For example, the following are all legal and will work as
  113. expected.
  114. <pre>
  115. &nbsp;&nbsp;&nbsp;// Deprecated form:
  116. &nbsp;&nbsp;&nbsp;Category cat = Category.getInstance("foo.bar")
  117. &nbsp;&nbsp;&nbsp;// Preferred form for retrieving loggers:
  118. &nbsp;&nbsp;&nbsp;Logger logger = Logger.getLogger("foo.bar")
  119. </pre>
  120. <p>The first form is deprecated and should be avoided.
  121. <p><b>There is absolutely no need for new client code to use or
  122. refer to the <code>Category</code> class.</b> Whenever possible,
  123. please avoid referring to it or using it.
  124. <p>See the <a href="../../../../manual.html">short manual</a> for an
  125. introduction on this class.
  126. <p>
  127. See the document entitled <a href="http://www.qos.ch/logging/preparingFor13.html">preparing
  128. for log4j 1.3</a> for a more detailed discussion.
  129. <P>
  130. <P>
  131. <DL>
  132. <DT><B>Author:</B></DT>
  133. <DD>Ceki G&uuml;lc&uuml;, Anders Kristensen</DD>
  134. </DL>
  135. <HR>
  136. <P>
  137. <!-- =========== FIELD SUMMARY =========== -->
  138. <A NAME="field_summary"><!-- --></A>
  139. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
  140. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  141. <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
  142. <B>Field Summary</B></FONT></TH>
  143. </TR>
  144. <TR BGCOLOR="white" CLASS="TableRowColor">
  145. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  146. <CODE>protected &nbsp;boolean</CODE></FONT></TD>
  147. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#additive">additive</A></B></CODE>
  148. <BR>
  149. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Additivity is set to true by default, that is children inherit
  150. the appenders of their ancestors by default.</TD>
  151. </TR>
  152. <TR BGCOLOR="white" CLASS="TableRowColor">
  153. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  154. <CODE>protected &nbsp;<A HREF="../../../org/apache/log4j/Level.html" title="class in org.apache.log4j">Level</A></CODE></FONT></TD>
  155. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#level">level</A></B></CODE>
  156. <BR>
  157. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The assigned level of this category.</TD>
  158. </TR>
  159. <TR BGCOLOR="white" CLASS="TableRowColor">
  160. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  161. <CODE>protected &nbsp;<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
  162. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#name">name</A></B></CODE>
  163. <BR>
  164. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The name of this category.</TD>
  165. </TR>
  166. <TR BGCOLOR="white" CLASS="TableRowColor">
  167. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  168. <CODE>protected &nbsp;<A HREF="../../../org/apache/log4j/Category.html" title="class in org.apache.log4j">Category</A></CODE></FONT></TD>
  169. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#parent">parent</A></B></CODE>
  170. <BR>
  171. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The parent of this category.</TD>
  172. </TR>
  173. <TR BGCOLOR="white" CLASS="TableRowColor">
  174. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  175. <CODE>protected &nbsp;<A HREF="../../../org/apache/log4j/spi/LoggerRepository.html" title="interface in org.apache.log4j.spi">LoggerRepository</A></CODE></FONT></TD>
  176. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#repository">repository</A></B></CODE>
  177. <BR>
  178. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
  179. </TR>
  180. <TR BGCOLOR="white" CLASS="TableRowColor">
  181. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  182. <CODE>protected &nbsp;<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/util/ResourceBundle.html?is-external=true" title="class or interface in java.util">ResourceBundle</A></CODE></FONT></TD>
  183. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#resourceBundle">resourceBundle</A></B></CODE>
  184. <BR>
  185. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
  186. </TR>
  187. </TABLE>
  188. &nbsp;
  189. <!-- ======== CONSTRUCTOR SUMMARY ======== -->
  190. <A NAME="constructor_summary"><!-- --></A>
  191. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
  192. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  193. <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
  194. <B>Constructor Summary</B></FONT></TH>
  195. </TR>
  196. <TR BGCOLOR="white" CLASS="TableRowColor">
  197. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  198. <CODE>protected </CODE></FONT></TD>
  199. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#Category(java.lang.String)">Category</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name)</CODE>
  200. <BR>
  201. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This constructor created a new <code>Category</code> instance and
  202. sets its name.</TD>
  203. </TR>
  204. </TABLE>
  205. &nbsp;
  206. <!-- ========== METHOD SUMMARY =========== -->
  207. <A NAME="method_summary"><!-- --></A>
  208. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
  209. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  210. <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
  211. <B>Method Summary</B></FONT></TH>
  212. </TR>
  213. <TR BGCOLOR="white" CLASS="TableRowColor">
  214. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  215. <CODE>&nbsp;void</CODE></FONT></TD>
  216. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#addAppender(org.apache.log4j.Appender)">addAppender</A></B>(<A HREF="../../../org/apache/log4j/Appender.html" title="interface in org.apache.log4j">Appender</A>&nbsp;newAppender)</CODE>
  217. <BR>
  218. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Add <code>newAppender</code> to the list of appenders of this
  219. Category instance.</TD>
  220. </TR>
  221. <TR BGCOLOR="white" CLASS="TableRowColor">
  222. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  223. <CODE>&nbsp;void</CODE></FONT></TD>
  224. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#assertLog(boolean, java.lang.String)">assertLog</A></B>(boolean&nbsp;assertion,
  225. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;msg)</CODE>
  226. <BR>
  227. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If <code>assertion</code> parameter is <code>false</code>, then
  228. logs <code>msg</code> as an <A HREF="../../../org/apache/log4j/Category.html#error(java.lang.Object)"><CODE>error</CODE></A> statement.</TD>
  229. </TR>
  230. <TR BGCOLOR="white" CLASS="TableRowColor">
  231. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  232. <CODE>&nbsp;void</CODE></FONT></TD>
  233. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#callAppenders(org.apache.log4j.spi.LoggingEvent)">callAppenders</A></B>(<A HREF="../../../org/apache/log4j/spi/LoggingEvent.html" title="class in org.apache.log4j.spi">LoggingEvent</A>&nbsp;event)</CODE>
  234. <BR>
  235. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Call the appenders in the hierrachy starting at
  236. <code>this</code>.</TD>
  237. </TR>
  238. <TR BGCOLOR="white" CLASS="TableRowColor">
  239. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  240. <CODE>&nbsp;void</CODE></FONT></TD>
  241. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#debug(java.lang.Object)">debug</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;message)</CODE>
  242. <BR>
  243. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Log a message object with the <A HREF="../../../org/apache/log4j/Level.html#DEBUG"><CODE>DEBUG</CODE></A> level.</TD>
  244. </TR>
  245. <TR BGCOLOR="white" CLASS="TableRowColor">
  246. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  247. <CODE>&nbsp;void</CODE></FONT></TD>
  248. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#debug(java.lang.Object, java.lang.Throwable)">debug</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;message,
  249. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</A>&nbsp;t)</CODE>
  250. <BR>
  251. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Log a message object with the <code>DEBUG</code> level including
  252. the stack trace of the <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang"><CODE>Throwable</CODE></A> <code>t</code> passed as
  253. parameter.</TD>
  254. </TR>
  255. <TR BGCOLOR="white" CLASS="TableRowColor">
  256. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  257. <CODE>&nbsp;void</CODE></FONT></TD>
  258. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#error(java.lang.Object)">error</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;message)</CODE>
  259. <BR>
  260. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Log a message object with the <A HREF="../../../org/apache/log4j/Level.html#ERROR"><CODE>ERROR</CODE></A> Level.</TD>
  261. </TR>
  262. <TR BGCOLOR="white" CLASS="TableRowColor">
  263. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  264. <CODE>&nbsp;void</CODE></FONT></TD>
  265. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#error(java.lang.Object, java.lang.Throwable)">error</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;message,
  266. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</A>&nbsp;t)</CODE>
  267. <BR>
  268. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Log a message object with the <code>ERROR</code> level including
  269. the stack trace of the <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang"><CODE>Throwable</CODE></A> <code>t</code> passed as
  270. parameter.</TD>
  271. </TR>
  272. <TR BGCOLOR="white" CLASS="TableRowColor">
  273. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  274. <CODE>static&nbsp;<A HREF="../../../org/apache/log4j/Logger.html" title="class in org.apache.log4j">Logger</A></CODE></FONT></TD>
  275. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#exists(java.lang.String)">exists</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name)</CODE>
  276. <BR>
  277. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>Please use <A HREF="../../../org/apache/log4j/LogManager.html#exists(java.lang.String)"><CODE>LogManager.exists(java.lang.String)</CODE></A> instead.</I></TD>
  278. </TR>
  279. <TR BGCOLOR="white" CLASS="TableRowColor">
  280. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  281. <CODE>&nbsp;void</CODE></FONT></TD>
  282. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#fatal(java.lang.Object)">fatal</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;message)</CODE>
  283. <BR>
  284. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Log a message object with the <A HREF="../../../org/apache/log4j/Level.html#FATAL"><CODE>FATAL</CODE></A> Level.</TD>
  285. </TR>
  286. <TR BGCOLOR="white" CLASS="TableRowColor">
  287. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  288. <CODE>&nbsp;void</CODE></FONT></TD>
  289. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#fatal(java.lang.Object, java.lang.Throwable)">fatal</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;message,
  290. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</A>&nbsp;t)</CODE>
  291. <BR>
  292. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Log a message object with the <code>FATAL</code> level including
  293. the stack trace of the <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang"><CODE>Throwable</CODE></A> <code>t</code> passed as
  294. parameter.</TD>
  295. </TR>
  296. <TR BGCOLOR="white" CLASS="TableRowColor">
  297. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  298. <CODE>protected &nbsp;void</CODE></FONT></TD>
  299. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#forcedLog(java.lang.String, org.apache.log4j.Priority, java.lang.Object, java.lang.Throwable)">forcedLog</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;fqcn,
  300. <A HREF="../../../org/apache/log4j/Priority.html" title="class in org.apache.log4j">Priority</A>&nbsp;level,
  301. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;message,
  302. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</A>&nbsp;t)</CODE>
  303. <BR>
  304. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This method creates a new logging event and logs the event
  305. without further checks.</TD>
  306. </TR>
  307. <TR BGCOLOR="white" CLASS="TableRowColor">
  308. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  309. <CODE>&nbsp;boolean</CODE></FONT></TD>
  310. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getAdditivity()">getAdditivity</A></B>()</CODE>
  311. <BR>
  312. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the additivity flag for this Category instance.</TD>
  313. </TR>
  314. <TR BGCOLOR="white" CLASS="TableRowColor">
  315. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  316. <CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</A></CODE></FONT></TD>
  317. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getAllAppenders()">getAllAppenders</A></B>()</CODE>
  318. <BR>
  319. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the appenders contained in this category as an <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util"><CODE>Enumeration</CODE></A>.</TD>
  320. </TR>
  321. <TR BGCOLOR="white" CLASS="TableRowColor">
  322. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  323. <CODE>&nbsp;<A HREF="../../../org/apache/log4j/Appender.html" title="interface in org.apache.log4j">Appender</A></CODE></FONT></TD>
  324. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getAppender(java.lang.String)">getAppender</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name)</CODE>
  325. <BR>
  326. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Look for the appender named as <code>name</code>.</TD>
  327. </TR>
  328. <TR BGCOLOR="white" CLASS="TableRowColor">
  329. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  330. <CODE>&nbsp;<A HREF="../../../org/apache/log4j/Priority.html" title="class in org.apache.log4j">Priority</A></CODE></FONT></TD>
  331. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getChainedPriority()">getChainedPriority</A></B>()</CODE>
  332. <BR>
  333. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>Please use the the <A HREF="../../../org/apache/log4j/Category.html#getEffectiveLevel()"><CODE>getEffectiveLevel()</CODE></A> method
  334. instead.</I></TD>
  335. </TR>
  336. <TR BGCOLOR="white" CLASS="TableRowColor">
  337. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  338. <CODE>static&nbsp;<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</A></CODE></FONT></TD>
  339. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getCurrentCategories()">getCurrentCategories</A></B>()</CODE>
  340. <BR>
  341. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>Please use <A HREF="../../../org/apache/log4j/LogManager.html#getCurrentLoggers()"><CODE>LogManager.getCurrentLoggers()</CODE></A> instead.</I></TD>
  342. </TR>
  343. <TR BGCOLOR="white" CLASS="TableRowColor">
  344. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  345. <CODE>static&nbsp;<A HREF="../../../org/apache/log4j/spi/LoggerRepository.html" title="interface in org.apache.log4j.spi">LoggerRepository</A></CODE></FONT></TD>
  346. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getDefaultHierarchy()">getDefaultHierarchy</A></B>()</CODE>
  347. <BR>
  348. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>Please use <A HREF="../../../org/apache/log4j/LogManager.html#getLoggerRepository()"><CODE>LogManager.getLoggerRepository()</CODE></A> instead.</I></TD>
  349. </TR>
  350. <TR BGCOLOR="white" CLASS="TableRowColor">
  351. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  352. <CODE>&nbsp;<A HREF="../../../org/apache/log4j/Level.html" title="class in org.apache.log4j">Level</A></CODE></FONT></TD>
  353. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getEffectiveLevel()">getEffectiveLevel</A></B>()</CODE>
  354. <BR>
  355. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Starting from this category, search the category hierarchy for a
  356. non-null level and return it.</TD>
  357. </TR>
  358. <TR BGCOLOR="white" CLASS="TableRowColor">
  359. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  360. <CODE>&nbsp;<A HREF="../../../org/apache/log4j/spi/LoggerRepository.html" title="interface in org.apache.log4j.spi">LoggerRepository</A></CODE></FONT></TD>
  361. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getHierarchy()">getHierarchy</A></B>()</CODE>
  362. <BR>
  363. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>Please use <A HREF="../../../org/apache/log4j/Category.html#getLoggerRepository()"><CODE>getLoggerRepository()</CODE></A> instead.</I></TD>
  364. </TR>
  365. <TR BGCOLOR="white" CLASS="TableRowColor">
  366. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  367. <CODE>static&nbsp;<A HREF="../../../org/apache/log4j/Category.html" title="class in org.apache.log4j">Category</A></CODE></FONT></TD>
  368. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getInstance(java.lang.Class)">getInstance</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</A>&nbsp;clazz)</CODE>
  369. <BR>
  370. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>Please make sure to use <A HREF="../../../org/apache/log4j/Logger.html#getLogger(java.lang.Class)"><CODE>Logger.getLogger(Class)</CODE></A> instead.</I></TD>
  371. </TR>
  372. <TR BGCOLOR="white" CLASS="TableRowColor">
  373. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  374. <CODE>static&nbsp;<A HREF="../../../org/apache/log4j/Category.html" title="class in org.apache.log4j">Category</A></CODE></FONT></TD>
  375. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getInstance(java.lang.String)">getInstance</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name)</CODE>
  376. <BR>
  377. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>Make sure to use <A HREF="../../../org/apache/log4j/Logger.html#getLogger(java.lang.String)"><CODE>Logger.getLogger(String)</CODE></A> instead.</I></TD>
  378. </TR>
  379. <TR BGCOLOR="white" CLASS="TableRowColor">
  380. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  381. <CODE>&nbsp;<A HREF="../../../org/apache/log4j/Level.html" title="class in org.apache.log4j">Level</A></CODE></FONT></TD>
  382. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getLevel()">getLevel</A></B>()</CODE>
  383. <BR>
  384. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the assigned <A HREF="../../../org/apache/log4j/Level.html" title="class in org.apache.log4j"><CODE>Level</CODE></A>, if any, for this Category.</TD>
  385. </TR>
  386. <TR BGCOLOR="white" CLASS="TableRowColor">
  387. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  388. <CODE>&nbsp;<A HREF="../../../org/apache/log4j/spi/LoggerRepository.html" title="interface in org.apache.log4j.spi">LoggerRepository</A></CODE></FONT></TD>
  389. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getLoggerRepository()">getLoggerRepository</A></B>()</CODE>
  390. <BR>
  391. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the the <A HREF="../../../org/apache/log4j/spi/LoggerRepository.html" title="interface in org.apache.log4j.spi"><CODE>LoggerRepository</CODE></A> where this
  392. <code>Category</code> is attached.</TD>
  393. </TR>
  394. <TR BGCOLOR="white" CLASS="TableRowColor">
  395. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  396. <CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
  397. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getName()">getName</A></B>()</CODE>
  398. <BR>
  399. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the category name.</TD>
  400. </TR>
  401. <TR BGCOLOR="white" CLASS="TableRowColor">
  402. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  403. <CODE>&nbsp;<A HREF="../../../org/apache/log4j/Category.html" title="class in org.apache.log4j">Category</A></CODE></FONT></TD>
  404. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getParent()">getParent</A></B>()</CODE>
  405. <BR>
  406. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the parent of this category.</TD>
  407. </TR>
  408. <TR BGCOLOR="white" CLASS="TableRowColor">
  409. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  410. <CODE>&nbsp;<A HREF="../../../org/apache/log4j/Level.html" title="class in org.apache.log4j">Level</A></CODE></FONT></TD>
  411. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getPriority()">getPriority</A></B>()</CODE>
  412. <BR>
  413. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>Please use <A HREF="../../../org/apache/log4j/Category.html#getLevel()"><CODE>getLevel()</CODE></A> instead.</I></TD>
  414. </TR>
  415. <TR BGCOLOR="white" CLASS="TableRowColor">
  416. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  417. <CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/util/ResourceBundle.html?is-external=true" title="class or interface in java.util">ResourceBundle</A></CODE></FONT></TD>
  418. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getResourceBundle()">getResourceBundle</A></B>()</CODE>
  419. <BR>
  420. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the <em>inherited</em> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/util/ResourceBundle.html?is-external=true" title="class or interface in java.util"><CODE>ResourceBundle</CODE></A> for this
  421. category.</TD>
  422. </TR>
  423. <TR BGCOLOR="white" CLASS="TableRowColor">
  424. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  425. <CODE>protected &nbsp;<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
  426. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getResourceBundleString(java.lang.String)">getResourceBundleString</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;key)</CODE>
  427. <BR>
  428. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the string resource coresponding to <code>key</code> in
  429. this category's inherited resource bundle.</TD>
  430. </TR>
  431. <TR BGCOLOR="white" CLASS="TableRowColor">
  432. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  433. <CODE>static&nbsp;<A HREF="../../../org/apache/log4j/Category.html" title="class in org.apache.log4j">Category</A></CODE></FONT></TD>
  434. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#getRoot()">getRoot</A></B>()</CODE>
  435. <BR>
  436. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>Please use <A HREF="../../../org/apache/log4j/Logger.html#getRootLogger()"><CODE>Logger.getRootLogger()</CODE></A> instead.</I></TD>
  437. </TR>
  438. <TR BGCOLOR="white" CLASS="TableRowColor">
  439. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  440. <CODE>&nbsp;void</CODE></FONT></TD>
  441. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#info(java.lang.Object)">info</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;message)</CODE>
  442. <BR>
  443. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Log a message object with the <A HREF="../../../org/apache/log4j/Level.html#INFO"><CODE>INFO</CODE></A> Level.</TD>
  444. </TR>
  445. <TR BGCOLOR="white" CLASS="TableRowColor">
  446. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  447. <CODE>&nbsp;void</CODE></FONT></TD>
  448. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#info(java.lang.Object, java.lang.Throwable)">info</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;message,
  449. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</A>&nbsp;t)</CODE>
  450. <BR>
  451. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Log a message object with the <code>INFO</code> level including
  452. the stack trace of the <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang"><CODE>Throwable</CODE></A> <code>t</code> passed as
  453. parameter.</TD>
  454. </TR>
  455. <TR BGCOLOR="white" CLASS="TableRowColor">
  456. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  457. <CODE>&nbsp;boolean</CODE></FONT></TD>
  458. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#isAttached(org.apache.log4j.Appender)">isAttached</A></B>(<A HREF="../../../org/apache/log4j/Appender.html" title="interface in org.apache.log4j">Appender</A>&nbsp;appender)</CODE>
  459. <BR>
  460. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Is the appender passed as parameter attached to this category?</TD>
  461. </TR>
  462. <TR BGCOLOR="white" CLASS="TableRowColor">
  463. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  464. <CODE>&nbsp;boolean</CODE></FONT></TD>
  465. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#isDebugEnabled()">isDebugEnabled</A></B>()</CODE>
  466. <BR>
  467. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Check whether this category is enabled for the <code>DEBUG</code>
  468. Level.</TD>
  469. </TR>
  470. <TR BGCOLOR="white" CLASS="TableRowColor">
  471. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  472. <CODE>&nbsp;boolean</CODE></FONT></TD>
  473. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#isEnabledFor(org.apache.log4j.Priority)">isEnabledFor</A></B>(<A HREF="../../../org/apache/log4j/Priority.html" title="class in org.apache.log4j">Priority</A>&nbsp;level)</CODE>
  474. <BR>
  475. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Check whether this category is enabled for a given <A HREF="../../../org/apache/log4j/Level.html" title="class in org.apache.log4j"><CODE>Level</CODE></A> passed as parameter.</TD>
  476. </TR>
  477. <TR BGCOLOR="white" CLASS="TableRowColor">
  478. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  479. <CODE>&nbsp;boolean</CODE></FONT></TD>
  480. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#isInfoEnabled()">isInfoEnabled</A></B>()</CODE>
  481. <BR>
  482. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Check whether this category is enabled for the info Level.</TD>
  483. </TR>
  484. <TR BGCOLOR="white" CLASS="TableRowColor">
  485. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  486. <CODE>&nbsp;void</CODE></FONT></TD>
  487. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#l7dlog(org.apache.log4j.Priority, java.lang.String, java.lang.Object[], java.lang.Throwable)">l7dlog</A></B>(<A HREF="../../../org/apache/log4j/Priority.html" title="class in org.apache.log4j">Priority</A>&nbsp;priority,
  488. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;key,
  489. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>[]&nbsp;params,
  490. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</A>&nbsp;t)</CODE>
  491. <BR>
  492. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Log a localized and parameterized message.</TD>
  493. </TR>
  494. <TR BGCOLOR="white" CLASS="TableRowColor">
  495. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  496. <CODE>&nbsp;void</CODE></FONT></TD>
  497. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#l7dlog(org.apache.log4j.Priority, java.lang.String, java.lang.Throwable)">l7dlog</A></B>(<A HREF="../../../org/apache/log4j/Priority.html" title="class in org.apache.log4j">Priority</A>&nbsp;priority,
  498. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;key,
  499. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</A>&nbsp;t)</CODE>
  500. <BR>
  501. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Log a localized message.</TD>
  502. </TR>
  503. <TR BGCOLOR="white" CLASS="TableRowColor">
  504. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  505. <CODE>&nbsp;void</CODE></FONT></TD>
  506. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#log(org.apache.log4j.Priority, java.lang.Object)">log</A></B>(<A HREF="../../../org/apache/log4j/Priority.html" title="class in org.apache.log4j">Priority</A>&nbsp;priority,
  507. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;message)</CODE>
  508. <BR>
  509. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This generic form is intended to be used by wrappers.</TD>
  510. </TR>
  511. <TR BGCOLOR="white" CLASS="TableRowColor">
  512. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  513. <CODE>&nbsp;void</CODE></FONT></TD>
  514. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#log(org.apache.log4j.Priority, java.lang.Object, java.lang.Throwable)">log</A></B>(<A HREF="../../../org/apache/log4j/Priority.html" title="class in org.apache.log4j">Priority</A>&nbsp;priority,
  515. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;message,
  516. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</A>&nbsp;t)</CODE>
  517. <BR>
  518. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This generic form is intended to be used by wrappers.</TD>
  519. </TR>
  520. <TR BGCOLOR="white" CLASS="TableRowColor">
  521. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  522. <CODE>&nbsp;void</CODE></FONT></TD>
  523. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#log(java.lang.String, org.apache.log4j.Priority, java.lang.Object, java.lang.Throwable)">log</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;callerFQCN,
  524. <A HREF="../../../org/apache/log4j/Priority.html" title="class in org.apache.log4j">Priority</A>&nbsp;level,
  525. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;message,
  526. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</A>&nbsp;t)</CODE>
  527. <BR>
  528. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This is the most generic printing method.</TD>
  529. </TR>
  530. <TR BGCOLOR="white" CLASS="TableRowColor">
  531. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  532. <CODE>&nbsp;void</CODE></FONT></TD>
  533. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#removeAllAppenders()">removeAllAppenders</A></B>()</CODE>
  534. <BR>
  535. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Remove all previously added appenders from this Category
  536. instance.</TD>
  537. </TR>
  538. <TR BGCOLOR="white" CLASS="TableRowColor">
  539. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  540. <CODE>&nbsp;void</CODE></FONT></TD>
  541. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#removeAppender(org.apache.log4j.Appender)">removeAppender</A></B>(<A HREF="../../../org/apache/log4j/Appender.html" title="interface in org.apache.log4j">Appender</A>&nbsp;appender)</CODE>
  542. <BR>
  543. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Remove the appender passed as parameter form the list of appenders.</TD>
  544. </TR>
  545. <TR BGCOLOR="white" CLASS="TableRowColor">
  546. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  547. <CODE>&nbsp;void</CODE></FONT></TD>
  548. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#removeAppender(java.lang.String)">removeAppender</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name)</CODE>
  549. <BR>
  550. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Remove the appender with the name passed as parameter form the
  551. list of appenders.</TD>
  552. </TR>
  553. <TR BGCOLOR="white" CLASS="TableRowColor">
  554. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  555. <CODE>&nbsp;void</CODE></FONT></TD>
  556. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#setAdditivity(boolean)">setAdditivity</A></B>(boolean&nbsp;additive)</CODE>
  557. <BR>
  558. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the additivity flag for this Category instance.</TD>
  559. </TR>
  560. <TR BGCOLOR="white" CLASS="TableRowColor">
  561. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  562. <CODE>&nbsp;void</CODE></FONT></TD>
  563. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#setLevel(org.apache.log4j.Level)">setLevel</A></B>(<A HREF="../../../org/apache/log4j/Level.html" title="class in org.apache.log4j">Level</A>&nbsp;level)</CODE>
  564. <BR>
  565. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the level of this Category.</TD>
  566. </TR>
  567. <TR BGCOLOR="white" CLASS="TableRowColor">
  568. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  569. <CODE>&nbsp;void</CODE></FONT></TD>
  570. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#setPriority(org.apache.log4j.Priority)">setPriority</A></B>(<A HREF="../../../org/apache/log4j/Priority.html" title="class in org.apache.log4j">Priority</A>&nbsp;priority)</CODE>
  571. <BR>
  572. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>Please use <A HREF="../../../org/apache/log4j/Category.html#setLevel(org.apache.log4j.Level)"><CODE>setLevel(org.apache.log4j.Level)</CODE></A> instead.</I></TD>
  573. </TR>
  574. <TR BGCOLOR="white" CLASS="TableRowColor">
  575. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  576. <CODE>&nbsp;void</CODE></FONT></TD>
  577. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#setResourceBundle(java.util.ResourceBundle)">setResourceBundle</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/util/ResourceBundle.html?is-external=true" title="class or interface in java.util">ResourceBundle</A>&nbsp;bundle)</CODE>
  578. <BR>
  579. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the resource bundle to be used with localized logging
  580. methods <A HREF="../../../org/apache/log4j/Category.html#l7dlog(org.apache.log4j.Priority, java.lang.String, java.lang.Throwable)"><CODE>l7dlog(Priority,String,Throwable)</CODE></A> and <A HREF="../../../org/apache/log4j/Category.html#l7dlog(org.apache.log4j.Priority, java.lang.String, java.lang.Object[], java.lang.Throwable)"><CODE>l7dlog(Priority,String,Object[],Throwable)</CODE></A>.</TD>
  581. </TR>
  582. <TR BGCOLOR="white" CLASS="TableRowColor">
  583. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  584. <CODE>static&nbsp;void</CODE></FONT></TD>
  585. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#shutdown()">shutdown</A></B>()</CODE>
  586. <BR>
  587. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>Please use <A HREF="../../../org/apache/log4j/LogManager.html#shutdown()"><CODE>LogManager.shutdown()</CODE></A> instead.</I></TD>
  588. </TR>
  589. <TR BGCOLOR="white" CLASS="TableRowColor">
  590. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  591. <CODE>&nbsp;void</CODE></FONT></TD>
  592. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#warn(java.lang.Object)">warn</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;message)</CODE>
  593. <BR>
  594. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Log a message object with the <A HREF="../../../org/apache/log4j/Level.html#WARN"><CODE>WARN</CODE></A> Level.</TD>
  595. </TR>
  596. <TR BGCOLOR="white" CLASS="TableRowColor">
  597. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  598. <CODE>&nbsp;void</CODE></FONT></TD>
  599. <TD><CODE><B><A HREF="../../../org/apache/log4j/Category.html#warn(java.lang.Object, java.lang.Throwable)">warn</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;message,
  600. <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</A>&nbsp;t)</CODE>
  601. <BR>
  602. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Log a message with the <code>WARN</code> level including the
  603. stack trace of the <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang"><CODE>Throwable</CODE></A> <code>t</code> passed as
  604. parameter.</TD>
  605. </TR>
  606. </TABLE>
  607. &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
  608. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
  609. <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
  610. <TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></B></TH>
  611. </TR>
  612. <TR BGCOLOR="white" CLASS="TableRowColor">
  613. <TD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
  614. </TR>
  615. </TABLE>
  616. &nbsp;
  617. <P>
  618. <!-- ============ FIELD DETAIL =========== -->
  619. <A NAME="field_detail"><!-- --></A>
  620. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
  621. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  622. <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
  623. <B>Field Detail</B></FONT></TH>
  624. </TR>
  625. </TABLE>
  626. <A NAME="name"><!-- --></A><H3>
  627. name</H3>
  628. <PRE>
  629. protected <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>name</B></PRE>
  630. <DL>
  631. <DD>The name of this category.
  632. <P>
  633. <DL>
  634. </DL>
  635. </DL>
  636. <HR>
  637. <A NAME="level"><!-- --></A><H3>
  638. level</H3>
  639. <PRE>
  640. protected volatile <A HREF="../../../org/apache/log4j/Level.html" title="class in org.apache.log4j">Level</A> <B>level</B></PRE>
  641. <DL>
  642. <DD>The assigned level of this category. The
  643. <code>level</code> variable need not be assigned a value in
  644. which case it is inherited form the hierarchy.
  645. <P>
  646. <DL>
  647. </DL>
  648. </DL>
  649. <HR>
  650. <A NAME="parent"><!-- --></A><H3>
  651. parent</H3>
  652. <PRE>
  653. protected volatile <A HREF="../../../org/apache/log4j/Category.html" title="class in org.apache.log4j">Category</A> <B>parent</B></PRE>
  654. <DL>
  655. <DD>The parent of this category. All categories have at least one
  656. ancestor which is the root category.
  657. <P>
  658. <DL>
  659. </DL>
  660. </DL>
  661. <HR>
  662. <A NAME="resourceBundle"><!-- --></A><H3>
  663. resourceBundle</H3>
  664. <PRE>
  665. protected <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/util/ResourceBundle.html?is-external=true" title="class or interface in java.util">ResourceBundle</A> <B>resourceBundle</B></PRE>
  666. <DL>
  667. <DL>
  668. </DL>
  669. </DL>
  670. <HR>
  671. <A NAME="repository"><!-- --></A><H3>
  672. repository</H3>
  673. <PRE>
  674. protected <A HREF="../../../org/apache/log4j/spi/LoggerRepository.html" title="interface in org.apache.log4j.spi">LoggerRepository</A> <B>repository</B></PRE>
  675. <DL>
  676. <DL>
  677. </DL>
  678. </DL>
  679. <HR>
  680. <A NAME="additive"><!-- --></A><H3>
  681. additive</H3>
  682. <PRE>
  683. protected boolean <B>additive</B></PRE>
  684. <DL>
  685. <DD>Additivity is set to true by default, that is children inherit
  686. the appenders of their ancestors by default. If this variable is
  687. set to <code>false</code> then the appenders found in the
  688. ancestors of this category are not used. However, the children
  689. of this category will inherit its appenders, unless the children
  690. have their additivity flag set to <code>false</code> too. See
  691. the user manual for more details.
  692. <P>
  693. <DL>
  694. </DL>
  695. </DL>
  696. <!-- ========= CONSTRUCTOR DETAIL ======== -->
  697. <A NAME="constructor_detail"><!-- --></A>
  698. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
  699. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  700. <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
  701. <B>Constructor Detail</B></FONT></TH>
  702. </TR>
  703. </TABLE>
  704. <A NAME="Category(java.lang.String)"><!-- --></A><H3>
  705. Category</H3>
  706. <PRE>
  707. protected <B>Category</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name)</PRE>
  708. <DL>
  709. <DD>This constructor created a new <code>Category</code> instance and
  710. sets its name.
  711. <p>It is intended to be used by sub-classes only. You should not
  712. create categories directly.
  713. <P>
  714. <DL>
  715. <DT><B>Parameters:</B><DD><CODE>name</CODE> - The name of the category.</DL>
  716. </DL>
  717. <!-- ============ METHOD DETAIL ========== -->
  718. <A NAME="method_detail"><!-- --></A>
  719. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
  720. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  721. <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
  722. <B>Method Detail</B></FONT></TH>
  723. </TR>
  724. </TABLE>
  725. <A NAME="addAppender(org.apache.log4j.Appender)"><!-- --></A><H3>
  726. addAppender</H3>
  727. <PRE>
  728. public void <B>addAppender</B>(<A HREF="../../../org/apache/log4j/Appender.html" title="interface in org.apache.log4j">Appender</A>&nbsp;newAppender)</PRE>
  729. <DL>
  730. <DD>Add <code>newAppender</code> to the list of appenders of this
  731. Category instance.
  732. <p>If <code>newAppender</code> is already in the list of
  733. appenders, t