blob: 627c6475a4c18f7c793c8307cdae47c1cf816d22 [file] [log] [blame]
<!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 (1.8.0_92) on Thu Jun 07 14:26:28 EDT 2018 -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>NCSARequestLog (Jetty :: Project 9.3.24.v20180605 API)</title>
<meta name="date" content="2018-06-07">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
<script type="text/javascript" src="../../../../script.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="NCSARequestLog (Jetty :: Project 9.3.24.v20180605 API)";
}
}
catch(err) {
}
//-->
var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/NCSARequestLog.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/eclipse/jetty/server/MultiPartCleanerListener.html" title="class in org.eclipse.jetty.server"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
<li><a href="../../../../org/eclipse/jetty/server/NegotiatingServerConnection.html" title="class in org.eclipse.jetty.server"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../index.html?org/eclipse/jetty/server/NCSARequestLog.html" target="_top">Frames</a></li>
<li><a href="NCSARequestLog.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../../allclasses-noframe.html">All&nbsp;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:&nbsp;</li>
<li><a href="#nested.classes.inherited.from.class.org.eclipse.jetty.util.component.AbstractLifeCycle">Nested</a>&nbsp;|&nbsp;</li>
<li><a href="#fields.inherited.from.class.org.eclipse.jetty.server.AbstractNCSARequestLog">Field</a>&nbsp;|&nbsp;</li>
<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</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.eclipse.jetty.server</div>
<h2 title="Class NCSARequestLog" class="title">Class NCSARequestLog</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li>java.lang.Object</li>
<li>
<ul class="inheritance">
<li><a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html" title="class in org.eclipse.jetty.util.component">org.eclipse.jetty.util.component.AbstractLifeCycle</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html" title="class in org.eclipse.jetty.server">org.eclipse.jetty.server.AbstractNCSARequestLog</a></li>
<li>
<ul class="inheritance">
<li>org.eclipse.jetty.server.NCSARequestLog</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>All Implemented Interfaces:</dt>
<dd><a href="../../../../org/eclipse/jetty/server/RequestLog.html" title="interface in org.eclipse.jetty.server">RequestLog</a>, <a href="../../../../org/eclipse/jetty/util/component/LifeCycle.html" title="interface in org.eclipse.jetty.util.component">LifeCycle</a></dd>
</dl>
<dl>
<dt>Direct Known Subclasses:</dt>
<dd><a href="../../../../org/eclipse/jetty/server/AsyncNCSARequestLog.html" title="class in org.eclipse.jetty.server">AsyncNCSARequestLog</a></dd>
</dl>
<hr>
<br>
<pre><a href="../../../../org/eclipse/jetty/util/annotation/ManagedObject.html" title="annotation in org.eclipse.jetty.util.annotation">@ManagedObject</a>(<a href="../../../../org/eclipse/jetty/util/annotation/ManagedObject.html#value--">value</a>="NCSA standard format request log")
public class <span class="typeNameLabel">NCSARequestLog</span>
extends <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html" title="class in org.eclipse.jetty.server">AbstractNCSARequestLog</a></pre>
<div class="block">This <a href="../../../../org/eclipse/jetty/server/RequestLog.html" title="interface in org.eclipse.jetty.server"><code>RequestLog</code></a> implementation outputs logs in the pseudo-standard
NCSA common log format. Configuration options allow a choice between the
standard Common Log Format (as used in the 3 log format) and the Combined Log
Format (single log format). This log format can be output by most web
servers, and almost all web log analysis software can understand these
formats.</div>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== NESTED CLASS SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="nested.class.summary">
<!-- -->
</a>
<h3>Nested Class Summary</h3>
<ul class="blockList">
<li class="blockList"><a name="nested.classes.inherited.from.class.org.eclipse.jetty.util.component.AbstractLifeCycle">
<!-- -->
</a>
<h3>Nested classes/interfaces inherited from class&nbsp;org.eclipse.jetty.util.component.<a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html" title="class in org.eclipse.jetty.util.component">AbstractLifeCycle</a></h3>
<code><a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.AbstractLifeCycleListener.html" title="class in org.eclipse.jetty.util.component">AbstractLifeCycle.AbstractLifeCycleListener</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="nested.classes.inherited.from.class.org.eclipse.jetty.util.component.LifeCycle">
<!-- -->
</a>
<h3>Nested classes/interfaces inherited from interface&nbsp;org.eclipse.jetty.util.component.<a href="../../../../org/eclipse/jetty/util/component/LifeCycle.html" title="interface in org.eclipse.jetty.util.component">LifeCycle</a></h3>
<code><a href="../../../../org/eclipse/jetty/util/component/LifeCycle.Listener.html" title="interface in org.eclipse.jetty.util.component">LifeCycle.Listener</a></code></li>
</ul>
</li>
</ul>
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- -->
</a>
<h3>Field Summary</h3>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.org.eclipse.jetty.server.AbstractNCSARequestLog">
<!-- -->
</a>
<h3>Fields inherited from class&nbsp;org.eclipse.jetty.server.<a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html" title="class in org.eclipse.jetty.server">AbstractNCSARequestLog</a></h3>
<code><a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#LOG">LOG</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.org.eclipse.jetty.util.component.AbstractLifeCycle">
<!-- -->
</a>
<h3>Fields inherited from class&nbsp;org.eclipse.jetty.util.component.<a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html" title="class in org.eclipse.jetty.util.component">AbstractLifeCycle</a></h3>
<code><a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#FAILED">FAILED</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#RUNNING">RUNNING</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#STARTED">STARTED</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#STARTING">STARTING</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#STOP_ON_FAILURE">STOP_ON_FAILURE</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#STOPPED">STOPPED</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#STOPPING">STOPPING</a></code></li>
</ul>
</li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- -->
</a>
<h3>Constructor Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
<caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#NCSARequestLog--">NCSARequestLog</a></span>()</code>
<div class="block">Create request log object with default settings.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#NCSARequestLog-java.lang.String-">NCSARequestLog</a></span>(java.lang.String&nbsp;filename)</code>
<div class="block">Create request log object with specified output file name.</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="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#doStart--">doStart</a></span>()</code>
<div class="block">Set up request logging and open log file.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#doStop--">doStop</a></span>()</code>
<div class="block">Close the log file and perform cleanup.</div>
</td>
</tr>
<tr id="i2" class="altColor">
<td class="colFirst"><code>java.lang.String</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#getDatedFilename--">getDatedFilename</a></span>()</code>
<div class="block">Retrieve the file name of the request log with the expanded
date wildcard if the output is written to the disk using
<a href="../../../../org/eclipse/jetty/util/RolloverFileOutputStream.html" title="class in org.eclipse.jetty.util"><code>RolloverFileOutputStream</code></a>.</div>
</td>
</tr>
<tr id="i3" class="rowColor">
<td class="colFirst"><code>java.lang.String</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#getFilename--">getFilename</a></span>()</code>
<div class="block">Retrieve the output file name of the request log.</div>
</td>
</tr>
<tr id="i4" class="altColor">
<td class="colFirst"><code>java.lang.String</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#getFilenameDateFormat--">getFilenameDateFormat</a></span>()</code>
<div class="block">Retrieve the file name date format string.</div>
</td>
</tr>
<tr id="i5" class="rowColor">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#getRetainDays--">getRetainDays</a></span>()</code>
<div class="block">Retrieve the number of days before rotated log files are deleted.</div>
</td>
</tr>
<tr id="i6" class="altColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#isAppend--">isAppend</a></span>()</code>
<div class="block">Retrieve append to log flag.</div>
</td>
</tr>
<tr id="i7" class="rowColor">
<td class="colFirst"><code>protected boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#isEnabled--">isEnabled</a></span>()</code>
<div class="block">Is logging enabled</div>
</td>
</tr>
<tr id="i8" class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#setAppend-boolean-">setAppend</a></span>(boolean&nbsp;append)</code>
<div class="block">Set append to log flag.</div>
</td>
</tr>
<tr id="i9" class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#setFilename-java.lang.String-">setFilename</a></span>(java.lang.String&nbsp;filename)</code>
<div class="block">Set the output file name of the request log.</div>
</td>
</tr>
<tr id="i10" class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#setFilenameDateFormat-java.lang.String-">setFilenameDateFormat</a></span>(java.lang.String&nbsp;logFileDateFormat)</code>
<div class="block">Set the log file name date format.</div>
</td>
</tr>
<tr id="i11" class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#setRetainDays-int-">setRetainDays</a></span>(int&nbsp;retainDays)</code>
<div class="block">Set the number of days before rotated log files are deleted.</div>
</td>
</tr>
<tr id="i12" class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/eclipse/jetty/server/NCSARequestLog.html#write-java.lang.String-">write</a></span>(java.lang.String&nbsp;requestEntry)</code>
<div class="block">Write requestEntry out.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.eclipse.jetty.server.AbstractNCSARequestLog">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;org.eclipse.jetty.server.<a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html" title="class in org.eclipse.jetty.server">AbstractNCSARequestLog</a></h3>
<code><a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#getIgnorePaths--">getIgnorePaths</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#getLogCookies--">getLogCookies</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#getLogDateFormat--">getLogDateFormat</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#getLogLatency--">getLogLatency</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#getLogLocale--">getLogLocale</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#getLogServer--">getLogServer</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#getLogTimeZone--">getLogTimeZone</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#getPreferProxiedForAddress--">getPreferProxiedForAddress</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#isExtended--">isExtended</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#isLogDispatch--">isLogDispatch</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#log-org.eclipse.jetty.server.Request-org.eclipse.jetty.server.Response-">log</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#logExtended-org.eclipse.jetty.server.Request-java.lang.StringBuilder-">logExtended</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#logExtended-java.lang.StringBuilder-org.eclipse.jetty.server.Request-org.eclipse.jetty.server.Response-">logExtended</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#setExtended-boolean-">setExtended</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#setIgnorePaths-java.lang.String:A-">setIgnorePaths</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#setLogCookies-boolean-">setLogCookies</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#setLogDateFormat-java.lang.String-">setLogDateFormat</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#setLogDispatch-boolean-">setLogDispatch</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#setLogLatency-boolean-">setLogLatency</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#setLogLocale-java.util.Locale-">setLogLocale</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#setLogServer-boolean-">setLogServer</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#setLogTimeZone-java.lang.String-">setLogTimeZone</a>, <a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#setPreferProxiedForAddress-boolean-">setPreferProxiedForAddress</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.eclipse.jetty.util.component.AbstractLifeCycle">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;org.eclipse.jetty.util.component.<a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html" title="class in org.eclipse.jetty.util.component">AbstractLifeCycle</a></h3>
<code><a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#addLifeCycleListener-org.eclipse.jetty.util.component.LifeCycle.Listener-">addLifeCycleListener</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#getState--">getState</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#getState-org.eclipse.jetty.util.component.LifeCycle-">getState</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#getStopTimeout--">getStopTimeout</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#isFailed--">isFailed</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#isRunning--">isRunning</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#isStarted--">isStarted</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#isStarting--">isStarting</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#isStopped--">isStopped</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#isStopping--">isStopping</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#removeLifeCycleListener-org.eclipse.jetty.util.component.LifeCycle.Listener-">removeLifeCycleListener</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#setStopTimeout-long-">setStopTimeout</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#start--">start</a>, <a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#stop--">stop</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.Object</h3>
<code>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</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="NCSARequestLog--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>NCSARequestLog</h4>
<pre>public&nbsp;NCSARequestLog()</pre>
<div class="block">Create request log object with default settings.</div>
</li>
</ul>
<a name="NCSARequestLog-java.lang.String-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>NCSARequestLog</h4>
<pre>public&nbsp;NCSARequestLog(java.lang.String&nbsp;filename)</pre>
<div class="block">Create request log object with specified output file name.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>filename</code> - the file name for the request log.
This may be in the format expected
by <a href="../../../../org/eclipse/jetty/util/RolloverFileOutputStream.html" title="class in org.eclipse.jetty.util"><code>RolloverFileOutputStream</code></a></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="setFilename-java.lang.String-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setFilename</h4>
<pre>public&nbsp;void&nbsp;setFilename(java.lang.String&nbsp;filename)</pre>
<div class="block">Set the output file name of the request log.
The file name may be in the format expected by
<a href="../../../../org/eclipse/jetty/util/RolloverFileOutputStream.html" title="class in org.eclipse.jetty.util"><code>RolloverFileOutputStream</code></a>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>filename</code> - file name of the request log</dd>
</dl>
</li>
</ul>
<a name="getFilename--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getFilename</h4>
<pre><a href="../../../../org/eclipse/jetty/util/annotation/ManagedAttribute.html" title="annotation in org.eclipse.jetty.util.annotation">@ManagedAttribute</a>(<a href="../../../../org/eclipse/jetty/util/annotation/ManagedAttribute.html#value--">value</a>="file of log")
public&nbsp;java.lang.String&nbsp;getFilename()</pre>
<div class="block">Retrieve the output file name of the request log.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>file name of the request log</dd>
</dl>
</li>
</ul>
<a name="getDatedFilename--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getDatedFilename</h4>
<pre>public&nbsp;java.lang.String&nbsp;getDatedFilename()</pre>
<div class="block">Retrieve the file name of the request log with the expanded
date wildcard if the output is written to the disk using
<a href="../../../../org/eclipse/jetty/util/RolloverFileOutputStream.html" title="class in org.eclipse.jetty.util"><code>RolloverFileOutputStream</code></a>.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>file name of the request log, or null if not applicable</dd>
</dl>
</li>
</ul>
<a name="isEnabled--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>isEnabled</h4>
<pre>protected&nbsp;boolean&nbsp;isEnabled()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class:&nbsp;<code><a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#isEnabled--">AbstractNCSARequestLog</a></code></span></div>
<div class="block">Is logging enabled</div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#isEnabled--">isEnabled</a></code>&nbsp;in class&nbsp;<code><a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html" title="class in org.eclipse.jetty.server">AbstractNCSARequestLog</a></code></dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>true if logging is enabled</dd>
</dl>
</li>
</ul>
<a name="setRetainDays-int-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setRetainDays</h4>
<pre>public&nbsp;void&nbsp;setRetainDays(int&nbsp;retainDays)</pre>
<div class="block">Set the number of days before rotated log files are deleted.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>retainDays</code> - number of days to keep a log file</dd>
</dl>
</li>
</ul>
<a name="getRetainDays--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getRetainDays</h4>
<pre><a href="../../../../org/eclipse/jetty/util/annotation/ManagedAttribute.html" title="annotation in org.eclipse.jetty.util.annotation">@ManagedAttribute</a>(<a href="../../../../org/eclipse/jetty/util/annotation/ManagedAttribute.html#value--">value</a>="number of days that log files are kept")
public&nbsp;int&nbsp;getRetainDays()</pre>
<div class="block">Retrieve the number of days before rotated log files are deleted.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>number of days to keep a log file</dd>
</dl>
</li>
</ul>
<a name="setAppend-boolean-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setAppend</h4>
<pre>public&nbsp;void&nbsp;setAppend(boolean&nbsp;append)</pre>
<div class="block">Set append to log flag.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>append</code> - true - request log file will be appended after restart,
false - request log file will be overwritten after restart</dd>
</dl>
</li>
</ul>
<a name="isAppend--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>isAppend</h4>
<pre><a href="../../../../org/eclipse/jetty/util/annotation/ManagedAttribute.html" title="annotation in org.eclipse.jetty.util.annotation">@ManagedAttribute</a>(<a href="../../../../org/eclipse/jetty/util/annotation/ManagedAttribute.html#value--">value</a>="existing log files are appends to the new one")
public&nbsp;boolean&nbsp;isAppend()</pre>
<div class="block">Retrieve append to log flag.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>value of the flag</dd>
</dl>
</li>
</ul>
<a name="setFilenameDateFormat-java.lang.String-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setFilenameDateFormat</h4>
<pre>public&nbsp;void&nbsp;setFilenameDateFormat(java.lang.String&nbsp;logFileDateFormat)</pre>
<div class="block">Set the log file name date format.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>logFileDateFormat</code> - format string that is passed to <a href="../../../../org/eclipse/jetty/util/RolloverFileOutputStream.html" title="class in org.eclipse.jetty.util"><code>RolloverFileOutputStream</code></a></dd>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../org/eclipse/jetty/util/RolloverFileOutputStream.html#RolloverFileOutputStream-java.lang.String-boolean-int-java.util.TimeZone-java.lang.String-java.lang.String-"><code>RolloverFileOutputStream.RolloverFileOutputStream(String, boolean, int, TimeZone, String, String)</code></a></dd>
</dl>
</li>
</ul>
<a name="getFilenameDateFormat--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getFilenameDateFormat</h4>
<pre>public&nbsp;java.lang.String&nbsp;getFilenameDateFormat()</pre>
<div class="block">Retrieve the file name date format string.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the log File Date Format</dd>
</dl>
</li>
</ul>
<a name="write-java.lang.String-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>write</h4>
<pre>public&nbsp;void&nbsp;write(java.lang.String&nbsp;requestEntry)
throws java.io.IOException</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from class:&nbsp;<code><a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#write-java.lang.String-">AbstractNCSARequestLog</a></code></span></div>
<div class="block">Write requestEntry out. (to disk or slf4j log)</div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#write-java.lang.String-">write</a></code>&nbsp;in class&nbsp;<code><a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html" title="class in org.eclipse.jetty.server">AbstractNCSARequestLog</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>requestEntry</code> - the request entry</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>java.io.IOException</code> - if unable to write the entry</dd>
</dl>
</li>
</ul>
<a name="doStart--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>doStart</h4>
<pre>protected&nbsp;void&nbsp;doStart()
throws java.lang.Exception</pre>
<div class="block">Set up request logging and open log file.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
<dd><code><a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#doStart--">doStart</a></code>&nbsp;in class&nbsp;<code><a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html" title="class in org.eclipse.jetty.server">AbstractNCSARequestLog</a></code></dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>java.lang.Exception</code></dd>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#doStart--"><code>AbstractLifeCycle.doStart()</code></a></dd>
</dl>
</li>
</ul>
<a name="doStop--">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>doStop</h4>
<pre>protected&nbsp;void&nbsp;doStop()
throws java.lang.Exception</pre>
<div class="block">Close the log file and perform cleanup.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
<dd><code><a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html#doStop--">doStop</a></code>&nbsp;in class&nbsp;<code><a href="../../../../org/eclipse/jetty/server/AbstractNCSARequestLog.html" title="class in org.eclipse.jetty.server">AbstractNCSARequestLog</a></code></dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>java.lang.Exception</code></dd>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../org/eclipse/jetty/util/component/AbstractLifeCycle.html#doStop--"><code>AbstractLifeCycle.doStop()</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>
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.bottom.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/NCSARequestLog.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/eclipse/jetty/server/MultiPartCleanerListener.html" title="class in org.eclipse.jetty.server"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
<li><a href="../../../../org/eclipse/jetty/server/NegotiatingServerConnection.html" title="class in org.eclipse.jetty.server"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../index.html?org/eclipse/jetty/server/NCSARequestLog.html" target="_top">Frames</a></li>
<li><a href="NCSARequestLog.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../../allclasses-noframe.html">All&nbsp;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:&nbsp;</li>
<li><a href="#nested.classes.inherited.from.class.org.eclipse.jetty.util.component.AbstractLifeCycle">Nested</a>&nbsp;|&nbsp;</li>
<li><a href="#fields.inherited.from.class.org.eclipse.jetty.server.AbstractNCSARequestLog">Field</a>&nbsp;|&nbsp;</li>
<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</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>Copyright &#169; 1995&#x2013;2018 <a href="http://webtide.com">Webtide</a>. All rights reserved.</small></p>
</body>
</html>