View | Details | Raw Unified | Return to bug 58255
Collapse All | Expand All

(-)webapps/docs/config/valve.xml (+55 lines)
Lines 1729-1734 Link Here
1729
1729
1730
</section>
1730
</section>
1731
1731
1732
<section name="Semaphore Valve">
1733
1734
  <subsection name="Introduction">
1735
1736
    <p>The <strong>Semaphore Valve</strong> is able to limit the number of
1737
    request processing thread concurrency.</p>
1738
    <p><strong>org.apache.catalina.valves.SemaphoreValve</strong> provide
1739
    methods which are able to extend in order to override by subclass.</p>
1740
    <ul>
1741
    <li><b><code>controlConcurrency</code></b> method is able to extend in
1742
    order to add conditions</li>
1743
    <li><b><code>permitDenied</code></b> method is able to extend in order to
1744
    add error handling when a permit isn't granted</li>
1745
    </ul>
1746
1747
  </subsection>
1748
1749
  <subsection name="Attributes">
1750
1751
    <p>The <strong>Semaphore Valve</strong> supports the following
1752
    configuration attributes:</p>
1753
1754
    <attributes>
1755
1756
      <attribute name="block" required="false">
1757
        <p>Flag to determine if thread is blocked until a permit is available.
1758
        The default value is <strong>true</strong>.</p>
1759
      </attribute>
1760
1761
      <attribute name="className" required="true">
1762
        <p>Java class name of the implementation to use. This MUST be set to
1763
        <strong>org.apache.catalina.valves.SemaphoreValve</strong>.</p>
1764
      </attribute>
1765
1766
      <attribute name="concurrency" required="false">
1767
        <p>Concurrency level of the semaphore. The default value is
1768
        <strong>10</strong>.</p>
1769
      </attribute>
1770
1771
      <attribute name="fairness" required="false">
1772
        <p>Fairness of the semaphore. The default value is
1773
        <strong>false</strong>.</p>
1774
      </attribute>
1775
1776
      <attribute name="interruptible" required="false">
1777
        <p>Flag to determine if thread allow the interrupt until a permit is
1778
        available. The default value is <strong>false</strong>.</p>
1779
      </attribute>
1780
1781
    </attributes>
1782
1783
  </subsection>
1784
1785
</section>
1786
1732
</body>
1787
</body>
1733
1788
1734
1789

Return to bug 58255