IntelliJ IDEA 13.1.0 Web Help

Some features described here are available in Ultimate edition only.

The dedicated Web facet provides facilities for developing Web applications, sets up the relevant module structure, and creates the required deployment descriptors. You can create a new module with a dedicated Web Application facet from scratch or add a facet to an existing module.

IntelliJ IDEA configures the module as follows:

  • Creates the structure of the module with the web and WEB-INF nodes.
  • Creates a Web application deployment descriptor web.xml under the WEB-INF node .


    This is done automatically for versions 2.2 - 2.5.

  • Creates an index.jsp file that will be the home page of your application and stores it below the web node.
  • Configures a basic artifact of the type exploded with the following structure:


    You can use this configuration as is or customize it, as required, for example, include static Web content resources.

To enable web development support in a new module
  1. Create a Java module from scratch.

    On the first page of the wizard, select Java Module, not Web Module. (The Web module type is for developing web applications using programming languages other than Java, for example, PHP, or JavaScript, or markup languages.)

  2. On the fourth, Select the desired technologies, page of the wizard, select the Web Application check box.
  3. From the Version drop-down list, select the relevant specification. The available options are:
    • 2.2 - 2.5 - if you choose one of these options, IntelliJ IDEA will create a Web application deployment descriptor for you automatically.
    • 3.0 - if you choose this option, select the Create web.xml check box to have a Web application deployment descriptor created. Clear the check box to use annotations instead.
To configure web development support in an existing module
  1. Add a Web facet to the module and open its settings. The right-hand pane shows the Web Facet settings.
  2. The Deployment Descriptors area shows the location of the web.xml deployment descriptor, which is already created for you. To change its location or version, click edit1 ().
  3. To assign another existing descriptor, click delete () and confirm deletion in the Delete Deployment Descriptor dialog box that opens. To have the current descriptor removed from your computer, select the Also delete file from disk check box and click Yes. In the Deployment Descriptors area, where IntelliJ IDEA returns you, click add ( or or or or ) and select the desired version and file in the Deployment Descriptor Location dialog box that opens.
  4. If your application server needs a proprietary deployment descriptor, click the Add Application Server Specific Descriptor button and select your server from the list.

No matter whether you are creating a module from scratch or adding a Web facet to an existing module, IntelliJ IDEA detects conflicts and suggests to resolve them.

  • If some required libraries are missing, click the Fix button. The necessary libraries will be downloaded and installed automatically.
  • If the facet resources are not included in any of the previously configured artifacts, click the Fix button and choose the appropriate artifact from the list.
  • If no artifacts of the relevant type are configured, click the Create Artifact button and configure the artifact layout on the Artifacts page of the Project Structure dialog box that opens.

See Also




Web Resources: