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