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 |
---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Configuration Features
Feature name |
Java API |
Ant tasks |
Maven 3 plugin |
Comment |
---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Deployer Features
Feature name |
Java API |
Ant tasks |
Maven 3 plugin |
Comment |
---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Other Features
Feature name |
Java API |
Ant tasks |
Maven 3 plugin |
Comment |
---|---|---|---|---|
|
|
|
|
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 |
---|---|---|---|---|
|
|
|
||
|
JAVA_HOME version 17 or newer |
|||
|
|
|||
|
N/A |
|||
|
N/A |
|||
|
N/A |
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
N/A |
|||
|
N/A |
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
N/A |
|||
|
|
|||
|
N/A |
|||
|
N/A |
|||
|
N/A |
Datasource and Resource configuration
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:
JettyPropertySet.DEPLOYER_CREATE_CONTEXT_XML
must must be set totrue
.JettyPropertySet.MODULES
must contain the rightjetty-plus
modules for the application(s) in scope.JettyPropertySet.DEPLOYER_EE_VERSION
must be set aligned with thejetty-plus
module EE version mentioned above.
How to run Jetty under a Java Security Manager
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.
For embedded container o.c.c.c.jetty.Jetty12xEmbeddedLocalContainer
Property name |
Java Property |
Supported? |
Default value |
Javadoc |
---|---|---|---|---|
|
|
|
||
|
JAVA_HOME version 17 or newer |
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
N/A |
|||
|
N/A |
|||
|
|
|
||
|
|
|||
|
|
|
||
|
N/A |
|||
|
|
|||
|
N/A |
|||
|
N/A |
|||
|
N/A |
Jetty 12.x Embedded container and EE versions
Jetty 12.x supports multiple Java / Jakarta EE versions, for the Embedded container this is steered through the JettyPropertySet.DEPLOYER_EE_VERSION
property.
When using this feature through the Java API or Ant tasks, you will have to set the classpath accordingly. The Maven 3 plugin for Jetty 12.x Embedded will resolve the right Jetty artifacts automagically based on the cargo.jetty.deployer.ee.version
property of the container configuration.
Existing Local Configuration Properties
For installed container o.c.c.c.jetty.Jetty12xInstalledLocalContainer
Property name |
Java Property |
Supported? |
Default value |
Javadoc |
---|---|---|---|---|
|
|
|||
|
JAVA_HOME version 17 or newer |
|||
|
|
|||
|
N/A |
|||
|
N/A |
|||
|
N/A |
|||
|
|
|||
|
|
|||
|
N/A |
|||
|
|
|||
|
|
|||
|
|
|||
|
N/A |
|||
|
|
|||
|
N/A |
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.19/jetty-home-12.0.19.tar.gz