Gecko [ www.vortexaion.com ]

Name	Size	Permission	Date
META-INF	[ DIR ]	drwxrwxrwx	2024-07-26 17:37
WEB-INF	[ DIR ]	drwxrwxrwx	2024-07-26 17:37
annotationapi	[ DIR ]	drwxrwxrwx	2024-07-26 17:37
api	[ DIR ]	drwxrwxrwx	2024-07-26 17:37
appdev	[ DIR ]	drwxrwxrwx	2024-07-26 17:37
architecture	[ DIR ]	drwxrwxrwx	2024-07-26 17:37
config	[ DIR ]	drwxrwxrwx	2024-07-26 17:37
elapi	[ DIR ]	drwxrwxrwx	2024-07-26 17:37
images	[ DIR ]	drwxrwxrwx	2024-07-26 17:37
jaspicapi	[ DIR ]	drwxrwxrwx	2024-07-26 17:37
jspapi	[ DIR ]	drwxrwxrwx	2024-07-26 17:37
servletapi	[ DIR ]	drwxrwxrwx	2024-07-26 17:37
tribes	[ DIR ]	drwxrwxrwx	2024-07-26 17:37
websocketapi	[ DIR ]	drwxrwxrwx	2024-07-26 17:37
BUILDING.txt	20.09 KB	-rw-rw-rw-	2023-11-10 15:57
RELEASE-NOTES.txt	7.15 KB	-rw-rw-rw-	2023-11-10 15:57
RUNNING.txt	16.58 KB	-rw-rw-rw-	2023-11-10 15:57
aio.html	6.89 KB	-rw-rw-rw-	2023-11-10 15:57
apr.html	10.53 KB	-rw-rw-rw-	2023-11-10 15:57
balancer-howto.html	5.41 KB	-rw-rw-rw-	2023-11-10 15:57
building.html	12.89 KB	-rw-rw-rw-	2023-11-10 15:57
cgi-howto.html	11.4 KB	-rw-rw-rw-	2023-11-10 15:57
changelog.html	696.37 KB	-rw-rw-rw-	2023-11-10 15:57
class-loader-howto.html	18.25 KB	-rw-rw-rw-	2023-11-10 15:57
cluster-howto.html	42.4 KB	-rw-rw-rw-	2023-11-10 15:57
comments.html	7.96 KB	-rw-rw-rw-	2023-11-10 15:57
connectors.html	6.49 KB	-rw-rw-rw-	2023-11-10 15:57
default-servlet.html	17.2 KB	-rw-rw-rw-	2023-11-10 15:57
deployer-howto.html	20.38 KB	-rw-rw-rw-	2023-11-10 15:57
developers.html	6.44 KB	-rw-rw-rw-	2023-11-10 15:57
extras.html	8.22 KB	-rw-rw-rw-	2023-11-10 15:57
host-manager-howto.html	14.11 KB	-rw-rw-rw-	2023-11-10 15:57
html-host-manager-howto.html	11.93 KB	-rw-rw-rw-	2023-11-10 15:57
html-manager-howto.html	27.84 KB	-rw-rw-rw-	2023-11-10 15:57
index.html	14.61 KB	-rw-rw-rw-	2023-11-10 15:57
introduction.html	15.56 KB	-rw-rw-rw-	2023-11-10 15:57
jasper-howto.html	21.92 KB	-rw-rw-rw-	2023-11-10 15:57
jdbc-pool.html	64.01 KB	-rw-rw-rw-	2023-11-10 15:57
jndi-datasource-examples-howto.html	33.21 KB	-rw-rw-rw-	2023-11-10 15:57
jndi-resources-howto.html	49.34 KB	-rw-rw-rw-	2023-11-10 15:57
logging.html	23.39 KB	-rw-rw-rw-	2023-11-10 15:57
manager-howto.html	73.46 KB	-rw-rw-rw-	2023-11-10 15:57
maven-jars.html	5.94 KB	-rw-rw-rw-	2023-11-10 15:57
mbeans-descriptors-howto.html	6.22 KB	-rw-rw-rw-	2023-11-10 15:57
mbeans-descriptors.dtd	10.99 KB	-rw-rw-rw-	2023-11-10 15:57
monitoring.html	38.46 KB	-rw-rw-rw-	2023-11-10 15:57
proxy-howto.html	10.69 KB	-rw-rw-rw-	2023-11-10 15:57
realm-howto.html	60.89 KB	-rw-rw-rw-	2023-11-10 15:57
rewrite.html	34.47 KB	-rw-rw-rw-	2023-11-10 15:57
security-howto.html	38.09 KB	-rw-rw-rw-	2023-11-10 15:57
security-manager-howto.html	28.1 KB	-rw-rw-rw-	2023-11-10 15:57
setup.html	12.48 KB	-rw-rw-rw-	2023-11-10 15:57
ssi-howto.html	17.95 KB	-rw-rw-rw-	2023-11-10 15:57
ssl-howto.html	41.13 KB	-rw-rw-rw-	2023-11-10 15:57
virtual-hosting-howto.html	9.94 KB	-rw-rw-rw-	2023-11-10 15:57
web-socket-howto.html	12.56 KB	-rw-rw-rw-	2023-11-10 15:57
windows-auth-howto.html	20.19 KB	-rw-rw-rw-	2023-11-10 15:57
windows-service-howto.html	25.46 KB	-rw-rw-rw-	2023-11-10 15:57

Rename

<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><link href="./images/docs-stylesheet.css" rel="stylesheet" type="text/css"><title>Apache Tomcat 8 (8.5.96) - Advanced IO and Tomcat</title><meta name="author" content="Remy Maucherat"></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="https://tomcat.apache.org/"><img alt="Tomcat Home" src="./images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/" target="_blank"><img src="./images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>Apache Tomcat 8</h1><div class="versionInfo">
            Version 8.5.96,
            <time datetime="2023-11-10">Nov 10 2023</time></div><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="index.html">Docs Home</a></li><li><a href="https://cwiki.apache.org/confluence/display/TOMCAT/FAQ">FAQ</a></li><li><a href="#comments_section">User Comments</a></li></ul></div><div><h2>User Guide</h2><ul><li><a href="introduction.html">1) Introduction</a></li><li><a href="setup.html">2) Setup</a></li><li><a href="appdev/index.html">3) First webapp</a></li><li><a href="deployer-howto.html">4) Deployer</a></li><li><a href="manager-howto.html">5) Manager</a></li><li><a href="host-manager-howto.html">6) Host Manager</a></li><li><a href="realm-howto.html">7) Realms and AAA</a></li><li><a href="security-manager-howto.html">8) Security Manager</a></li><li><a href="jndi-resources-howto.html">9) JNDI Resources</a></li><li><a href="jndi-datasource-examples-howto.html">10) JDBC DataSources</a></li><li><a href="class-loader-howto.html">11) Classloading</a></li><li><a href="jasper-howto.html">12) JSPs</a></li><li><a href="ssl-howto.html">13) SSL/TLS</a></li><li><a href="ssi-howto.html">14) SSI</a></li><li><a href="cgi-howto.html">15) CGI</a></li><li><a href="proxy-howto.html">16) Proxy Support</a></li><li><a href="mbeans-descriptors-howto.html">17) MBeans Descriptors</a></li><li><a href="default-servlet.html">18) Default Servlet</a></li><li><a href="cluster-howto.html">19) Clustering</a></li><li><a href="balancer-howto.html">20) Load Balancer</a></li><li><a href="connectors.html">21) Connectors</a></li><li><a href="monitoring.html">22) Monitoring and Management</a></li><li><a href="logging.html">23) Logging</a></li><li><a href="apr.html">24) APR/Native</a></li><li><a href="virtual-hosting-howto.html">25) Virtual Hosting</a></li><li><a href="aio.html">26) Advanced IO</a></li><li><a href="extras.html">27) Additional Components</a></li><li><a href="maven-jars.html">28) Mavenized</a></li><li><a href="security-howto.html">29) Security Considerations</a></li><li><a href="windows-service-howto.html">30) Windows Service</a></li><li><a href="windows-auth-howto.html">31) Windows Authentication</a></li><li><a href="jdbc-pool.html">32) Tomcat's JDBC Pool</a></li><li><a href="web-socket-howto.html">33) WebSocket</a></li><li><a href="rewrite.html">34) Rewrite</a></li></ul></div><div><h2>Reference</h2><ul><li><a href="RELEASE-NOTES.txt">Release Notes</a></li><li><a href="config/index.html">Configuration</a></li><li><a href="api/index.html">Tomcat Javadocs</a></li><li><a href="servletapi/index.html">Servlet 3.1 Javadocs</a></li><li><a href="jspapi/index.html">JSP 2.3 Javadocs</a></li><li><a href="elapi/index.html">EL 3.0 Javadocs</a></li><li><a href="websocketapi/index.html">WebSocket 1.1 Javadocs</a></li><li><a href="jaspicapi/index.html">JASPIC 1.1 Javadocs</a></li><li><a href="annotationapi/index.html">Common Annotations 1.2 Javadocs</a></li><li><a href="https://tomcat.apache.org/connectors-doc/">JK 1.2 Documentation</a></li></ul></div><div><h2>Apache Tomcat Development</h2><ul><li><a href="building.html">Building</a></li><li><a href="changelog.html">Changelog</a></li><li><a href="https://cwiki.apache.org/confluence/display/TOMCAT/Tomcat+Versions">Status</a></li><li><a href="developers.html">Developers</a></li><li><a href="architecture/index.html">Architecture</a></li><li><a href="tribes/introduction.html">Tribes</a></li></ul></div></nav></div></div><div id="mainRight"><div id="content"><h2>Advanced IO and Tomcat</h2><h3 id="Table_of_Contents">Table of Contents</h3><div class="text">
<ul><li><a href="#Introduction">Introduction</a></li><li><a href="#Asynchronous_writes">Asynchronous writes</a></li></ul>
</div><h3 id="Introduction">Introduction</h3><div class="text">

<p>
    <b>IMPORTANT NOTE: Usage of these features requires using the
    HTTP connectors. The AJP connectors do not support them.</b>
  </p>

</div><h3 id="Asynchronous_writes">Asynchronous writes</h3><div class="text">

<p>
    When using HTTP connectors (based on APR or NIO/NIO2),
    Tomcat supports using sendfile to send large static files.
    These writes, as soon as the system load increases, will be performed
    asynchronously in the most efficient way. Instead of sending a large response using
    blocking writes, it is possible to write content to a static file, and write it
    using a sendfile code. A caching valve could take advantage of this to cache the
    response data in a file rather than store it in memory. Sendfile support is
    available if the request attribute <code>org.apache.tomcat.sendfile.support</code>
    is set to <code>Boolean.TRUE</code>.
  </p>

<p>
    Any servlet can instruct Tomcat to perform a sendfile call by setting the appropriate
    request attributes. It is also necessary to correctly set the content length
    for the response. When using sendfile, it is best to ensure that neither the
    request or response have been wrapped, since as the response body will be sent later
    by the connector itself, it cannot be filtered. Other than setting the 3 needed
    request attributes, the servlet should not send any response data, but it may use
    any method which will result in modifying the response header (like setting cookies).
  </p>

<ul>
  <li><code>org.apache.tomcat.sendfile.filename</code>: Canonical filename of the file which will be sent as
      a String</li>
  <li><code>org.apache.tomcat.sendfile.start</code>: Start offset as a Long</li>
  <li><code>org.apache.tomcat.sendfile.end</code>: End offset as a Long</li>
  </ul>
  <p>
    In addition to setting these parameters it is necessary to set the content-length header.
    Tomcat will not do that for you, since you may have already written data to the output stream.
  </p>

<p>
    Note that the use of sendfile will disable any compression that Tomcat may
    otherwise have performed on the response.
  </p>