Ultimate
Enterprise application support

Last modified: 01 August 2022

By default, a Java Enterprise project in IntelliJ IDEA is not configured for full enterprise application development.

Enable enterprise application support for your project

  1. In the Project tool window, right-click the root module directory and select Add Framework Support….

  2. In the Add Frameworks Support dialog, select JavaEE Application and click OK.

This adds a deployment descriptor application.xml under META-INF in your project directory, a JavaEE Application facet and an enterprise application archive (EAR) artifact configuration.

Manage deployment descriptors

A deployment descriptor describes how to deploy your application. It contains information about the configuration requirements, container options, and security settings. By default, IntelliJ IDEA generates one deployment descriptor for your enterprise application: META-INF/application.xml.

  1. Press Ctrl+Alt+Shift+S to open the Project Structure dialog.

  2. Open the Facets page and select the javaEEApplication facet.

    You can click The Add button to add other deployment descriptors. You can also add deployment descriptors that are specific to your application server (runtime deployment descriptors).

Manage application artifacts

Artifacts are the main application deliverables that you deploy to an application server.

  1. Press Ctrl+Alt+Shift+S to open the Project Structure dialog.

  2. Open the Artifacts page and select the default exploded EAR artifact configured for your application. You can see and configure the settings of this artifact or click the Add button to add a regular EAR archive artifact and create a manifest file for it.

You can build any of the configured artifacts by selecting Build | Build Artifacts… from the main menu. You can also add these artifact configurations to your application server run configuration so that IntelliJ IDEA builds and deploys the artifacts as necessary.

Migrate from Java EE to Jakarte EE

  1. From the main menu, select Refactor | Migrate….

  2. In the Package and Class Migration dialog, select the Java EE to Jakarta EE migration map and click Run.

    If necessary, you can make a copy of the default migration map and adjust it to your needs. You can also select the module for which you want to perform the migration.