Enabling Web Application Support
This topic discusses the features that become available when you turn on the Web Application option.
- Overview of the features
- Turning on the Web Application option
- Managing deployment descriptors, web resource directories and Java web source roots
- Managing application artifacts
For the Web Application option and associated features to be available:
- You should be using the ULTIMATE Edition of IntelliJ IDEA. (The corresponding functionality is not available in the Community Edition.)
- The Java EE: EJB, JPA, Servlets plugin must be enabled. (This plugin is bundled with the IDE and enabled by default.)
Overview of the features
When you turn on the Web Application option, IntelliJ IDEA:
- Creates a web resource directory
index.jspintended as a starting page of your app and, optionally, a web app deployment descriptor
- Creates a Web facet that lets you manage your deployment descriptors, web resource directories and your Java web source roots.
- Creates an Exploded WAR artifact configuration.
- Makes the Web tool window available.
If you turn on the Web Application option when creating a project or module and specify an application server, IntelliJ IDEA also creates a run/debug configuration for that server.
Turning on the Web Application option
You can turn on the Web Application option:
- When creating a project or module (New Project or the New Module wizard, select Java Enterprise, and then select the Web Application checkbox under Additional Libraries and Frameworks. or ). On the first page of the
- For an existing module. In the Project tool window ( ), right-click the module folder and select Add Framework Support. Then select the Web Application checkbox in the dialog that opens.
Managing deployment descriptors, web resource directories and Java web source roots
You can manage your web app deployment descriptors, web resource directories and Java web source roots in the Project Structure dialog:
- Open the Project Structure dialog (e.g. Ctrl+Shift+Alt+S).
- In the leftmost pane, select Modules or Facets.
- In the pane to the right, select Web or Web (<ModuleName>).
- On the page that opens in the right-hand part of the dialog:
Deployment Descriptors. Form the list of deployment descriptors for your web app.
Web Resource Directories. Specify the directories that contain your web app resources such as web pages, images, etc.
Source Roots. Select the source roots that contain your web application Java classes (servlets, filters, managed beans, etc.).
For more info, see Web facet page.
Managing application 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, obviously, a WAR file.
To manage your artifact configurations, use the Project Structure dialog ( ).
See also, Working with Artifacts.