| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
| <!-- NewPage --> |
| <html lang="en"> |
| <head> |
| <!-- Generated by javadoc (version 1.7.0_80) on Fri Aug 03 22:48:32 MST 2018 --> |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <title>IoBuilder (Apache Log4j Streaming Interface 2.11.1 API)</title> |
| <meta name="date" content="2018-08-03"> |
| <link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style"> |
| </head> |
| <body> |
| <script type="text/javascript"><!-- |
| if (location.href.indexOf('is-external=true') == -1) { |
| parent.document.title="IoBuilder (Apache Log4j Streaming Interface 2.11.1 API)"; |
| } |
| //--> |
| </script> |
| <noscript> |
| <div>JavaScript is disabled on your browser.</div> |
| </noscript> |
| <!-- ========= START OF TOP NAVBAR ======= --> |
| <div class="topNav"><a name="navbar_top"> |
| <!-- --> |
| </a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow"> |
| <!-- --> |
| </a> |
| <ul class="navList" title="Navigation"> |
| <li><a href="../../../../../org/apache/logging/log4j/io/package-summary.html">Package</a></li> |
| <li class="navBarCell1Rev">Class</li> |
| <li><a href="class-use/IoBuilder.html">Use</a></li> |
| <li><a href="package-tree.html">Tree</a></li> |
| <li><a href="../../../../../deprecated-list.html">Deprecated</a></li> |
| <li><a href="../../../../../index-all.html">Index</a></li> |
| <li><a href="../../../../../help-doc.html">Help</a></li> |
| </ul> |
| </div> |
| <div class="subNav"> |
| <ul class="navList"> |
| <li><a href="../../../../../org/apache/logging/log4j/io/CharStreamLogger.html" title="class in org.apache.logging.log4j.io"><span class="strong">Prev Class</span></a></li> |
| <li><a href="../../../../../org/apache/logging/log4j/io/LoggerBufferedInputStream.html" title="class in org.apache.logging.log4j.io"><span class="strong">Next Class</span></a></li> |
| </ul> |
| <ul class="navList"> |
| <li><a href="../../../../../index.html?org/apache/logging/log4j/io/IoBuilder.html" target="_top">Frames</a></li> |
| <li><a href="IoBuilder.html" target="_top">No Frames</a></li> |
| </ul> |
| <ul class="navList" id="allclasses_navbar_top"> |
| <li><a href="../../../../../allclasses-noframe.html">All Classes</a></li> |
| </ul> |
| <div> |
| <script type="text/javascript"><!-- |
| allClassesLink = document.getElementById("allclasses_navbar_top"); |
| if(window==top) { |
| allClassesLink.style.display = "block"; |
| } |
| else { |
| allClassesLink.style.display = "none"; |
| } |
| //--> |
| </script> |
| </div> |
| <div> |
| <ul class="subNavList"> |
| <li>Summary: </li> |
| <li>Nested | </li> |
| <li>Field | </li> |
| <li><a href="#constructor_summary">Constr</a> | </li> |
| <li><a href="#method_summary">Method</a></li> |
| </ul> |
| <ul class="subNavList"> |
| <li>Detail: </li> |
| <li>Field | </li> |
| <li><a href="#constructor_detail">Constr</a> | </li> |
| <li><a href="#method_detail">Method</a></li> |
| </ul> |
| </div> |
| <a name="skip-navbar_top"> |
| <!-- --> |
| </a></div> |
| <!-- ========= END OF TOP NAVBAR ========= --> |
| <!-- ======== START OF CLASS DATA ======== --> |
| <div class="header"> |
| <div class="subTitle">org.apache.logging.log4j.io</div> |
| <h2 title="Class IoBuilder" class="title">Class IoBuilder</h2> |
| </div> |
| <div class="contentContainer"> |
| <ul class="inheritance"> |
| <li><a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li> |
| <li> |
| <ul class="inheritance"> |
| <li>org.apache.logging.log4j.io.IoBuilder</li> |
| </ul> |
| </li> |
| </ul> |
| <div class="description"> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <hr> |
| <br> |
| <pre>public class <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.57">IoBuilder</a> |
| extends <a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre> |
| <div class="block">Builder class to wrap <code>Loggers</code> into Java IO compatible classes. |
| |
| <p>Both the <a href="https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a>/<a href="https://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io"><code>OutputStream</code></a> and <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io"><code>Reader</code></a>/<a href="https://docs.oracle.com/javase/7/docs/api/java/io/Writer.html?is-external=true" title="class or interface in java.io"><code>Writer</code></a> family of classes are |
| supported. <a href="https://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io"><code>OutputStream</code></a> and <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Writer.html?is-external=true" title="class or interface in java.io"><code>Writer</code></a> instances can be wrapped by a filtered version of their |
| corresponding classes (<a href="https://docs.oracle.com/javase/7/docs/api/java/io/FilterOutputStream.html?is-external=true" title="class or interface in java.io"><code>FilterOutputStream</code></a> and <a href="https://docs.oracle.com/javase/7/docs/api/java/io/FilterWriter.html?is-external=true" title="class or interface in java.io"><code>FilterWriter</code></a>) in order to log all |
| lines written to these instances. <a href="https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a> and <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io"><code>Reader</code></a> instances can be wrapped by a sort of |
| wiretapped version of their respective classes; all lines read from these instances will be logged.</p> |
| |
| <p>The main feature, however, is the ability to create a <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io"><code>PrintWriter</code></a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io"><code>PrintStream</code></a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Writer.html?is-external=true" title="class or interface in java.io"><code>Writer</code></a>, |
| <a href="https://docs.oracle.com/javase/7/docs/api/java/io/BufferedWriter.html?is-external=true" title="class or interface in java.io"><code>BufferedWriter</code></a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io"><code>OutputStream</code></a>, or <a href="https://docs.oracle.com/javase/7/docs/api/java/io/BufferedOutputStream.html?is-external=true" title="class or interface in java.io"><code>BufferedOutputStream</code></a> that is backed by a |
| <code>Logger</code>. The main inspiration for this feature is the JDBC API which uses a PrintWriter to perform debug |
| logging. In order to properly integrate APIs like JDBC into Log4j, create a PrintWriter using this class.</p> |
| |
| <p>The IoBuilder support configuration of the logging <code>Level</code> it should use (defaults to the level of |
| the underlying Logger), and an optional <code>Marker</code>. The other configurable objects are explained in more |
| detail below.</p></div> |
| <dl><dt><span class="strong">Since:</span></dt> |
| <dd>2.1</dd></dl> |
| </li> |
| </ul> |
| </div> |
| <div class="summary"> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <!-- ======== CONSTRUCTOR SUMMARY ======== --> |
| <ul class="blockList"> |
| <li class="blockList"><a name="constructor_summary"> |
| <!-- --> |
| </a> |
| <h3>Constructor Summary</h3> |
| <table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation"> |
| <caption><span>Constructors</span><span class="tabEnd"> </span></caption> |
| <tr> |
| <th class="colFirst" scope="col">Modifier</th> |
| <th class="colLast" scope="col">Constructor and Description</th> |
| </tr> |
| <tr class="altColor"> |
| <td class="colFirst"><code>protected </code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#IoBuilder(org.apache.logging.log4j.Logger)">IoBuilder</a></strong>(org.apache.logging.log4j.Logger logger)</code> |
| <div class="block">Constructs a new IoBuilder for the given Logger.</div> |
| </td> |
| </tr> |
| </table> |
| </li> |
| </ul> |
| <!-- ========== METHOD SUMMARY =========== --> |
| <ul class="blockList"> |
| <li class="blockList"><a name="method_summary"> |
| <!-- --> |
| </a> |
| <h3>Method Summary</h3> |
| <table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> |
| <caption><span>Methods</span><span class="tabEnd"> </span></caption> |
| <tr> |
| <th class="colFirst" scope="col">Modifier and Type</th> |
| <th class="colLast" scope="col">Method and Description</th> |
| </tr> |
| <tr class="altColor"> |
| <td class="colFirst"><code><a href="https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#buildInputStream()">buildInputStream</a></strong>()</code> |
| <div class="block">Builds a new <a href="https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a> that is wiretapped by its underlying Logger.</div> |
| </td> |
| </tr> |
| <tr class="rowColor"> |
| <td class="colFirst"><code><a href="https://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#buildOutputStream()">buildOutputStream</a></strong>()</code> |
| <div class="block">Builds a new <a href="https://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io"><code>OutputStream</code></a> that is backed by a Logger and optionally writes to another OutputStream as |
| well.</div> |
| </td> |
| </tr> |
| <tr class="altColor"> |
| <td class="colFirst"><code><a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#buildPrintStream()">buildPrintStream</a></strong>()</code> |
| <div class="block">Builds a new <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io"><code>PrintStream</code></a> that is backed by a Logger and optionally writes to another OutputStream as |
| well.</div> |
| </td> |
| </tr> |
| <tr class="rowColor"> |
| <td class="colFirst"><code><a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io">PrintWriter</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#buildPrintWriter()">buildPrintWriter</a></strong>()</code> |
| <div class="block">Builds a new <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io"><code>PrintWriter</code></a> that is backed by a Logger and optionally writes to another Writer as well.</div> |
| </td> |
| </tr> |
| <tr class="altColor"> |
| <td class="colFirst"><code><a href="https://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io">Reader</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#buildReader()">buildReader</a></strong>()</code> |
| <div class="block">Builds a new <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io"><code>Reader</code></a> that is wiretapped by its underlying Logger.</div> |
| </td> |
| </tr> |
| <tr class="rowColor"> |
| <td class="colFirst"><code><a href="https://docs.oracle.com/javase/7/docs/api/java/io/Writer.html?is-external=true" title="class or interface in java.io">Writer</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#buildWriter()">buildWriter</a></strong>()</code> |
| <div class="block">Builds a new <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Writer.html?is-external=true" title="class or interface in java.io"><code>Writer</code></a> that is backed by a Logger and optionally writes to another Writer as well.</div> |
| </td> |
| </tr> |
| <tr class="altColor"> |
| <td class="colFirst"><code><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#filter(java.io.InputStream)">filter</a></strong>(<a href="https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</a> inputStream)</code> |
| <div class="block">Configures an <a href="https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a> to be wiretapped when building an InputStream.</div> |
| </td> |
| </tr> |
| <tr class="rowColor"> |
| <td class="colFirst"><code><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#filter(java.io.OutputStream)">filter</a></strong>(<a href="https://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a> outputStream)</code> |
| <div class="block">Configures an <a href="https://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io"><code>OutputStream</code></a> to be written to in addition to the underlying Logger.</div> |
| </td> |
| </tr> |
| <tr class="altColor"> |
| <td class="colFirst"><code><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#filter(java.io.Reader)">filter</a></strong>(<a href="https://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io">Reader</a> reader)</code> |
| <div class="block">Configures a <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io"><code>Reader</code></a> to be wiretapped when building a Reader.</div> |
| </td> |
| </tr> |
| <tr class="rowColor"> |
| <td class="colFirst"><code><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#filter(java.io.Writer)">filter</a></strong>(<a href="https://docs.oracle.com/javase/7/docs/api/java/io/Writer.html?is-external=true" title="class or interface in java.io">Writer</a> writer)</code> |
| <div class="block">Configures a <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Writer.html?is-external=true" title="class or interface in java.io"><code>Writer</code></a> to be written to in addition to the underlying Logger.</div> |
| </td> |
| </tr> |
| <tr class="altColor"> |
| <td class="colFirst"><code>static <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#forLogger()">forLogger</a></strong>()</code> |
| <div class="block">Creates a new builder using a Logger named after the calling Class.</div> |
| </td> |
| </tr> |
| <tr class="rowColor"> |
| <td class="colFirst"><code>static <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#forLogger(java.lang.Class)">forLogger</a></strong>(<a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> clazz)</code> |
| <div class="block">Creates a new builder using a Logger named after a given Class.</div> |
| </td> |
| </tr> |
| <tr class="altColor"> |
| <td class="colFirst"><code>static <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#forLogger(org.apache.logging.log4j.Logger)">forLogger</a></strong>(org.apache.logging.log4j.Logger logger)</code> |
| <div class="block">Creates a new builder for a given <code>Logger</code>.</div> |
| </td> |
| </tr> |
| <tr class="rowColor"> |
| <td class="colFirst"><code>static <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#forLogger(java.lang.String)">forLogger</a></strong>(<a href="https://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> loggerName)</code> |
| <div class="block">Creates a new builder using a Logger name.</div> |
| </td> |
| </tr> |
| <tr class="altColor"> |
| <td class="colFirst"><code><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#setAutoFlush(boolean)">setAutoFlush</a></strong>(boolean autoFlush)</code> |
| <div class="block">Indicates whether or not a built <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io"><code>PrintWriter</code></a> or <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io"><code>PrintStream</code></a> should automatically flush when |
| one of the <code>println</code>, <code>printf</code>, or <code>format</code> methods are invoked, or when a new line character |
| is printed.</div> |
| </td> |
| </tr> |
| <tr class="rowColor"> |
| <td class="colFirst"><code><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#setBuffered(boolean)">setBuffered</a></strong>(boolean buffered)</code> |
| <div class="block">Enables or disables using a buffered variant of the desired IO class.</div> |
| </td> |
| </tr> |
| <tr class="altColor"> |
| <td class="colFirst"><code><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#setBufferSize(int)">setBufferSize</a></strong>(int bufferSize)</code> |
| <div class="block">Configures the buffer size to use when building a <a href="https://docs.oracle.com/javase/7/docs/api/java/io/BufferedReader.html?is-external=true" title="class or interface in java.io"><code>BufferedReader</code></a> or |
| <a href="https://docs.oracle.com/javase/7/docs/api/java/io/BufferedInputStream.html?is-external=true" title="class or interface in java.io"><code>BufferedInputStream</code></a> LoggerStream.</div> |
| </td> |
| </tr> |
| <tr class="rowColor"> |
| <td class="colFirst"><code><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#setCharset(java.nio.charset.Charset)">setCharset</a></strong>(<a href="https://docs.oracle.com/javase/7/docs/api/java/nio/charset/Charset.html?is-external=true" title="class or interface in java.nio.charset">Charset</a> charset)</code> |
| <div class="block">Specifies the character set to use when building an <a href="https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io"><code>OutputStream</code></a>, or |
| <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io"><code>PrintStream</code></a>.</div> |
| </td> |
| </tr> |
| <tr class="altColor"> |
| <td class="colFirst"><code><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#setLevel(org.apache.logging.log4j.Level)">setLevel</a></strong>(org.apache.logging.log4j.Level level)</code> |
| <div class="block">Specifies the <code>Level</code> to log at.</div> |
| </td> |
| </tr> |
| <tr class="rowColor"> |
| <td class="colFirst"><code><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#setMarker(org.apache.logging.log4j.Marker)">setMarker</a></strong>(org.apache.logging.log4j.Marker marker)</code> |
| <div class="block">Specifies an optional <code>Marker</code> to use in all logging messages.</div> |
| </td> |
| </tr> |
| <tr class="altColor"> |
| <td class="colFirst"><code><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a></code></td> |
| <td class="colLast"><code><strong><a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#setWrapperClassName(java.lang.String)">setWrapperClassName</a></strong>(<a href="https://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> fqcn)</code> |
| <div class="block">Specifies the fully qualified class name of the IO wrapper class implementation.</div> |
| </td> |
| </tr> |
| </table> |
| <ul class="blockList"> |
| <li class="blockList"><a name="methods_inherited_from_class_java.lang.Object"> |
| <!-- --> |
| </a> |
| <h3>Methods inherited from class java.lang.<a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3> |
| <code><a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long,%20int)" title="class or interface in java.lang">wait</a></code></li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </div> |
| <div class="details"> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <!-- ========= CONSTRUCTOR DETAIL ======== --> |
| <ul class="blockList"> |
| <li class="blockList"><a name="constructor_detail"> |
| <!-- --> |
| </a> |
| <h3>Constructor Detail</h3> |
| <a name="IoBuilder(org.apache.logging.log4j.Logger)"> |
| <!-- --> |
| </a> |
| <ul class="blockListLast"> |
| <li class="blockList"> |
| <h4>IoBuilder</h4> |
| <pre>protected <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.124">IoBuilder</a>(org.apache.logging.log4j.Logger logger)</pre> |
| <div class="block">Constructs a new IoBuilder for the given Logger. This method is provided for extensibility of this builder |
| class. The static factory methods should be used normally.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>logger</code> - the <code>ExtendedLogger</code> to wrap</dd></dl> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| <!-- ============ METHOD DETAIL ========== --> |
| <ul class="blockList"> |
| <li class="blockList"><a name="method_detail"> |
| <!-- --> |
| </a> |
| <h3>Method Detail</h3> |
| <a name="forLogger(org.apache.logging.log4j.Logger)"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>forLogger</h4> |
| <pre>public static <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.80">forLogger</a>(org.apache.logging.log4j.Logger logger)</pre> |
| <div class="block">Creates a new builder for a given <code>Logger</code>. The Logger instance must implement <code>ExtendedLogger</code> or |
| an exception will be thrown.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>logger</code> - the Logger to wrap into a LoggerStream</dd> |
| <dt><span class="strong">Returns:</span></dt><dd>a new IoBuilder</dd> |
| <dt><span class="strong">Throws:</span></dt> |
| <dd><code><a href="https://docs.oracle.com/javase/7/docs/api/java/lang/UnsupportedOperationException.html?is-external=true" title="class or interface in java.lang">UnsupportedOperationException</a></code> - if <code>logger</code> does not implement <code>ExtendedLogger</code> or if |
| <code>logger</code> is <code>null</code></dd></dl> |
| </li> |
| </ul> |
| <a name="forLogger(java.lang.String)"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>forLogger</h4> |
| <pre>public static <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.91">forLogger</a>(<a href="https://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> loggerName)</pre> |
| <div class="block">Creates a new builder using a Logger name. The name provided is used to get a Logger from |
| <code>LogManager.getLogger(String)</code> which will be wrapped into a LoggerStream.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>loggerName</code> - the name of the Logger to wrap into a LoggerStream</dd> |
| <dt><span class="strong">Returns:</span></dt><dd>a new IoBuilder</dd></dl> |
| </li> |
| </ul> |
| <a name="forLogger(java.lang.Class)"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>forLogger</h4> |
| <pre>public static <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.102">forLogger</a>(<a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><?> clazz)</pre> |
| <div class="block">Creates a new builder using a Logger named after a given Class. The Class provided is used to get a Logger from |
| <code>LogManager.getLogger(Class)</code> which will be wrapped into a LoggerStream.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>clazz</code> - the Class to use as the Logger name to wrap into a LoggerStream</dd> |
| <dt><span class="strong">Returns:</span></dt><dd>a new IoBuilder</dd></dl> |
| </li> |
| </ul> |
| <a name="forLogger()"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>forLogger</h4> |
| <pre>public static <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.114">forLogger</a>()</pre> |
| <div class="block">Creates a new builder using a Logger named after the calling Class. This is equivalent to the following: |
| <pre> |
| IoBuilder builder = IoBuilder.forLogger(LogManager.getLogger()); |
| </pre></div> |
| <dl><dt><span class="strong">Returns:</span></dt><dd>a new IoBuilder</dd></dl> |
| </li> |
| </ul> |
| <a name="setLevel(org.apache.logging.log4j.Level)"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>setLevel</h4> |
| <pre>public <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.139">setLevel</a>(org.apache.logging.log4j.Level level)</pre> |
| <div class="block">Specifies the <code>Level</code> to log at. If no Level is configured, then the Level of the wrapped Logger will be |
| used.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>level</code> - the Level to use for logging</dd> |
| <dt><span class="strong">Returns:</span></dt><dd><code>this</code></dd></dl> |
| </li> |
| </ul> |
| <a name="setMarker(org.apache.logging.log4j.Marker)"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>setMarker</h4> |
| <pre>public <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.151">setMarker</a>(org.apache.logging.log4j.Marker marker)</pre> |
| <div class="block">Specifies an optional <code>Marker</code> to use in all logging messages. If no Marker is specified, then no Marker |
| will be used.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>marker</code> - the Marker to associate with all logging messages</dd> |
| <dt><span class="strong">Returns:</span></dt><dd><code>this</code></dd></dl> |
| </li> |
| </ul> |
| <a name="setWrapperClassName(java.lang.String)"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>setWrapperClassName</h4> |
| <pre>public <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.163">setWrapperClassName</a>(<a href="https://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> fqcn)</pre> |
| <div class="block">Specifies the fully qualified class name of the IO wrapper class implementation. This method should only be |
| used when making significant extensions to the provided classes in this component and is normally unnecessary.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>fqcn</code> - the fully qualified class name of the IO wrapper class being built</dd> |
| <dt><span class="strong">Returns:</span></dt><dd><code>this</code></dd></dl> |
| </li> |
| </ul> |
| <a name="setAutoFlush(boolean)"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>setAutoFlush</h4> |
| <pre>public <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.176">setAutoFlush</a>(boolean autoFlush)</pre> |
| <div class="block">Indicates whether or not a built <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io"><code>PrintWriter</code></a> or <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io"><code>PrintStream</code></a> should automatically flush when |
| one of the <code>println</code>, <code>printf</code>, or <code>format</code> methods are invoked, or when a new line character |
| is printed.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>autoFlush</code> - if <code>true</code>, then <code>println</code>, <code>printf</code>, and <code>format</code> will auto flush</dd> |
| <dt><span class="strong">Returns:</span></dt><dd><code>this</code></dd></dl> |
| </li> |
| </ul> |
| <a name="setBuffered(boolean)"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>setBuffered</h4> |
| <pre>public <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.190">setBuffered</a>(boolean buffered)</pre> |
| <div class="block">Enables or disables using a buffered variant of the desired IO class. If this is set to <code>true</code>, then the |
| instances returned by <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#buildReader()"><code>buildReader()</code></a> and <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#buildInputStream()"><code>buildInputStream()</code></a> can be safely cast (if necessary) |
| to <a href="https://docs.oracle.com/javase/7/docs/api/java/io/BufferedReader.html?is-external=true" title="class or interface in java.io"><code>BufferedReader</code></a> and <a href="https://docs.oracle.com/javase/7/docs/api/java/io/BufferedInputStream.html?is-external=true" title="class or interface in java.io"><code>BufferedInputStream</code></a> respectively. This option does not |
| have any effect on the other built variants.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>buffered</code> - indicates whether or not a wrapped <a href="https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a> or <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io"><code>Reader</code></a> should be buffered</dd> |
| <dt><span class="strong">Returns:</span></dt><dd><code>this</code></dd></dl> |
| </li> |
| </ul> |
| <a name="setBufferSize(int)"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>setBufferSize</h4> |
| <pre>public <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.202">setBufferSize</a>(int bufferSize)</pre> |
| <div class="block">Configures the buffer size to use when building a <a href="https://docs.oracle.com/javase/7/docs/api/java/io/BufferedReader.html?is-external=true" title="class or interface in java.io"><code>BufferedReader</code></a> or |
| <a href="https://docs.oracle.com/javase/7/docs/api/java/io/BufferedInputStream.html?is-external=true" title="class or interface in java.io"><code>BufferedInputStream</code></a> LoggerStream.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>bufferSize</code> - the buffer size to use or a non-positive integer to use the default size</dd> |
| <dt><span class="strong">Returns:</span></dt><dd><code>this</code></dd></dl> |
| </li> |
| </ul> |
| <a name="setCharset(java.nio.charset.Charset)"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>setCharset</h4> |
| <pre>public <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.215">setCharset</a>(<a href="https://docs.oracle.com/javase/7/docs/api/java/nio/charset/Charset.html?is-external=true" title="class or interface in java.nio.charset">Charset</a> charset)</pre> |
| <div class="block">Specifies the character set to use when building an <a href="https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a>, <a href="https://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io"><code>OutputStream</code></a>, or |
| <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io"><code>PrintStream</code></a>. If no character set is specified, then <a href="https://docs.oracle.com/javase/7/docs/api/java/nio/charset/Charset.html?is-external=true#defaultCharset()" title="class or interface in java.nio.charset"><code>Charset.defaultCharset()</code></a> |
| is used.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>charset</code> - the character set to use when building an InputStream, OutputStream, or PrintStream</dd> |
| <dt><span class="strong">Returns:</span></dt><dd><code>this</code></dd></dl> |
| </li> |
| </ul> |
| <a name="filter(java.io.Reader)"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>filter</h4> |
| <pre>public <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.227">filter</a>(<a href="https://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io">Reader</a> reader)</pre> |
| <div class="block">Configures a <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io"><code>Reader</code></a> to be wiretapped when building a Reader. This must be set to a non-<code>null</code> |
| value in order to call <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#buildReader()"><code>buildReader()</code></a>.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>reader</code> - the Reader to wiretap</dd> |
| <dt><span class="strong">Returns:</span></dt><dd><code>this</code></dd></dl> |
| </li> |
| </ul> |
| <a name="filter(java.io.Writer)"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>filter</h4> |
| <pre>public <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.239">filter</a>(<a href="https://docs.oracle.com/javase/7/docs/api/java/io/Writer.html?is-external=true" title="class or interface in java.io">Writer</a> writer)</pre> |
| <div class="block">Configures a <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Writer.html?is-external=true" title="class or interface in java.io"><code>Writer</code></a> to be written to in addition to the underlying Logger. If no Writer is specified, |
| then the built Writer or PrintWriter will only write to the underlying Logger.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>writer</code> - the Writer to write to in addition to the Logger</dd> |
| <dt><span class="strong">Returns:</span></dt><dd><code>this</code></dd></dl> |
| </li> |
| </ul> |
| <a name="filter(java.io.InputStream)"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>filter</h4> |
| <pre>public <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.251">filter</a>(<a href="https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</a> inputStream)</pre> |
| <div class="block">Configures an <a href="https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a> to be wiretapped when building an InputStream. This must be set to a |
| non-<code>null</code> value in order to call <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html#buildInputStream()"><code>buildInputStream()</code></a>.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>inputStream</code> - the InputStream to wiretap</dd> |
| <dt><span class="strong">Returns:</span></dt><dd><code>this</code></dd></dl> |
| </li> |
| </ul> |
| <a name="filter(java.io.OutputStream)"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>filter</h4> |
| <pre>public <a href="../../../../../org/apache/logging/log4j/io/IoBuilder.html" title="class in org.apache.logging.log4j.io">IoBuilder</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.263">filter</a>(<a href="https://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a> outputStream)</pre> |
| <div class="block">Configures an <a href="https://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io"><code>OutputStream</code></a> to be written to in addition to the underlying Logger. If no OutputStream is |
| specified, then the built OutputStream or PrintStream will only write to the underlying Logger.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>outputStream</code> - the OutputStream to write to in addition to the Logger</dd> |
| <dt><span class="strong">Returns:</span></dt><dd><code>this</code></dd></dl> |
| </li> |
| </ul> |
| <a name="buildReader()"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>buildReader</h4> |
| <pre>public <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io">Reader</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.277">buildReader</a>()</pre> |
| <div class="block">Builds a new <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io"><code>Reader</code></a> that is wiretapped by its underlying Logger. If buffering is enabled, then a |
| <a href="https://docs.oracle.com/javase/7/docs/api/java/io/BufferedReader.html?is-external=true" title="class or interface in java.io"><code>BufferedReader</code></a> will be returned.</div> |
| <dl><dt><span class="strong">Returns:</span></dt><dd>a new Reader wiretapped by a Logger</dd> |
| <dt><span class="strong">Throws:</span></dt> |
| <dd><code><a href="https://docs.oracle.com/javase/7/docs/api/java/lang/IllegalStateException.html?is-external=true" title="class or interface in java.lang">IllegalStateException</a></code> - if no Reader was configured for this builder</dd></dl> |
| </li> |
| </ul> |
| <a name="buildWriter()"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>buildWriter</h4> |
| <pre>public <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Writer.html?is-external=true" title="class or interface in java.io">Writer</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.294">buildWriter</a>()</pre> |
| <div class="block">Builds a new <a href="https://docs.oracle.com/javase/7/docs/api/java/io/Writer.html?is-external=true" title="class or interface in java.io"><code>Writer</code></a> that is backed by a Logger and optionally writes to another Writer as well. If no |
| Writer is configured for this builder, then the returned Writer will only write to its underlying Logger.</div> |
| <dl><dt><span class="strong">Returns:</span></dt><dd>a new Writer or <a href="https://docs.oracle.com/javase/7/docs/api/java/io/FilterWriter.html?is-external=true" title="class or interface in java.io"><code>FilterWriter</code></a> backed by a Logger</dd></dl> |
| </li> |
| </ul> |
| <a name="buildPrintWriter()"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>buildPrintWriter</h4> |
| <pre>public <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io">PrintWriter</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.308">buildPrintWriter</a>()</pre> |
| <div class="block">Builds a new <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io"><code>PrintWriter</code></a> that is backed by a Logger and optionally writes to another Writer as well. If |
| no Writer is configured for this builder, then the returned PrintWriter will only write to its underlying |
| Logger.</div> |
| <dl><dt><span class="strong">Returns:</span></dt><dd>a new PrintWriter that optionally writes to another Writer in addition to its underlying Logger</dd></dl> |
| </li> |
| </ul> |
| <a name="buildInputStream()"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>buildInputStream</h4> |
| <pre>public <a href="https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.322">buildInputStream</a>()</pre> |
| <div class="block">Builds a new <a href="https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io"><code>InputStream</code></a> that is wiretapped by its underlying Logger. If buffering is enabled, then a |
| <a href="https://docs.oracle.com/javase/7/docs/api/java/io/BufferedInputStream.html?is-external=true" title="class or interface in java.io"><code>BufferedInputStream</code></a> will be returned.</div> |
| <dl><dt><span class="strong">Returns:</span></dt><dd>a new InputStream wiretapped by a Logger</dd> |
| <dt><span class="strong">Throws:</span></dt> |
| <dd><code><a href="https://docs.oracle.com/javase/7/docs/api/java/lang/IllegalStateException.html?is-external=true" title="class or interface in java.lang">IllegalStateException</a></code> - if no InputStream was configured for this builder</dd></dl> |
| </li> |
| </ul> |
| <a name="buildOutputStream()"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>buildOutputStream</h4> |
| <pre>public <a href="https://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.341">buildOutputStream</a>()</pre> |
| <div class="block">Builds a new <a href="https://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io"><code>OutputStream</code></a> that is backed by a Logger and optionally writes to another OutputStream as |
| well. If no OutputStream is configured for this builder, then the returned OutputStream will only write to its |
| underlying Logger.</div> |
| <dl><dt><span class="strong">Returns:</span></dt><dd>a new OutputStream that optionally writes to another OutputStream in addition to its underlying Logger</dd></dl> |
| </li> |
| </ul> |
| <a name="buildPrintStream()"> |
| <!-- --> |
| </a> |
| <ul class="blockListLast"> |
| <li class="blockList"> |
| <h4>buildPrintStream</h4> |
| <pre>public <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a> <a href="../../../../../src-html/org/apache/logging/log4j/io/IoBuilder.html#line.357">buildPrintStream</a>()</pre> |
| <div class="block">Builds a new <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io"><code>PrintStream</code></a> that is backed by a Logger and optionally writes to another OutputStream as |
| well. If no OutputStream is configured for this builder, then the returned PrintStream will only write to its |
| underlying Logger.</div> |
| <dl><dt><span class="strong">Returns:</span></dt><dd>a new PrintStream that optionally writes to another OutputStream in addition to its underlying Logger</dd> |
| <dt><span class="strong">Throws:</span></dt> |
| <dd><code>org.apache.logging.log4j.LoggingException</code> - if the configured character set is unsupported by <a href="https://docs.oracle.com/javase/7/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io"><code>PrintStream</code></a></dd></dl> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </div> |
| </div> |
| <!-- ========= END OF CLASS DATA ========= --> |
| <!-- ======= START OF BOTTOM NAVBAR ====== --> |
| <div class="bottomNav"><a name="navbar_bottom"> |
| <!-- --> |
| </a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow"> |
| <!-- --> |
| </a> |
| <ul class="navList" title="Navigation"> |
| <li><a href="../../../../../org/apache/logging/log4j/io/package-summary.html">Package</a></li> |
| <li class="navBarCell1Rev">Class</li> |
| <li><a href="class-use/IoBuilder.html">Use</a></li> |
| <li><a href="package-tree.html">Tree</a></li> |
| <li><a href="../../../../../deprecated-list.html">Deprecated</a></li> |
| <li><a href="../../../../../index-all.html">Index</a></li> |
| <li><a href="../../../../../help-doc.html">Help</a></li> |
| </ul> |
| </div> |
| <div class="subNav"> |
| <ul class="navList"> |
| <li><a href="../../../../../org/apache/logging/log4j/io/CharStreamLogger.html" title="class in org.apache.logging.log4j.io"><span class="strong">Prev Class</span></a></li> |
| <li><a href="../../../../../org/apache/logging/log4j/io/LoggerBufferedInputStream.html" title="class in org.apache.logging.log4j.io"><span class="strong">Next Class</span></a></li> |
| </ul> |
| <ul class="navList"> |
| <li><a href="../../../../../index.html?org/apache/logging/log4j/io/IoBuilder.html" target="_top">Frames</a></li> |
| <li><a href="IoBuilder.html" target="_top">No Frames</a></li> |
| </ul> |
| <ul class="navList" id="allclasses_navbar_bottom"> |
| <li><a href="../../../../../allclasses-noframe.html">All Classes</a></li> |
| </ul> |
| <div> |
| <script type="text/javascript"><!-- |
| allClassesLink = document.getElementById("allclasses_navbar_bottom"); |
| if(window==top) { |
| allClassesLink.style.display = "block"; |
| } |
| else { |
| allClassesLink.style.display = "none"; |
| } |
| //--> |
| </script> |
| </div> |
| <div> |
| <ul class="subNavList"> |
| <li>Summary: </li> |
| <li>Nested | </li> |
| <li>Field | </li> |
| <li><a href="#constructor_summary">Constr</a> | </li> |
| <li><a href="#method_summary">Method</a></li> |
| </ul> |
| <ul class="subNavList"> |
| <li>Detail: </li> |
| <li>Field | </li> |
| <li><a href="#constructor_detail">Constr</a> | </li> |
| <li><a href="#method_detail">Method</a></li> |
| </ul> |
| </div> |
| <a name="skip-navbar_bottom"> |
| <!-- --> |
| </a></div> |
| <!-- ======== END OF BOTTOM NAVBAR ======= --> |
| <p class="legalCopy"><small><p align="center">Copyright © 1999-2018 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All Rights Reserved.<br /> Apache Logging, Apache Log4j, Log4j, Apache, the Apache feather logo, the Apache Logging project logo, and the Apache Log4j logo are trademarks of The Apache Software Foundation.</p></small></p> |
| </body> |
| </html> |