/lib/apache-log4j/site/apidocs/org/apache/log4j/HTMLLayout.html
HTML | 603 lines | 516 code | 63 blank | 24 comment | 0 complexity | a460416f0a0653f074d600890f3533f7 MD5 | raw file
Possible License(s): LGPL-2.1, BSD-3-Clause, Apache-2.0
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>
8HTMLLayout (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="HTMLLayout (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/HTMLLayout.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/Hierarchy.html" title="class in org.apache.log4j"><B>PREV CLASS</B></A>
60 <A HREF="../../../org/apache/log4j/Layout.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/HTMLLayout.html" target="_top"><B>FRAMES</B></A>
63 <A HREF="HTMLLayout.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 HTMLLayout</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 "><A HREF="../../../org/apache/log4j/Layout.html" title="class in org.apache.log4j">org.apache.log4j.Layout</A>
98 <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>org.apache.log4j.HTMLLayout</B>
99</PRE>
100<DL>
101<DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../org/apache/log4j/spi/OptionHandler.html" title="interface in org.apache.log4j.spi">OptionHandler</A></DD>
102</DL>
103<HR>
104<DL>
105<DT><PRE>public class <B>HTMLLayout</B><DT>extends <A HREF="../../../org/apache/log4j/Layout.html" title="class in org.apache.log4j">Layout</A></DL>
106</PRE>
107
108<P>
109This layout outputs events in a HTML table.
110
111 Appenders using this layout should have their encoding
112 set to UTF-8 or UTF-16, otherwise events containing
113 non ASCII characters could result in corrupted
114 log files.
115<P>
116
117<P>
118<DL>
119<DT><B>Author:</B></DT>
120 <DD>Ceki Gülcü</DD>
121</DL>
122<HR>
123
124<P>
125<!-- =========== FIELD SUMMARY =========== -->
126
127<A NAME="field_summary"><!-- --></A>
128<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
129<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
130<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
131<B>Field Summary</B></FONT></TH>
132</TR>
133<TR BGCOLOR="white" CLASS="TableRowColor">
134<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
135<CODE>protected int</CODE></FONT></TD>
136<TD><CODE><B><A HREF="../../../org/apache/log4j/HTMLLayout.html#BUF_SIZE">BUF_SIZE</A></B></CODE>
137
138<BR>
139 </TD>
140</TR>
141<TR BGCOLOR="white" CLASS="TableRowColor">
142<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
143<CODE>static <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>
144<TD><CODE><B><A HREF="../../../org/apache/log4j/HTMLLayout.html#LOCATION_INFO_OPTION">LOCATION_INFO_OPTION</A></B></CODE>
145
146<BR>
147 <B>Deprecated.</B> <I>Options are now handled using the JavaBeans paradigm.
148 This constant is not longer needed and will be removed in the
149 <em>near</em> term.</I></TD>
150</TR>
151<TR BGCOLOR="white" CLASS="TableRowColor">
152<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
153<CODE>protected int</CODE></FONT></TD>
154<TD><CODE><B><A HREF="../../../org/apache/log4j/HTMLLayout.html#MAX_CAPACITY">MAX_CAPACITY</A></B></CODE>
155
156<BR>
157 </TD>
158</TR>
159<TR BGCOLOR="white" CLASS="TableRowColor">
160<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
161<CODE>static <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/HTMLLayout.html#TITLE_OPTION">TITLE_OPTION</A></B></CODE>
163
164<BR>
165 A string constant used in naming the option for setting the the
166 HTML document title.</TD>
167</TR>
168</TABLE>
169 <A NAME="fields_inherited_from_class_org.apache.log4j.Layout"><!-- --></A>
170<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
171<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
172<TH ALIGN="left"><B>Fields inherited from class org.apache.log4j.<A HREF="../../../org/apache/log4j/Layout.html" title="class in org.apache.log4j">Layout</A></B></TH>
173</TR>
174<TR BGCOLOR="white" CLASS="TableRowColor">
175<TD><CODE><A HREF="../../../org/apache/log4j/Layout.html#LINE_SEP">LINE_SEP</A>, <A HREF="../../../org/apache/log4j/Layout.html#LINE_SEP_LEN">LINE_SEP_LEN</A></CODE></TD>
176</TR>
177</TABLE>
178
179<!-- ======== CONSTRUCTOR SUMMARY ======== -->
180
181<A NAME="constructor_summary"><!-- --></A>
182<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
183<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
184<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
185<B>Constructor Summary</B></FONT></TH>
186</TR>
187<TR BGCOLOR="white" CLASS="TableRowColor">
188<TD><CODE><B><A HREF="../../../org/apache/log4j/HTMLLayout.html#HTMLLayout()">HTMLLayout</A></B>()</CODE>
189
190<BR>
191 </TD>
192</TR>
193</TABLE>
194
195<!-- ========== METHOD SUMMARY =========== -->
196
197<A NAME="method_summary"><!-- --></A>
198<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
199<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
200<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
201<B>Method Summary</B></FONT></TH>
202</TR>
203<TR BGCOLOR="white" CLASS="TableRowColor">
204<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
205<CODE> void</CODE></FONT></TD>
206<TD><CODE><B><A HREF="../../../org/apache/log4j/HTMLLayout.html#activateOptions()">activateOptions</A></B>()</CODE>
207
208<BR>
209 No options to activate.</TD>
210</TR>
211<TR BGCOLOR="white" CLASS="TableRowColor">
212<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
213<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>
214<TD><CODE><B><A HREF="../../../org/apache/log4j/HTMLLayout.html#format(org.apache.log4j.spi.LoggingEvent)">format</A></B>(<A HREF="../../../org/apache/log4j/spi/LoggingEvent.html" title="class in org.apache.log4j.spi">LoggingEvent</A> event)</CODE>
215
216<BR>
217 Implement this method to create your own layout format.</TD>
218</TR>
219<TR BGCOLOR="white" CLASS="TableRowColor">
220<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
221<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>
222<TD><CODE><B><A HREF="../../../org/apache/log4j/HTMLLayout.html#getContentType()">getContentType</A></B>()</CODE>
223
224<BR>
225 Returns the content type output by this layout, i.e "text/html".</TD>
226</TR>
227<TR BGCOLOR="white" CLASS="TableRowColor">
228<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
229<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>
230<TD><CODE><B><A HREF="../../../org/apache/log4j/HTMLLayout.html#getFooter()">getFooter</A></B>()</CODE>
231
232<BR>
233 Returns the appropriate HTML footers.</TD>
234</TR>
235<TR BGCOLOR="white" CLASS="TableRowColor">
236<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
237<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>
238<TD><CODE><B><A HREF="../../../org/apache/log4j/HTMLLayout.html#getHeader()">getHeader</A></B>()</CODE>
239
240<BR>
241 Returns appropriate HTML headers.</TD>
242</TR>
243<TR BGCOLOR="white" CLASS="TableRowColor">
244<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
245<CODE> boolean</CODE></FONT></TD>
246<TD><CODE><B><A HREF="../../../org/apache/log4j/HTMLLayout.html#getLocationInfo()">getLocationInfo</A></B>()</CODE>
247
248<BR>
249 Returns the current value of the <b>LocationInfo</b> option.</TD>
250</TR>
251<TR BGCOLOR="white" CLASS="TableRowColor">
252<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
253<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>
254<TD><CODE><B><A HREF="../../../org/apache/log4j/HTMLLayout.html#getTitle()">getTitle</A></B>()</CODE>
255
256<BR>
257 Returns the current value of the <b>Title</b> option.</TD>
258</TR>
259<TR BGCOLOR="white" CLASS="TableRowColor">
260<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
261<CODE> boolean</CODE></FONT></TD>
262<TD><CODE><B><A HREF="../../../org/apache/log4j/HTMLLayout.html#ignoresThrowable()">ignoresThrowable</A></B>()</CODE>
263
264<BR>
265 The HTML layout handles the throwable contained in logging
266 events.</TD>
267</TR>
268<TR BGCOLOR="white" CLASS="TableRowColor">
269<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
270<CODE> void</CODE></FONT></TD>
271<TD><CODE><B><A HREF="../../../org/apache/log4j/HTMLLayout.html#setLocationInfo(boolean)">setLocationInfo</A></B>(boolean flag)</CODE>
272
273<BR>
274 The <b>LocationInfo</b> option takes a boolean value.</TD>
275</TR>
276<TR BGCOLOR="white" CLASS="TableRowColor">
277<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
278<CODE> void</CODE></FONT></TD>
279<TD><CODE><B><A HREF="../../../org/apache/log4j/HTMLLayout.html#setTitle(java.lang.String)">setTitle</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> title)</CODE>
280
281<BR>
282 The <b>Title</b> option takes a String value.</TD>
283</TR>
284</TABLE>
285 <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
286<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
287<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
288<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>
289</TR>
290<TR BGCOLOR="white" CLASS="TableRowColor">
291<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>
292</TR>
293</TABLE>
294
295<P>
296
297<!-- ============ FIELD DETAIL =========== -->
298
299<A NAME="field_detail"><!-- --></A>
300<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
301<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
302<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
303<B>Field Detail</B></FONT></TH>
304</TR>
305</TABLE>
306
307<A NAME="BUF_SIZE"><!-- --></A><H3>
308BUF_SIZE</H3>
309<PRE>
310protected final int <B>BUF_SIZE</B></PRE>
311<DL>
312<DL>
313<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.apache.log4j.HTMLLayout.BUF_SIZE">Constant Field Values</A></DL>
314</DL>
315<HR>
316
317<A NAME="MAX_CAPACITY"><!-- --></A><H3>
318MAX_CAPACITY</H3>
319<PRE>
320protected final int <B>MAX_CAPACITY</B></PRE>
321<DL>
322<DL>
323<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.apache.log4j.HTMLLayout.MAX_CAPACITY">Constant Field Values</A></DL>
324</DL>
325<HR>
326
327<A NAME="LOCATION_INFO_OPTION"><!-- --></A><H3>
328LOCATION_INFO_OPTION</H3>
329<PRE>
330public static final <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>LOCATION_INFO_OPTION</B></PRE>
331<DL>
332<DD><B>Deprecated.</B> <I>Options are now handled using the JavaBeans paradigm.
333 This constant is not longer needed and will be removed in the
334 <em>near</em> term.</I><DD>A string constant used in naming the option for setting the the
335 location information flag. Current value of this string
336 constant is <b>LocationInfo</b>.
337
338 <p>Note that all option keys are case sensitive.
339<P>
340<DL>
341<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.apache.log4j.HTMLLayout.LOCATION_INFO_OPTION">Constant Field Values</A></DL>
342</DL>
343<HR>
344
345<A NAME="TITLE_OPTION"><!-- --></A><H3>
346TITLE_OPTION</H3>
347<PRE>
348public static final <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>TITLE_OPTION</B></PRE>
349<DL>
350<DD>A string constant used in naming the option for setting the the
351 HTML document title. Current value of this string
352 constant is <b>Title</b>.
353<P>
354<DL>
355<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.apache.log4j.HTMLLayout.TITLE_OPTION">Constant Field Values</A></DL>
356</DL>
357
358<!-- ========= CONSTRUCTOR DETAIL ======== -->
359
360<A NAME="constructor_detail"><!-- --></A>
361<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
362<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
363<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
364<B>Constructor Detail</B></FONT></TH>
365</TR>
366</TABLE>
367
368<A NAME="HTMLLayout()"><!-- --></A><H3>
369HTMLLayout</H3>
370<PRE>
371public <B>HTMLLayout</B>()</PRE>
372<DL>
373</DL>
374
375<!-- ============ METHOD DETAIL ========== -->
376
377<A NAME="method_detail"><!-- --></A>
378<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
379<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
380<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
381<B>Method Detail</B></FONT></TH>
382</TR>
383</TABLE>
384
385<A NAME="setLocationInfo(boolean)"><!-- --></A><H3>
386setLocationInfo</H3>
387<PRE>
388public void <B>setLocationInfo</B>(boolean flag)</PRE>
389<DL>
390<DD>The <b>LocationInfo</b> option takes a boolean value. By
391 default, it is set to false which means there will be no location
392 information output by this layout. If the the option is set to
393 true, then the file name and line number of the statement
394 at the origin of the log statement will be output.
395
396 <p>If you are embedding this layout within an <A HREF="../../../org/apache/log4j/net/SMTPAppender.html" title="class in org.apache.log4j.net"><CODE>SMTPAppender</CODE></A> then make sure to set the
397 <b>LocationInfo</b> option of that appender as well.
398<P>
399<DD><DL>
400</DL>
401</DD>
402</DL>
403<HR>
404
405<A NAME="getLocationInfo()"><!-- --></A><H3>
406getLocationInfo</H3>
407<PRE>
408public boolean <B>getLocationInfo</B>()</PRE>
409<DL>
410<DD>Returns the current value of the <b>LocationInfo</b> option.
411<P>
412<DD><DL>
413</DL>
414</DD>
415</DL>
416<HR>
417
418<A NAME="setTitle(java.lang.String)"><!-- --></A><H3>
419setTitle</H3>
420<PRE>
421public void <B>setTitle</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> title)</PRE>
422<DL>
423<DD>The <b>Title</b> option takes a String value. This option sets the
424 document title of the generated HTML document.
425
426 <p>Defaults to 'Log4J Log Messages'.
427<P>
428<DD><DL>
429</DL>
430</DD>
431</DL>
432<HR>
433
434<A NAME="getTitle()"><!-- --></A><H3>
435getTitle</H3>
436<PRE>
437public <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>getTitle</B>()</PRE>
438<DL>
439<DD>Returns the current value of the <b>Title</b> option.
440<P>
441<DD><DL>
442</DL>
443</DD>
444</DL>
445<HR>
446
447<A NAME="getContentType()"><!-- --></A><H3>
448getContentType</H3>
449<PRE>
450public <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>getContentType</B>()</PRE>
451<DL>
452<DD>Returns the content type output by this layout, i.e "text/html".
453<P>
454<DD><DL>
455<DT><B>Overrides:</B><DD><CODE><A HREF="../../../org/apache/log4j/Layout.html#getContentType()">getContentType</A></CODE> in class <CODE><A HREF="../../../org/apache/log4j/Layout.html" title="class in org.apache.log4j">Layout</A></CODE></DL>
456</DD>
457<DD><DL>
458</DL>
459</DD>
460</DL>
461<HR>
462
463<A NAME="activateOptions()"><!-- --></A><H3>
464activateOptions</H3>
465<PRE>
466public void <B>activateOptions</B>()</PRE>
467<DL>
468<DD>No options to activate.
469<P>
470<DD><DL>
471</DL>
472</DD>
473</DL>
474<HR>
475
476<A NAME="format(org.apache.log4j.spi.LoggingEvent)"><!-- --></A><H3>
477format</H3>
478<PRE>
479public <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>format</B>(<A HREF="../../../org/apache/log4j/spi/LoggingEvent.html" title="class in org.apache.log4j.spi">LoggingEvent</A> event)</PRE>
480<DL>
481<DD><B>Description copied from class: <CODE><A HREF="../../../org/apache/log4j/Layout.html#format(org.apache.log4j.spi.LoggingEvent)">Layout</A></CODE></B></DD>
482<DD>Implement this method to create your own layout format.
483<P>
484<DD><DL>
485<DT><B>Specified by:</B><DD><CODE><A HREF="../../../org/apache/log4j/Layout.html#format(org.apache.log4j.spi.LoggingEvent)">format</A></CODE> in class <CODE><A HREF="../../../org/apache/log4j/Layout.html" title="class in org.apache.log4j">Layout</A></CODE></DL>
486</DD>
487<DD><DL>
488</DL>
489</DD>
490</DL>
491<HR>
492
493<A NAME="getHeader()"><!-- --></A><H3>
494getHeader</H3>
495<PRE>
496public <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>getHeader</B>()</PRE>
497<DL>
498<DD>Returns appropriate HTML headers.
499<P>
500<DD><DL>
501<DT><B>Overrides:</B><DD><CODE><A HREF="../../../org/apache/log4j/Layout.html#getHeader()">getHeader</A></CODE> in class <CODE><A HREF="../../../org/apache/log4j/Layout.html" title="class in org.apache.log4j">Layout</A></CODE></DL>
502</DD>
503<DD><DL>
504</DL>
505</DD>
506</DL>
507<HR>
508
509<A NAME="getFooter()"><!-- --></A><H3>
510getFooter</H3>
511<PRE>
512public <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>getFooter</B>()</PRE>
513<DL>
514<DD>Returns the appropriate HTML footers.
515<P>
516<DD><DL>
517<DT><B>Overrides:</B><DD><CODE><A HREF="../../../org/apache/log4j/Layout.html#getFooter()">getFooter</A></CODE> in class <CODE><A HREF="../../../org/apache/log4j/Layout.html" title="class in org.apache.log4j">Layout</A></CODE></DL>
518</DD>
519<DD><DL>
520</DL>
521</DD>
522</DL>
523<HR>
524
525<A NAME="ignoresThrowable()"><!-- --></A><H3>
526ignoresThrowable</H3>
527<PRE>
528public boolean <B>ignoresThrowable</B>()</PRE>
529<DL>
530<DD>The HTML layout handles the throwable contained in logging
531 events. Hence, this method return <code>false</code>.
532<P>
533<DD><DL>
534<DT><B>Specified by:</B><DD><CODE><A HREF="../../../org/apache/log4j/Layout.html#ignoresThrowable()">ignoresThrowable</A></CODE> in class <CODE><A HREF="../../../org/apache/log4j/Layout.html" title="class in org.apache.log4j">Layout</A></CODE></DL>
535</DD>
536<DD><DL>
537</DL>
538</DD>
539</DL>
540<!-- ========= END OF CLASS DATA ========= -->
541<HR>
542
543
544<!-- ======= START OF BOTTOM NAVBAR ====== -->
545<A NAME="navbar_bottom"><!-- --></A>
546<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
547<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
548<TR>
549<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
550<A NAME="navbar_bottom_firstrow"><!-- --></A>
551<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
552 <TR ALIGN="center" VALIGN="top">
553 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
554 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
555 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
556 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/HTMLLayout.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
557 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
558 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
559 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
560 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
561 </TR>
562</TABLE>
563</TD>
564<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
565</EM>
566</TD>
567</TR>
568
569<TR>
570<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
571 <A HREF="../../../org/apache/log4j/Hierarchy.html" title="class in org.apache.log4j"><B>PREV CLASS</B></A>
572 <A HREF="../../../org/apache/log4j/Layout.html" title="class in org.apache.log4j"><B>NEXT CLASS</B></A></FONT></TD>
573<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
574 <A HREF="../../../index.html?org/apache/log4j/HTMLLayout.html" target="_top"><B>FRAMES</B></A>
575 <A HREF="HTMLLayout.html" target="_top"><B>NO FRAMES</B></A>
576 <SCRIPT type="text/javascript">
577 <!--
578 if(window==top) {
579 document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
580 }
581 //-->
582</SCRIPT>
583<NOSCRIPT>
584 <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
585</NOSCRIPT>
586
587
588</FONT></TD>
589</TR>
590<TR>
591<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
592 SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
593<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
594DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
595</TR>
596</TABLE>
597<A NAME="skip-navbar_bottom"></A>
598<!-- ======== END OF BOTTOM NAVBAR ======= -->
599
600<HR>
601Copyright © 1999-2010 <a href="http://www.apache.org">Apache Software Foundation</a>. All Rights Reserved.
602</BODY>
603</HTML>