felix-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From j...@apache.org
Subject svn commit: r1575969 - /felix/site/trunk/content/documentation/subprojects/apache-felix-http-service.mdtext
Date Mon, 10 Mar 2014 15:26:06 GMT
Author: jawi
Date: Mon Mar 10 15:26:06 2014
New Revision: 1575969

URL: http://svn.apache.org/r1575969
Log:
Added section on port settings.

Modified:
    felix/site/trunk/content/documentation/subprojects/apache-felix-http-service.mdtext

Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-http-service.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-http-service.mdtext?rev=1575969&r1=1575968&r2=1575969&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-http-service.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-http-service.mdtext Mon
Mar 10 15:26:06 2014
@@ -253,14 +253,14 @@ Servlet service properties:
 
 * `alias` - Servlet alias to register with.
 * `contextId` - Id of context to register with.
-* `init.\*` - Servlet initialization values. 
+* `init.*` - Servlet initialization values. 
 
 Filter service properties:
 
 * `pattern` - Regular expression pattern to register filter with.
 * `contextId` - Id of context to register with.
 * `service.ranking` - Where in the chain this filter should be placed. 
-* `init.\*` - Filter initialization values. 
+* `init.*` - Filter initialization values. 
 
 HttpContext service properties:
 
@@ -302,10 +302,10 @@ The service can both be configured using
 |--|--|
 | `org.apache.felix.http.debug` | Flag to enable debugging for this service implementation.
The default is `false`. |
 | `org.apache.felix.http.host` | Host name or IP Address of the interface to listen on. The
default is `null` causing Jetty to listen on all interfaces. |
-| `org.osgi.service.http.port` | The port used for servlets and resources available via HTTP.
The default is `80`. A negative port number has the same effect as setting `org.apache.felix.http.enable`
to `false`. |
-| `org.osgi.service.http.port.secure` | The port used for servlets and resources available
via HTTPS. The default is `443`. A negative port number has the same effect as setting `org.apache.felix.https.enable`
to `false`. |
+| `org.osgi.service.http.port` | The port used for servlets and resources available via HTTP.
The default is `8080`. See [port settings below](#http-port-settings) for additional information.
A negative port number has the same effect as setting `org.apache.felix.http.enable` to `false`.
|
+| `org.osgi.service.http.port.secure` | The port used for servlets and resources available
via HTTPS. The default is `8443`. See [port settings below](#http-port-settings) for additional
information. A negative port number has the same effect as setting `org.apache.felix.https.enable`
to `false`. |
 | `org.apache.felix.http.context_path` | The Servlet Context Path to use for the Http Service.
If this property is not configured it  defaults to "/". This must be a valid path starting
with a slash and not  ending with a slash (unless it is the root context). |
-| `org.apache.felix.http.timeout` | Connection timeout in milliseconds. The default is 60000
(60 seconds). |
+| `org.apache.felix.http.timeout` | Connection timeout in milliseconds. The default is `60000`
(60 seconds). |
 | `org.apache.felix.http.session.timeout` | Allows for the specification of the Session life
time as a number of minutes. This property serves the same purpose as the `session-timeout`
element in a Web Application descriptor. The default is `0` (zero) for no timeout at all.
|
 | `org.apache.felix.http.nio` | Flag to enable the use of NIO instead of traditional IO for
HTTP. One consequence of using NIO with HTTP is that the bundle needs at least a Java 5 runtime.
The default is `true`. |
 | `org.apache.felix.https.nio` | Flag to enable the use of NIO instead of traditional IO
for HTTPS. One consequence of using NIO with HTTPS is that the bundle needs at least a Java
5 runtime. If this property is not set the (default) value of the `org.apache.felix.http.nio`
property is used. |
@@ -345,6 +345,22 @@ The CometD bundle supports the following
 |--|--|
 | `org.apache.felix.http.cometd.path` | Defines the path for the CometD endpoint. Default
is `/system/cometd`. |
 
+### HTTP port settings
+
+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:
+
+* `*` or `0`: binds to the first available port;
+* `8000`: binds to port `8000`, failing if this port is already taken;
+* `[8000,9000]`: binds to a free port in the range 8000 (inclusive) and 9000 (inclusive);
+* `[8000,9000)`: binds to a free port in the range 8000 (inclusive) and 9000 (exclusive);
+* `(8000,9000]`: binds to a free port in the range 8000 (exclusive) and 9000 (inclusive);
+* `(8000,9000)`: binds to a free port in the range 8000 (exclusive) and 9000 (exclusive);
+* `[,9000)`: binds to a free port in the range 1 (inclusive) and 9000 (exclusive);
+* `[8000,)`: binds to a free port in the range 8000 (inclusive) and 65535 (exclusive).
+
+Note that picking a port is *not* performed atomically and multiple instances can try to
bind to the same port at the same time.
 
 ## Servlet API Events
 
@@ -391,37 +407,47 @@ A set of simple examples illustrating th
     <dependency>
       <groupId>org.apache.felix</groupId>
       <artifactId>org.apache.felix.http.api</artifactId>
-      <version>2.2.1</version>
+      <version>2.2.2</version>
     </dependency>
     <dependency>
       <groupId>org.apache.felix</groupId>
       <artifactId>org.apache.felix.http.base</artifactId>
-      <version>2.2.1</version>
+      <version>2.2.2</version>
     </dependency>
     <dependency>
       <groupId>org.apache.felix</groupId>
       <artifactId>org.apache.felix.http.bridge</artifactId>
-      <version>2.2.1</version>
+      <version>2.2.2</version>
     </dependency>
     <dependency>
       <groupId>org.apache.felix</groupId>
       <artifactId>org.apache.felix.http.bundle</artifactId>
-      <version>2.2.1</version>
+      <version>2.2.2</version>
+    </dependency>
+    <dependency>
+      <groupId>org.apache.felix</groupId>
+      <artifactId>org.apache.felix.http.cometd</artifactId>
+      <version>2.2.2</version>
     </dependency>
     <dependency>
       <groupId>org.apache.felix</groupId>
       <artifactId>org.apache.felix.http.jetty</artifactId>
-      <version>2.2.1</version>
+      <version>2.2.2</version>
     </dependency>
     <dependency>
       <groupId>org.apache.felix</groupId>
       <artifactId>org.apache.felix.http.proxy</artifactId>
-      <version>2.2.1</version>
+      <version>2.2.2</version>
     </dependency>
     <dependency>
       <groupId>org.apache.felix</groupId>
       <artifactId>org.apache.felix.http.whiteboard</artifactId>
-      <version>2.2.1</version>
+      <version>2.2.2</version>
+    </dependency>
+    <dependency>
+      <groupId>org.apache.felix</groupId>
+      <artifactId>org.apache.felix.http.sslfilter</artifactId>
+      <version>0.0.1</version>
     </dependency>
 
 



Mime
View raw message