The HTTP bundle can be configured by both CM or System properties
As soon as the http bundle gets a valid configuration it creates and registers an HttpService instance into the framework.
To use HTTPS a bundle providing a SslServerSocketFactory must be installed. E.g., SSL Provider — J2SP.
Note: If the server fails to bind to a port, an HttpService will still be registered, but the service property "port" will not be present!
Usage: list [-help] [-c] [-r] [-t] [-l] List all the configured HTTP servers -c Show configuration info -r Show all registrations, servlets and resources -t Show info on transactions -l List in long format, same as supplying -c -r -t, providing extensive details
Name | Description | Type | Default |
---|---|---|---|
org.knopflerfish.http.enabled | If true, the bundle will start to listen in the http port. | boolean | true |
org.knopflerfish.http.secure.enabled | If true, the bundle will start to listen in the https port. Note: This functionality requires that the bundle is able to obtain a SslServerSocketFactory service instance from the frameworks service registry. | boolean | true |
org.osgi.service.http.port | Port number that the HTTP server will listen for http-requests on. | int | 80 |
org.osgi.service.http.secure.port | Port number that the HTTP server will listen for https-requests on. | int | 443 |
org.osgi.service.http.hostname | Host (IP interface name) to open the HTTP server socket on. An empty string means all available interfaces. | String | |
org.knopflerfish.http.mime.props | URL to properties file defining MIME type mappings. The key in the properties file is the file name extension and the value is the associated MIME type. | String | |
org.knopflerfish.http.dnslookup | This boolean property decides if the server will use DNS lookup when a servlet calls the HttpServletRequest.getRemoteHost method. In some environments DNS lookup will cause the current transaction to hang for a long period of time. | boolean | false |
org.knopflerfish.http.response.buffer.size.default | This integer property decides the default buffer size in bytes for an HTTP response. If a servlet or publisher does not exceed this buffer, the server will calculate and send the content length header in the response. If the buffer is exceeded the servlet or publisher need to set the content length header explicitly. The content length header is required for persistent connections. If the content length is unknown the server will send a connection close header. The buffer size can be set runtime by the servlet using the HttpResponse.setBufferSize() method. | int | 16384 |
org.knopflerfish.http.connection.max | This integer property decides the maximum number of concurrent connections to the HTTP server. | int | 50 |
org.knopflerfish.http.connection.timeout | This integer property decides the timeout in seconds for a persistent connection to the HTTP server. | int | 30 |
org.knopflerfish.http.session.timeout.default | This integer property decides the default timeout in seconds for an HTTP session. | int | 1200 |
org.knopflerfish.http.encoding.default | The default character encoding to use for text in the HTTP response. | String | ISO-8859-1 |
org.knopflerfish.http.req.client.auth | If client authentication shall be required or not when using https. | boolean | false |
org.knopflerfish.http.trace.enabled | If the TRACE method shall be enabled or not | boolean | false |
org.knopflerfish.http.limit.requestline | Defines the maximum length of an HTTP request line. This limit is also applied for HTTP header lines. When exceeding this limit a 413 response is returned - Request Entity Too Large. | int | 8090 |
org.knopflerfish.http.limit.requestheaders | Defines the maximum number of headers accepted per request. When exceeding this limit a 413 response is returned - Request Entity Too Large. | int | 100 |
org.knopflerfish.http.limit.postsize | Defines the maximum content size for a POST request. A value of -1 indicates there is no limit. This is also the default behaviour. When exceeding this limit a 413 response is returned - Request Entity Too Large. | int | -1 |
org.knopflerfish.bundle.http.factory.HttpServer..with the following properties:
Package | Version | Providers |
---|---|---|
org.knopflerfish.service.log | 1.2.0 | http_all-4.0.5 |
org.osgi.service.http | 1.2.1 | http_all-4.0.5, http_api-4.0.5 |