felix-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r900927 - in /websites/staging/felix/trunk/content: ./ documentation/subprojects/apache-felix-http-service.html
Date Mon, 10 Mar 2014 15:26:20 GMT
Author: buildbot
Date: Mon Mar 10 15:26:20 2014
New Revision: 900927

Log:
Staging update by buildbot for felix

Modified:
    websites/staging/felix/trunk/content/   (props changed)
    websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-http-service.html

Propchange: websites/staging/felix/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Mon Mar 10 15:26:20 2014
@@ -1 +1 @@
-1575966
+1575969

Modified: websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-http-service.html
==============================================================================
--- websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-http-service.html
(original)
+++ websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-http-service.html
Mon Mar 10 15:26:20 2014
@@ -76,7 +76,10 @@
 <li><a href="#using-the-whiteboard">Using the Whiteboard</a></li>
 <li><a href="#using-the-servlet-bridge">Using the Servlet Bridge</a></li>
 <li><a href="#using-the-all-in-one-bundle">Using the all-in-one bundle</a></li>
-<li><a href="#configuration-properties">Configuration Properties</a></li>
+<li><a href="#configuration-properties">Configuration Properties</a><ul>
+<li><a href="#http-port-settings">HTTP port settings</a></li>
+</ul>
+</li>
 <li><a href="#servlet-api-events">Servlet API Events</a></li>
 <li><a href="#servlet-context-notes">Servlet Context Notes</a></li>
 <li><a href="#examples">Examples</a></li>
@@ -319,14 +322,14 @@ will render the <code>/etc/www/001.jpg</
 <ul>
 <li><code>alias</code> - Servlet alias to register with.</li>
 <li><code>contextId</code> - Id of context to register with.</li>
-<li><code>init.\*</code> - Servlet initialization values. </li>
+<li><code>init.*</code> - Servlet initialization values. </li>
 </ul>
 <p>Filter service properties:</p>
 <ul>
 <li><code>pattern</code> - Regular expression pattern to register filter
with.</li>
 <li><code>contextId</code> - Id of context to register with.</li>
 <li><code>service.ranking</code> - Where in the chain this filter should
be placed. </li>
-<li><code>init.\*</code> - Filter initialization values. </li>
+<li><code>init.*</code> - Filter initialization values. </li>
 </ul>
 <p>HttpContext service properties:</p>
 <ul>
@@ -373,11 +376,11 @@ one or more configuration properties as 
 </tr>
 <tr>
 <td><code>org.osgi.service.http.port</code></td>
-<td>The port used for servlets and resources available via HTTP. The default is <code>80</code>.
A negative port number has the same effect as setting <code>org.apache.felix.http.enable</code>
to <code>false</code>.</td>
+<td>The port used for servlets and resources available via HTTP. The default is <code>8080</code>.
See <a href="#http-port-settings">port settings below</a> for additional information.
A negative port number has the same effect as setting <code>org.apache.felix.http.enable</code>
to <code>false</code>.</td>
 </tr>
 <tr>
 <td><code>org.osgi.service.http.port.secure</code></td>
-<td>The port used for servlets and resources available via HTTPS. The default is <code>443</code>.
A negative port number has the same effect as setting <code>org.apache.felix.https.enable</code>
to <code>false</code>.</td>
+<td>The port used for servlets and resources available via HTTPS. The default is <code>8443</code>.
See <a href="#http-port-settings">port settings below</a> for additional information.
A negative port number has the same effect as setting <code>org.apache.felix.https.enable</code>
to <code>false</code>.</td>
 </tr>
 <tr>
 <td><code>org.apache.felix.http.context_path</code></td>
@@ -385,7 +388,7 @@ one or more configuration properties as 
 </tr>
 <tr>
 <td><code>org.apache.felix.http.timeout</code></td>
-<td>Connection timeout in milliseconds. The default is 60000 (60 seconds).</td>
+<td>Connection timeout in milliseconds. The default is <code>60000</code>
(60 seconds).</td>
 </tr>
 <tr>
 <td><code>org.apache.felix.http.session.timeout</code></td>
@@ -523,6 +526,21 @@ one or more configuration properties as 
 </tr>
 </tbody>
 </table>
+<h3 id="http-port-settings">HTTP port settings</h3>
+<p>As of HTTP Jetty version 2.2.2, it is possible to assign a free port for HTTP or
HTTPS automatically, based on certain rules, for example, a 
+range between 8000 and 9000. The syntax is based on the version ranges, as described in the
OSGi specification. The following forms are 
+supported:</p>
+<ul>
+<li><code>*</code> or <code>0</code>: binds to the first available
port;</li>
+<li><code>8000</code>: binds to port <code>8000</code>, failing
if this port is already taken;</li>
+<li><code>[8000,9000]</code>: binds to a free port in the range 8000 (inclusive)
and 9000 (inclusive);</li>
+<li><code>[8000,9000)</code>: binds to a free port in the range 8000 (inclusive)
and 9000 (exclusive);</li>
+<li><code>(8000,9000]</code>: binds to a free port in the range 8000 (exclusive)
and 9000 (inclusive);</li>
+<li><code>(8000,9000)</code>: binds to a free port in the range 8000 (exclusive)
and 9000 (exclusive);</li>
+<li><code>[,9000)</code>: binds to a free port in the range 1 (inclusive)
and 9000 (exclusive);</li>
+<li><code>[8000,)</code>: binds to a free port in the range 8000 (inclusive)
and 65535 (exclusive).</li>
+</ul>
+<p>Note that picking a port is <em>not</em> performed atomically and multiple
instances can try to bind to the same port at the same time.</p>
 <h2 id="servlet-api-events">Servlet API Events</h2>
 <p>The Servlet API defines a number of <code>EventListener</code> interfaces
to catch Servlet API related events. As of HTTP Service 2.1.0 most events generated by the
servlet container are forwarded to interested service. To be registered to receive events
services must be registered with the respective <code>EventListener</code> interface:</p>
 <table>
@@ -607,41 +625,51 @@ one or more configuration properties as 
 <div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
   <span class="nt">&lt;groupId&gt;</span>org.apache.felix<span class="nt">&lt;/groupId&gt;</span>
   <span class="nt">&lt;artifactId&gt;</span>org.apache.felix.http.api<span
class="nt">&lt;/artifactId&gt;</span>
-  <span class="nt">&lt;version&gt;</span>2.2.1<span class="nt">&lt;/version&gt;</span>
+  <span class="nt">&lt;version&gt;</span>2.2.2<span class="nt">&lt;/version&gt;</span>
 <span class="nt">&lt;/dependency&gt;</span>
 <span class="nt">&lt;dependency&gt;</span>
   <span class="nt">&lt;groupId&gt;</span>org.apache.felix<span class="nt">&lt;/groupId&gt;</span>
   <span class="nt">&lt;artifactId&gt;</span>org.apache.felix.http.base<span
class="nt">&lt;/artifactId&gt;</span>
-  <span class="nt">&lt;version&gt;</span>2.2.1<span class="nt">&lt;/version&gt;</span>
+  <span class="nt">&lt;version&gt;</span>2.2.2<span class="nt">&lt;/version&gt;</span>
 <span class="nt">&lt;/dependency&gt;</span>
 <span class="nt">&lt;dependency&gt;</span>
   <span class="nt">&lt;groupId&gt;</span>org.apache.felix<span class="nt">&lt;/groupId&gt;</span>
   <span class="nt">&lt;artifactId&gt;</span>org.apache.felix.http.bridge<span
class="nt">&lt;/artifactId&gt;</span>
-  <span class="nt">&lt;version&gt;</span>2.2.1<span class="nt">&lt;/version&gt;</span>
+  <span class="nt">&lt;version&gt;</span>2.2.2<span class="nt">&lt;/version&gt;</span>
 <span class="nt">&lt;/dependency&gt;</span>
 <span class="nt">&lt;dependency&gt;</span>
   <span class="nt">&lt;groupId&gt;</span>org.apache.felix<span class="nt">&lt;/groupId&gt;</span>
   <span class="nt">&lt;artifactId&gt;</span>org.apache.felix.http.bundle<span
class="nt">&lt;/artifactId&gt;</span>
-  <span class="nt">&lt;version&gt;</span>2.2.1<span class="nt">&lt;/version&gt;</span>
+  <span class="nt">&lt;version&gt;</span>2.2.2<span class="nt">&lt;/version&gt;</span>
+<span class="nt">&lt;/dependency&gt;</span>
+<span class="nt">&lt;dependency&gt;</span>
+  <span class="nt">&lt;groupId&gt;</span>org.apache.felix<span class="nt">&lt;/groupId&gt;</span>
+  <span class="nt">&lt;artifactId&gt;</span>org.apache.felix.http.cometd<span
class="nt">&lt;/artifactId&gt;</span>
+  <span class="nt">&lt;version&gt;</span>2.2.2<span class="nt">&lt;/version&gt;</span>
 <span class="nt">&lt;/dependency&gt;</span>
 <span class="nt">&lt;dependency&gt;</span>
   <span class="nt">&lt;groupId&gt;</span>org.apache.felix<span class="nt">&lt;/groupId&gt;</span>
   <span class="nt">&lt;artifactId&gt;</span>org.apache.felix.http.jetty<span
class="nt">&lt;/artifactId&gt;</span>
-  <span class="nt">&lt;version&gt;</span>2.2.1<span class="nt">&lt;/version&gt;</span>
+  <span class="nt">&lt;version&gt;</span>2.2.2<span class="nt">&lt;/version&gt;</span>
 <span class="nt">&lt;/dependency&gt;</span>
 <span class="nt">&lt;dependency&gt;</span>
   <span class="nt">&lt;groupId&gt;</span>org.apache.felix<span class="nt">&lt;/groupId&gt;</span>
   <span class="nt">&lt;artifactId&gt;</span>org.apache.felix.http.proxy<span
class="nt">&lt;/artifactId&gt;</span>
-  <span class="nt">&lt;version&gt;</span>2.2.1<span class="nt">&lt;/version&gt;</span>
+  <span class="nt">&lt;version&gt;</span>2.2.2<span class="nt">&lt;/version&gt;</span>
 <span class="nt">&lt;/dependency&gt;</span>
 <span class="nt">&lt;dependency&gt;</span>
   <span class="nt">&lt;groupId&gt;</span>org.apache.felix<span class="nt">&lt;/groupId&gt;</span>
   <span class="nt">&lt;artifactId&gt;</span>org.apache.felix.http.whiteboard<span
class="nt">&lt;/artifactId&gt;</span>
-  <span class="nt">&lt;version&gt;</span>2.2.1<span class="nt">&lt;/version&gt;</span>
+  <span class="nt">&lt;version&gt;</span>2.2.2<span class="nt">&lt;/version&gt;</span>
+<span class="nt">&lt;/dependency&gt;</span>
+<span class="nt">&lt;dependency&gt;</span>
+  <span class="nt">&lt;groupId&gt;</span>org.apache.felix<span class="nt">&lt;/groupId&gt;</span>
+  <span class="nt">&lt;artifactId&gt;</span>org.apache.felix.http.sslfilter<span
class="nt">&lt;/artifactId&gt;</span>
+  <span class="nt">&lt;version&gt;</span>0.0.1<span class="nt">&lt;/version&gt;</span>
 <span class="nt">&lt;/dependency&gt;</span>
 </pre></div>
       <div class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
-        Rev. 1575957 by jawi on Mon, 10 Mar 2014 14:57:00 +0000
+        Rev. 1575969 by jawi on Mon, 10 Mar 2014 15:26:06 +0000
       </div>
       <div class="trademarkFooter"> 
         Apache Felix, Felix, Apache, the Apache feather logo, and the Apache Felix project



Mime
View raw message