Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Configuring the Jetty Runtime

...

The httpj:engine-factory element has three children that contain the information used to configure the HTTP ports instantiated by the Jetty runtime factory. The children are described below.

Element

Description

httpj:engine

Specifies the configuration for a particular Jetty runtime instance.

httpj:identifiedTLSServerParameters

Specifies a reusable set of properties for securing an HTTP server. It has a single attribute, id, that specifies a unique identifier by which the property set can be referred.

httpj:identifiedThreadingParameters

Specifies a reusable set of properties for controlling a Jetty instance's thread pool. It has a single attribute, id, that specifies a unique identifier by which the property set can be referred.

The engine element

The httpj:engine element is used to configure specific instances of the Jetty runtime. It has a single attribute, port, that specifies the number of the port being managed by the Jetty instance.

...

The child elements used to provide the configuration properties are described below.

Element

Description

httpj:tlsServerParameters

Specifies a set of properties for configuring the security used for the specific Jetty instance. See the TLS Configuration page for more information.

httpj:tlsServerParametersRef

Refers to a set of security properties defined by a identifiedTLSServerParameters element. The id attribute provides the id of the referred identifiedTLSServerParameters element.

httpj:threadingParameters

Specifies the size of the thread pool used by the specific Jetty instance.

httpj:threadingParametersRef

Refers to a set of properties defined by a identifiedThreadingParameters element. The id attribute provides the id of the referred identifiedThreadingParameters element.

httpj:connector

You can use spring beans syntax to instantiate a connector and set the connector's properties , this connector will be set to the Jetty server engine

httpj:handlers

You can use spring beans syntax to instantiate a Jetty handler list and set these handlers' properties , the jetty handlers will be set to the Jetty server engine

httpj:sessionSupport

If the value is true , the Jetty Engine will set up a session manager for the Jetty server engine to maintain the sessions. The default value of it is false.

httpj:reuseAddress

The the value is true, the Jetty Engine connector's socket will enable the SO_REUSEADDR flage. The default value of it is true. (This feature is available in CXF 2.0.3)

Configuring the thread pool

...

  • Specifying the size of thread pool using a identifiedThreadingParameters element in the engine-factory element. You then refer to the element using a threadingParametersRef element.
  • Specify the size of the of thread pool directly using a threadingParameters element.
    The threadingParameters has two attributes to specify the size of a thread pool. The attributes are described below.

    Note

    The httpj:identifiedThreadingParameters element has a single child threadingParameters element.


Attribute

Description

minThreads

Specifies the minimum number of threads available to the Jetty instance for processing requests.

maxThreads

Specifies the maximum number of threads available to the Jetty instance for processing requests.

Example

The example below shows a configuration fragment that configures a Jetty instance on port number 9001.

...