PageRenderTime 28ms CodeModel.GetById 10ms RepoModel.GetById 0ms app.codeStats 0ms

/tools/ant/docs/manual/api/org/apache/tools/ant/BuildLogger.html

http://xformsdb.googlecode.com/
HTML | 311 lines | 254 code | 32 blank | 25 comment | 0 complexity | 49c4e1b19b8cbe63a158d22467bf755f MD5 | raw file
Possible License(s): LGPL-2.1, Apache-2.0, IPL-1.0
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
  2. <!--NewPage-->
  3. <HTML>
  4. <HEAD>
  5. <!-- Generated by javadoc on Thu Jun 02 15:13:47 CEST 2005 -->
  6. <TITLE>
  7. BuildLogger (Apache Ant API)
  8. </TITLE>
  9. <META NAME="keywords" CONTENT="org.apache.tools.ant.BuildLogger,BuildLogger interface">
  10. <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
  11. </HEAD>
  12. <SCRIPT>
  13. function asd()
  14. {
  15. parent.document.title="BuildLogger (Apache Ant API)";
  16. }
  17. </SCRIPT>
  18. <BODY BGCOLOR="white" onload="asd();">
  19. <!-- ========== START OF NAVBAR ========== -->
  20. <A NAME="navbar_top"><!-- --></A>
  21. <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  22. <TR>
  23. <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  24. <A NAME="navbar_top_firstrow"><!-- --></A>
  25. <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  26. <TR ALIGN="center" VALIGN="top">
  27. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  28. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  29. <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  30. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  31. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  32. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  33. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  34. </TR>
  35. </TABLE>
  36. </TD>
  37. <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  38. </EM>
  39. </TD>
  40. </TR>
  41. <TR>
  42. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  43. &nbsp;<A HREF="../../../../org/apache/tools/ant/BuildListener.html"><B>PREV CLASS</B></A>&nbsp;
  44. &nbsp;<A HREF="../../../../org/apache/tools/ant/DynamicAttribute.html"><B>NEXT CLASS</B></A></FONT></TD>
  45. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  46. <A HREF="../../../../index.html" TARGET="_top"><B>FRAMES</B></A> &nbsp;
  47. &nbsp;<A HREF="BuildLogger.html" TARGET="_top"><B>NO FRAMES</B></A> &nbsp;
  48. &nbsp;
  49. <SCRIPT>
  50. <!--
  51. if(window==top) {
  52. document.writeln('<A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
  53. }
  54. //-->
  55. </SCRIPT>
  56. <NOSCRIPT>
  57. <A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
  58. </NOSCRIPT>
  59. </FONT></TD>
  60. </TR>
  61. <TR>
  62. <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  63. SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  64. <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  65. DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  66. </TR>
  67. </TABLE>
  68. <!-- =========== END OF NAVBAR =========== -->
  69. <HR>
  70. <!-- ======== START OF CLASS DATA ======== -->
  71. <H2>
  72. <FONT SIZE="-1">
  73. org.apache.tools.ant</FONT>
  74. <BR>
  75. Interface BuildLogger</H2>
  76. <DL>
  77. <DT><B>All Superinterfaces:</B> <DD><A HREF="../../../../org/apache/tools/ant/BuildListener.html">BuildListener</A>, java.util.EventListener</DD>
  78. </DL>
  79. <DL>
  80. <DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../../org/apache/tools/ant/listener/CommonsLoggingListener.html">CommonsLoggingListener</A>, <A HREF="../../../../org/apache/tools/ant/DefaultLogger.html">DefaultLogger</A>, <A HREF="../../../../org/apache/tools/ant/taskdefs/RecorderEntry.html">RecorderEntry</A>, <A HREF="../../../../org/apache/tools/ant/XmlLogger.html">XmlLogger</A></DD>
  81. </DL>
  82. <HR>
  83. <DL>
  84. <DT>public interface <B>BuildLogger</B><DT>extends <A HREF="../../../../org/apache/tools/ant/BuildListener.html">BuildListener</A></DL>
  85. <P>
  86. Interface used by Ant to log the build output.
  87. A build logger is a build listener which has the 'right' to send output to
  88. the ant log, which is usually <code>System.out</code> unless redirected by
  89. the <code>-logfile</code> option.
  90. <P>
  91. <P>
  92. <HR>
  93. <P>
  94. <!-- ======== NESTED CLASS SUMMARY ======== -->
  95. <!-- =========== FIELD SUMMARY =========== -->
  96. <!-- ======== CONSTRUCTOR SUMMARY ======== -->
  97. <!-- ========== METHOD SUMMARY =========== -->
  98. <A NAME="method_summary"><!-- --></A>
  99. <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  100. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  101. <TD COLSPAN=2><FONT SIZE="+2">
  102. <B>Method Summary</B></FONT></TD>
  103. </TR>
  104. <TR BGCOLOR="white" CLASS="TableRowColor">
  105. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  106. <CODE>&nbsp;void</CODE></FONT></TD>
  107. <TD><CODE><B><A HREF="../../../../org/apache/tools/ant/BuildLogger.html#setEmacsMode(boolean)">setEmacsMode</A></B>(boolean&nbsp;emacsMode)</CODE>
  108. <BR>
  109. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets this logger to produce emacs (and other editor) friendly output.</TD>
  110. </TR>
  111. <TR BGCOLOR="white" CLASS="TableRowColor">
  112. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  113. <CODE>&nbsp;void</CODE></FONT></TD>
  114. <TD><CODE><B><A HREF="../../../../org/apache/tools/ant/BuildLogger.html#setErrorPrintStream(java.io.PrintStream)">setErrorPrintStream</A></B>(java.io.PrintStream&nbsp;err)</CODE>
  115. <BR>
  116. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the output stream to which this logger is to send error messages.</TD>
  117. </TR>
  118. <TR BGCOLOR="white" CLASS="TableRowColor">
  119. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  120. <CODE>&nbsp;void</CODE></FONT></TD>
  121. <TD><CODE><B><A HREF="../../../../org/apache/tools/ant/BuildLogger.html#setMessageOutputLevel(int)">setMessageOutputLevel</A></B>(int&nbsp;level)</CODE>
  122. <BR>
  123. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the highest level of message this logger should respond to.</TD>
  124. </TR>
  125. <TR BGCOLOR="white" CLASS="TableRowColor">
  126. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  127. <CODE>&nbsp;void</CODE></FONT></TD>
  128. <TD><CODE><B><A HREF="../../../../org/apache/tools/ant/BuildLogger.html#setOutputPrintStream(java.io.PrintStream)">setOutputPrintStream</A></B>(java.io.PrintStream&nbsp;output)</CODE>
  129. <BR>
  130. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the output stream to which this logger is to send its output.</TD>
  131. </TR>
  132. </TABLE>
  133. &nbsp;<A NAME="methods_inherited_from_class_org.apache.tools.ant.BuildListener"><!-- --></A>
  134. <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  135. <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
  136. <TD><B>Methods inherited from interface org.apache.tools.ant.<A HREF="../../../../org/apache/tools/ant/BuildListener.html">BuildListener</A></B></TD>
  137. </TR>
  138. <TR BGCOLOR="white" CLASS="TableRowColor">
  139. <TD><CODE><A HREF="../../../../org/apache/tools/ant/BuildListener.html#buildFinished(org.apache.tools.ant.BuildEvent)">buildFinished</A>, <A HREF="../../../../org/apache/tools/ant/BuildListener.html#buildStarted(org.apache.tools.ant.BuildEvent)">buildStarted</A>, <A HREF="../../../../org/apache/tools/ant/BuildListener.html#messageLogged(org.apache.tools.ant.BuildEvent)">messageLogged</A>, <A HREF="../../../../org/apache/tools/ant/BuildListener.html#targetFinished(org.apache.tools.ant.BuildEvent)">targetFinished</A>, <A HREF="../../../../org/apache/tools/ant/BuildListener.html#targetStarted(org.apache.tools.ant.BuildEvent)">targetStarted</A>, <A HREF="../../../../org/apache/tools/ant/BuildListener.html#taskFinished(org.apache.tools.ant.BuildEvent)">taskFinished</A>, <A HREF="../../../../org/apache/tools/ant/BuildListener.html#taskStarted(org.apache.tools.ant.BuildEvent)">taskStarted</A></CODE></TD>
  140. </TR>
  141. </TABLE>
  142. &nbsp;
  143. <P>
  144. <!-- ============ FIELD DETAIL =========== -->
  145. <!-- ========= CONSTRUCTOR DETAIL ======== -->
  146. <!-- ============ METHOD DETAIL ========== -->
  147. <A NAME="method_detail"><!-- --></A>
  148. <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  149. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  150. <TD COLSPAN=1><FONT SIZE="+2">
  151. <B>Method Detail</B></FONT></TD>
  152. </TR>
  153. </TABLE>
  154. <A NAME="setMessageOutputLevel(int)"><!-- --></A><H3>
  155. setMessageOutputLevel</H3>
  156. <PRE>
  157. public void <B>setMessageOutputLevel</B>(int&nbsp;level)</PRE>
  158. <DL>
  159. <DD>Sets the highest level of message this logger should respond to.
  160. Only messages with a message level lower than or equal to the
  161. given level should be written to the log.
  162. <P>
  163. Constants for the message levels are in the
  164. <A HREF="../../../../org/apache/tools/ant/Project.html"><CODE>Project</CODE></A> class. The order of the levels, from least
  165. to most verbose, is <code>MSG_ERR</code>, <code>MSG_WARN</code>,
  166. <code>MSG_INFO</code>, <code>MSG_VERBOSE</code>,
  167. <code>MSG_DEBUG</code>.
  168. <P>
  169. <DD><DL>
  170. </DL>
  171. </DD>
  172. <DD><DL>
  173. <DT><B>Parameters:</B><DD><CODE>level</CODE> - the logging level for the logger.</DL>
  174. </DD>
  175. </DL>
  176. <HR>
  177. <A NAME="setOutputPrintStream(java.io.PrintStream)"><!-- --></A><H3>
  178. setOutputPrintStream</H3>
  179. <PRE>
  180. public void <B>setOutputPrintStream</B>(java.io.PrintStream&nbsp;output)</PRE>
  181. <DL>
  182. <DD>Sets the output stream to which this logger is to send its output.
  183. <P>
  184. <DD><DL>
  185. </DL>
  186. </DD>
  187. <DD><DL>
  188. <DT><B>Parameters:</B><DD><CODE>output</CODE> - The output stream for the logger.
  189. Must not be <code>null</code>.</DL>
  190. </DD>
  191. </DL>
  192. <HR>
  193. <A NAME="setEmacsMode(boolean)"><!-- --></A><H3>
  194. setEmacsMode</H3>
  195. <PRE>
  196. public void <B>setEmacsMode</B>(boolean&nbsp;emacsMode)</PRE>
  197. <DL>
  198. <DD>Sets this logger to produce emacs (and other editor) friendly output.
  199. <P>
  200. <DD><DL>
  201. </DL>
  202. </DD>
  203. <DD><DL>
  204. <DT><B>Parameters:</B><DD><CODE>emacsMode</CODE> - <code>true</code> if output is to be unadorned so that
  205. emacs and other editors can parse files names, etc.</DL>
  206. </DD>
  207. </DL>
  208. <HR>
  209. <A NAME="setErrorPrintStream(java.io.PrintStream)"><!-- --></A><H3>
  210. setErrorPrintStream</H3>
  211. <PRE>
  212. public void <B>setErrorPrintStream</B>(java.io.PrintStream&nbsp;err)</PRE>
  213. <DL>
  214. <DD>Sets the output stream to which this logger is to send error messages.
  215. <P>
  216. <DD><DL>
  217. </DL>
  218. </DD>
  219. <DD><DL>
  220. <DT><B>Parameters:</B><DD><CODE>err</CODE> - The error stream for the logger.
  221. Must not be <code>null</code>.</DL>
  222. </DD>
  223. </DL>
  224. <!-- ========= END OF CLASS DATA ========= -->
  225. <HR>
  226. <!-- ========== START OF NAVBAR ========== -->
  227. <A NAME="navbar_bottom"><!-- --></A>
  228. <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  229. <TR>
  230. <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  231. <A NAME="navbar_bottom_firstrow"><!-- --></A>
  232. <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  233. <TR ALIGN="center" VALIGN="top">
  234. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  235. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  236. <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  237. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  238. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  239. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  240. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  241. </TR>
  242. </TABLE>
  243. </TD>
  244. <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  245. </EM>
  246. </TD>
  247. </TR>
  248. <TR>
  249. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  250. &nbsp;<A HREF="../../../../org/apache/tools/ant/BuildListener.html"><B>PREV CLASS</B></A>&nbsp;
  251. &nbsp;<A HREF="../../../../org/apache/tools/ant/DynamicAttribute.html"><B>NEXT CLASS</B></A></FONT></TD>
  252. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  253. <A HREF="../../../../index.html" TARGET="_top"><B>FRAMES</B></A> &nbsp;
  254. &nbsp;<A HREF="BuildLogger.html" TARGET="_top"><B>NO FRAMES</B></A> &nbsp;
  255. &nbsp;
  256. <SCRIPT>
  257. <!--
  258. if(window==top) {
  259. document.writeln('<A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
  260. }
  261. //-->
  262. </SCRIPT>
  263. <NOSCRIPT>
  264. <A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
  265. </NOSCRIPT>
  266. </FONT></TD>
  267. </TR>
  268. <TR>
  269. <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  270. SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  271. <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  272. DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  273. </TR>
  274. </TABLE>
  275. <!-- =========== END OF NAVBAR =========== -->
  276. <HR>
  277. Copyright Š 2000-2005 Apache Software Foundation. All Rights Reserved.
  278. </BODY>
  279. </HTML>