This page has been automatically generated by Cargo's build. Do not edit it directly as it'll be overwritten next time it's generated again.

Jetty 12.x onwards support various versions of Jakarta EE, by adapting the JettyPropertySet.MODULES and JettyPropertySet.DEPLOYER_EE_VERSION configuration properties accordingly.

Users of the Jakarta EE 9 and above versions should be aware that, as a result of the move from Java EE to Jakarta EE as part of the transfer of Java EE to the Eclipse Foundation, the primary package for all implemented APIs has changed from javax.* to jakarta.*. This will almost certainly require code changes to enable applications to migrate to EE 9 and later.

Container Features

Feature name

Java API

Ant tasks

Maven 3 plugin

Comment

Container Instantiation

(tick) ContainerFactory.createContainer("jetty12x"...)

(tick) <cargo containerId="jetty12x".../>

(tick) <containerId>jetty12x</containerId>

 

Local Container

(tick)

(tick)

(tick)

 

  Container Classpath

(tick)

(tick)

(tick)

 

  Container Start

(tick)

(tick)

(tick)

 

  Container Stop

(tick)

(tick)

(tick)

 

  Container Timeout

(tick)

(tick)

(tick)

 

  Embedded Container

(error)

(error)

(error)

 

  Installed Container

(tick) o.c.c.c.jetty.Jetty12xInstalledLocalContainer

(tick)

(tick)

 

   Passing system properties

(tick)

(tick)

(tick)

 

   Installer

(tick)

(tick)

(tick)

 

Remote Container

(error)

(error)

(error)

 

Configuration Features

Feature name

Java API

Ant tasks

Maven 3 plugin

Comment

Standalone Local Configuration for installed container

(tick) o.c.c.c.jetty.Jetty12xStandaloneLocalConfiguration

(tick)

(tick)

 

Standalone Local Configuration for embedded container

(error)

(error)

(error)

 

Existing Local Configuration for installed container

(tick) o.c.c.c.jetty.Jetty12xExistingLocalConfiguration

(tick)

(tick)

 

Existing Local Configuration for embedded container

(error)

(error)

(error)

 

Runtime Configuration

(error)

(error)

(error)

 

Static deployment of WAR

(tick)

(tick)

(tick)

 

Static deployment of expanded WAR

(tick)

(tick)

(tick)

 

Static deployment of EJB

(error)

(error)

(error)

 

Static deployment of EAR

(error)

(error)

(error)

 

Static deployment of RAR

(error)

(error)

(error)

 

Static deployment of files

(error)

(error)

(error)

 

Static deployment of OSGi Bundles

(error)

(error)

(error)

 

Deployer Features

Feature name

Java API

Ant tasks

Maven 3 plugin

Comment

Installed Deployer

(tick) o.c.c.c.jetty.Jetty12xInstalledLocalDeployer

(tick)

(tick)

 

Embedded Deployer

(error)

(error)

(error)

 

Remote Deployer

(error)

(error)

(error)

 

Other Features

Feature name

Java API

Ant tasks

Maven 3 plugin

Comment

Debugging

(tick)

(tick)

(tick)

 

Supported Configuration properties

The tables below list both the general configuration properties as well as the container-specific ones.

Standalone Local Configuration Properties

For installed container o.c.c.c.jetty.Jetty12xInstalledLocalContainer

Property name

Java Property

Supported?

Default value

Javadoc

cargo.hostname

GeneralPropertySet.HOSTNAME

(error)

localhost

 

cargo.java.home

GeneralPropertySet.JAVA_HOME

(tick)

JAVA_HOME version 17 or newer

(green star)

cargo.jetty.connector.https.port

JettyPropertySet.CONNECTOR_HTTPS_PORT

(tick)

9443

(green star)

cargo.jetty.connector.keystoreFile

JettyPropertySet.CONNECTOR_KEY_STORE_FILE

(tick)

N/A

(green star)

cargo.jetty.connector.keystorePass

JettyPropertySet.CONNECTOR_KEY_STORE_PASSWORD

(tick)

N/A

(green star)

cargo.jetty.connector.keystoreType

JettyPropertySet.CONNECTOR_KEY_STORE_TYPE

(tick)

N/A

(green star)

cargo.jetty.deployer.createContextXml

JettyPropertySet.DEPLOYER_CREATE_CONTEXT_XML

(tick)

true

(green star)

cargo.jetty.deployer.ee.version

JettyPropertySet.DEPLOYER_EE_VERSION

(tick)

ee10

(green star)

cargo.jetty.modules

JettyPropertySet.MODULES

(tick)

server,ext,http,ee10-annotations,ee10-plus,ee10-jsp,ee10-deploy

(green star)

cargo.jetty.realm.name

JettyPropertySet.REALM_NAME

(tick)

Cargo Test Realm

(green star)

cargo.jetty.servlet.default.useFileMappedBuffer

JettyPropertySet.USE_FILE_MAPPED_BUFFER

(tick)

true

(green star)

cargo.jetty.session.path

JettyPropertySet.SESSION_PATH

(tick)

N/A

(green star)

cargo.jvmargs

GeneralPropertySet.JVMARGS

(tick)

N/A

(green star)

cargo.logging

GeneralPropertySet.LOGGING

(tick)

medium

(green star)

cargo.port.offset

GeneralPropertySet.PORT_OFFSET

(tick)

0

(green star)

cargo.process.spawn

GeneralPropertySet.SPAWN_PROCESS

(tick)

false

(green star)

cargo.protocol

GeneralPropertySet.PROTOCOL

(tick)

http

(green star)

cargo.runtime.args

GeneralPropertySet.RUNTIME_ARGS

(tick)

N/A

(green star)

cargo.servlet.port

ServletPropertySet.PORT

(tick)

8080

(green star)

cargo.servlet.users

ServletPropertySet.USERS

(tick)

N/A

(green star)

cargo.standalone.ignoreNonExistingProperties

GeneralPropertySet.IGNORE_NON_EXISTING_PROPERTIES

(tick)

N/A

(green star)

cargo.start.jvmargs

GeneralPropertySet.START_JVMARGS

(tick)

N/A

(green star)

In addition to the forementioned properties, this container configuration can also set up datasources and/or resources.

For more details, please read: DataSource and Resource Support.

Since the Jetty 12.x jetty-plus modules are specific to EE versions, datasources and resources are deployed using each application's context.xml file, matching the EE version.

The below are hence pre-requisites to using datasources or resources in Jetty 12.x:

Jetty 9.x and above can be configured to run under a Java Security Manager.

For further information on how to achieve this, please refer to the associated tip in the Maven 3 Plugin Tips page.

Existing Local Configuration Properties

For installed container o.c.c.c.jetty.Jetty12xInstalledLocalContainer

Property name

Java Property

Supported?

Default value

Javadoc

cargo.hostname

GeneralPropertySet.HOSTNAME

(tick)

localhost

(green star)

cargo.java.home

GeneralPropertySet.JAVA_HOME

(tick)

JAVA_HOME version 17 or newer

(green star)

cargo.jetty.connector.https.port

JettyPropertySet.CONNECTOR_HTTPS_PORT

(tick)

9443

(green star)

cargo.jetty.connector.keystoreFile

JettyPropertySet.CONNECTOR_KEY_STORE_FILE

(tick)

N/A

(green star)

cargo.jetty.connector.keystorePass

JettyPropertySet.CONNECTOR_KEY_STORE_PASSWORD

(tick)

N/A

(green star)

cargo.jetty.connector.keystoreType

JettyPropertySet.CONNECTOR_KEY_STORE_TYPE

(tick)

N/A

(green star)

cargo.jetty.deployer.ee.version

JettyPropertySet.DEPLOYER_EE_VERSION

(tick)

ee10

(green star)

cargo.jetty.modules

JettyPropertySet.MODULES

(tick)

server,ext,http,ee10-annotations,ee10-plus,ee10-jsp,ee10-deploy

(green star)

cargo.jvmargs

GeneralPropertySet.JVMARGS

(tick)

N/A

(green star)

cargo.port.offset

GeneralPropertySet.PORT_OFFSET

(tick)

0

(green star)

cargo.process.spawn

GeneralPropertySet.SPAWN_PROCESS

(tick)

false

(green star)

cargo.protocol

GeneralPropertySet.PROTOCOL

(tick)

http

(green star)

cargo.runtime.args

GeneralPropertySet.RUNTIME_ARGS

(tick)

N/A

(green star)

cargo.servlet.port

ServletPropertySet.PORT

(tick)

8080

(green star)

cargo.start.jvmargs

GeneralPropertySet.START_JVMARGS

(tick)

N/A

(green star)

Tested On

This container is automatically tested by the Continous Integration system every time there is a code change.
The server used for tests is downloaded from: https://repo.maven.apache.org/maven2/org/eclipse/jetty/jetty-home/12.0.9/jetty-home-12.0.9.tar.gz