IntelliJ IDEA 2023.3 Help

Enable Web application support

When you enable Web Application support in IntelliJ IDEA, it can do the following:

  • Create a web resource directory web with index.jsp intended as a starting page of your app and, optionally, a web app deployment descriptor WEB-INF/web.xml.

  • Create a Web facet that lets you manage your deployment descriptors, web resource directories, and your Java web source roots.

  • Create an Exploded WAR artifact configuration.

  • Provide access to the Web tool window.

If you enable Web Application support when creating a project or module and specify an application server, IntelliJ IDEA also creates a run/debug configuration for that server.

Create new web application

  1. Click New Project on the Welcome screen or select File | New | Project.

  2. From the Generators list, select Jakarta EE.

  3. Name the new project, select a build tool, a language you want to use, and select the Web application project template.

  4. Select the Create Git repository option to place the new project under version control.

  5. From the JDK list, select the JDK that you want to use in your project.

    If the JDK is installed on your computer, but not defined in the IDE, select Add JDK and specify the path to the JDK home directory.

    If you don't have the necessary JDK on your computer, select Download JDK.

    Creating new Java Enterprise project
  6. On the next step of the wizard, select the Java Enterprise version to be supported.

    From the Dependencies list, select Servlet.

  7. Click Create.

Add web application support to existing module

  1. In the Project tool window Alt+1, select the necessary module.

  2. Press Ctrl+Shift+A and type Add Framework Support.

    Once the action is found, click it to open the Add Framework Support dialog.

  3. In the dialog that opens, select Web Application and select a version of the Servlet specification.

  4. If you want the deployment descriptor web.xml file to be created, select the Create web.xml checkbox.

    Click OK.

Adding support for a framework

Manage web application settings

You can manage your web app deployment descriptors, web resource directories, and Java web source roots in the Project Structure dialog.

  1. In the main menu, go to File | Project Structure or press Ctrl+Alt+Shift+S.

  2. In the left pane, select Modules or Facets.

  3. Select the Web facet.

  4. Configure the following:

    Deployment Descriptors

    List of deployment descriptors for your app

    Web Resource Directories

    Directories that contain your web app resources, such as web pages and images

    Source Roots

    Source roots contain your web application Java classes, such as servlets, filters, and managed beans.

    For more information, refer to Web facet page.

Manage application artifacts

To manage your artifact configurations, use the Project Structure dialog (File | Project Structure | Artifacts).

To deploy your application to a server, you need an application artifact. For Java web applications, IntelliJ IDEA provides the following artifact formats:

  • Web Application: Exploded. This is a decompressed Web application archive (WAR), a directory structure that is ready for deployment onto a web server.

  • Web Application: Archive. This is a WAR file.

Web application artifacts

For more information, refer to Artifacts.

Last modified: 15 March 2024