-<?xml version="1.0"?>\r
-<!--\r
- Licensed to the Apache Software Foundation (ASF) under one or more\r
- contributor license agreements. See the NOTICE file distributed with\r
- this work for additional information regarding copyright ownership.\r
- The ASF licenses this file to You under the Apache License, Version 2.0\r
- (the "License"); you may not use this file except in compliance with\r
- the License. You may obtain a copy of the License at\r
-\r
- http://www.apache.org/licenses/LICENSE-2.0\r
-\r
- Unless required by applicable law or agreed to in writing, software\r
- distributed under the License is distributed on an "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
- See the License for the specific language governing permissions and\r
- limitations under the License.\r
--->\r
-<!DOCTYPE document [\r
- <!ENTITY project SYSTEM "project.xml">\r
-]>\r
-<document url="executor.html">\r
-\r
- &project;\r
-\r
- <properties>\r
- <author email="fhanik@apache.org">Filip Hanik</author>\r
- <title>The Executor (thread pool)</title>\r
- </properties>\r
-\r
-<body>\r
-\r
-\r
-<section name="Introduction">\r
-\r
- <p>The <strong>Executor</strong> represents a thread pool that can be shared \r
- between components in Tomcat. Historically there has been a thread pool per\r
- connector created but this allows you to share a thread pool, between (primarly) connector\r
- but also other components when those get configured to support executors</p>\r
-\r
-\r
- <p>The executor has to implement the <code>org.apache.catalina.Executor</code> interface.</p>\r
- \r
- <p>The executor is a nested element to the <a href="service.html">Service</a> element.\r
- And in order for it to be picked up by the connectors, the Executor element has to appear\r
- prior to the Connector element in server.xml</p>\r
-</section>\r
-\r
-\r
-<section name="Attributes">\r
-\r
- <subsection name="Common Attributes">\r
-\r
- <p>All implementations of <strong>Executor</strong>\r
- support the following attributes:</p>\r
-\r
- <attributes>\r
- \r
- <attribute name="className" required="false">\r
- <p>The class of the implementation. The implementation has to implement the \r
- <code>org.apache.catalina.Executor</code> interface.\r
- This interface ensures that the object can be referenced through its <code>name</code> attribute\r
- and that implements Lifecycle, so that it can be started and stopped with the container.\r
- The default value for the className is <code>org.apache.catalina.core.StandardThreadExecutor</code></p>\r
- </attribute>\r
-\r
- <attribute name="name" required="true">\r
- <p>The name used to reference this pool in other places in server.xml.\r
- The name is required and must be unique.</p>\r
- </attribute>\r
-\r
- </attributes>\r
-\r
- </subsection>\r
-\r
- <subsection name="Standard Implementation">\r
-\r
- <p>\r
- The default implementation supports the following attributes:</p>\r
-\r
- <attributes>\r
-\r
- <attribute name="threadPriority" required="false">\r
- <p>(int) The thread priority for threads in the executor, the default is <code>Thread.NORM_PRIORITY</code></p>\r
- </attribute>\r
- <attribute name="daemon" required="false">\r
- <p>(boolean) Whether the threads should be daemon threads or not, the default is <code>true</code></p>\r
- </attribute>\r
- <attribute name="namePrefix" required="false">\r
- <p>(String) The name prefix for each thread created by the executor.\r
- The thread name for an individual thread will be <code>namePrefix+threadNumber</code></p>\r
- </attribute>\r
- <attribute name="maxThreads" required="false">\r
- <p>(int) The max number of active threads in this pool, default is <code>200</code></p>\r
- </attribute>\r
- <attribute name="minSpareThreads" required="false">\r
- <p>(int) The minimum number of threads always kept alive, default is <code>25</code></p>\r
- </attribute>\r
- <attribute name="maxIdleTime" required="false">\r
- <p>(int) The number of milliseconds before an idle thread shutsdown, unless the number of active threads are less\r
- or equal to minSpareThreads. Default value is <code>60000</code>(1 minute)</p>\r
- </attribute>\r
- </attributes>\r
-\r
-\r
- </subsection>\r
-</section>\r
-\r
-\r
-</body>\r
-\r
-</document>\r
+<?xml version="1.0"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<!DOCTYPE document [
+ <!ENTITY project SYSTEM "project.xml">
+]>
+<document url="executor.html">
+
+ &project;
+
+ <properties>
+ <author email="fhanik@apache.org">Filip Hanik</author>
+ <title>The Executor (thread pool)</title>
+ </properties>
+
+<body>
+
+
+<section name="Introduction">
+
+ <p>The <strong>Executor</strong> represents a thread pool that can be shared
+ between components in Tomcat. Historically there has been a thread pool per
+ connector created but this allows you to share a thread pool, between (primarly) connector
+ but also other components when those get configured to support executors</p>
+
+
+ <p>The executor has to implement the <code>org.apache.catalina.Executor</code> interface.</p>
+
+ <p>The executor is a nested element to the <a href="service.html">Service</a> element.
+ And in order for it to be picked up by the connectors, the Executor element has to appear
+ prior to the Connector element in server.xml</p>
+</section>
+
+
+<section name="Attributes">
+
+ <subsection name="Common Attributes">
+
+ <p>All implementations of <strong>Executor</strong>
+ support the following attributes:</p>
+
+ <attributes>
+
+ <attribute name="className" required="false">
+ <p>The class of the implementation. The implementation has to implement the
+ <code>org.apache.catalina.Executor</code> interface.
+ This interface ensures that the object can be referenced through its <code>name</code> attribute
+ and that implements Lifecycle, so that it can be started and stopped with the container.
+ The default value for the className is <code>org.apache.catalina.core.StandardThreadExecutor</code></p>
+ </attribute>
+
+ <attribute name="name" required="true">
+ <p>The name used to reference this pool in other places in server.xml.
+ The name is required and must be unique.</p>
+ </attribute>
+
+ </attributes>
+
+ </subsection>
+
+ <subsection name="Standard Implementation">
+
+ <p>
+ The default implementation supports the following attributes:</p>
+
+ <attributes>
+
+ <attribute name="threadPriority" required="false">
+ <p>(int) The thread priority for threads in the executor, the default is <code>Thread.NORM_PRIORITY</code></p>
+ </attribute>
+ <attribute name="daemon" required="false">
+ <p>(boolean) Whether the threads should be daemon threads or not, the default is <code>true</code></p>
+ </attribute>
+ <attribute name="namePrefix" required="false">
+ <p>(String) The name prefix for each thread created by the executor.
+ The thread name for an individual thread will be <code>namePrefix+threadNumber</code></p>
+ </attribute>
+ <attribute name="maxThreads" required="false">
+ <p>(int) The max number of active threads in this pool, default is <code>200</code></p>
+ </attribute>
+ <attribute name="minSpareThreads" required="false">
+ <p>(int) The minimum number of threads always kept alive, default is <code>25</code></p>
+ </attribute>
+ <attribute name="maxIdleTime" required="false">
+ <p>(int) The number of milliseconds before an idle thread shutsdown, unless the number of active threads are less
+ or equal to minSpareThreads. Default value is <code>60000</code>(1 minute)</p>
+ </attribute>
+ </attributes>
+
+
+ </subsection>
+</section>
+
+
+</body>
+
+</document>