Introduction
This service implements the Http Service Specification as described in chapter 102 of the OSGi Compendium. It uses Jetty as its implementation.
Configuration Properties
The service can both be configured using OSGi environment properties and using Configuration Admin. The service PID for this service is "org.apache.felix.http"
. If you use both methods, Configuration Admin takes precedence. The following properties can be used (some legacy property names still exist but are not documented here on purpose):
org.osgi.service.http.port
- The port used for servlets and resources available via HTTP. The default is80
.org.osgi.service.http.port.secure
- The port used for servlets and resources available via HTTPS. The default is443
.org.apache.felix.http.nio
- Flag to enable the use of NIO instead of traditional IO. One consequence of using NIO with HTTPS is that the bundle needs at least a Java 5 runtime. The default istrue
.org.apache.felix.http.svcprop.port
- The name of the property to use to set the HTTP port. The default isorg.osgi.service.http.port
.org.apache.felix.http.svcprop.port.secure
- The name of the property to use to set the HTTPS port. The default isorg.osgi.service.http.port.secure
.org.apache.felix.http.enable
- Flag to enable the use of HTTP. The default istrue
.org.apache.felix.https.enable
- Flag to enable the user of HTTPS. The default isfalse
.org.apache.felix.https.keystore
- The name of the file containing the keystore.org.apache.felix.https.keystore.password
- The password for the keystore.org.apache.felix.https.keystore.key.password
- The password for the key in the keystore.org.apache.felix.https.truststore
- The name of the file containing the truststore.org.apache.felix.https.truststore.password
- The password for the truststore.org.apache.felix.https.clientcertificate
- Flag to determine if the HTTPS protocol requires, wants or does not use client certificates. Legal values areneeds
,wants
andnone
. The default isnone
.org.apache.felix.http.debug
- Flag to enable debugging for this service implementation. The default isfalse
.