Tutorial: Your first Java EE application | IntelliJ IDEA Documentation

Tutorial: Your first Java EE application

This tutorial describes how to create a simple Java EE web application in IntelliJ IDEA. The application will include a single JSP page that shows Hello, World! and a link to a Java servlet that also shows Hello, World!.

You will create a new Java Enterprise project using the web application template, tell IntelliJ IDEA where your GlassFish server is located, then use a run configuration to build the artifact, start the server, and deploy the artifact to it.

Here is what you will need:

IntelliJ IDEA Ultimate

Java Enterprise development is not supported in the free IntelliJ IDEA Community Edition. For more information, see IntelliJ IDEA Ultimate vs IntelliJ IDEA Community Edition

Relevant bundled plugins

By default, all necessary plugins are bundled and enabled in IntelliJ IDEA Ultimate. If something does not work, make sure that the following plugins are enabled:

  • Jakarta EE Platform

  • Jakarta EE: Application Servers

  • Jakarta EE: Web/Servlets

  • GlassFish

For more information, see Install plugins.

Java SE Development Kit (JDK) version 1.8 or later

You can get the JDK directly from IntelliJ IDEA as described in Java Development Kit (JDK) or download and install it manually, for example: Oracle JDK or OpenJDK.

GlassFish Server

The GlassFish application server version 4.0 or later. You can get the latest release from the official repository. The Web Profile subset should be enough for the purposes of this tutorial.

This tutorial uses Oracle OpenJDK 17, Jakarta EE 9.1, and GlassFish 6.2.5. For more information about the compatibility between other GlassFish, Java, and Jakarta EE versions, see https://github.com/eclipse-ee4j/glassfish#compatibility.

Web browser

You will need a web browser to view your web application.

Create a new Java Enterprise project

IntelliJ IDEA includes a dedicated wizard for creating Java Enterprise projects based on various Java EE and Jakarta EE implementations. In this tutorial, we will create a simple web application.

  1. From the main menu, select File | New | Project.

  2. In the New Project dialog, select Jakarta EE.

  3. Enter a name for your project: JavaEEHelloWorld.

  4. Select the Web application template, Maven as a build tool, and use Oracle OpenJDK 17 as the project SDK. Don’t select or add an application server, we will do it later.

    Click Next to continue.

    New Java Enterprise project wizard

  5. In the Version field, select Jakarta EE 9.1 because that’s what GlassFish 6.2.5 used in this tutorial is compatible with.

    For GlassFish 5, select the Java EE 8 specification. For GlassFish 7, select Jakarta EE 10.

    In the Dependencies list, you can see that the web application template includes only the Servlet framework under Specifications.

    New Java Enterprise project wizard

  6. Click Create.

Explore the default project structure

IntelliJ IDEA creates a project with some boilerplate code that you can build and deploy successfully.

  • pom.xml is the Project Object Model with Maven configuration information, including dependencies and plugins necessary for building the project.

    <?xml version=”1.0″ encoding=”UTF-8″?>
    <project xmlns=”http://maven.apache.org/POM/4.0.0″
    xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”
    xsi:schemaLocation=”http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd”>
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <name>demo</name>
    <packaging>war</packaging>

    <properties>
    <maven.compiler.target>1.8</maven.compiler.target>
    <maven.compiler.source>1.8</maven.compiler.source>
    <junit.version>5.7.0</junit.version>
    </properties>

    <dependencies>
    <dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
    </dependency>
    <dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <version>${junit.version}</version>
    <scope>test</scope>
    </dependency>
    <dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-engine</artifactId>
    <version>${junit.version}</version>
    <scope>test</scope>
    </dependency>
    </dependencies>

    <build>
    <plugins>
    <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <version>3.3.0</version>
    </plugin>
    </plugins>
    </build>
    </project>

  • index.jsp is the starting page of your application that opens when you access the root directory URL. It renders Hello World! and a link to /hello-servlet.

    <%@ page contentType=”text/html; charset=UTF-8″ pageEncoding=”UTF-8″ %>
    <!DOCTYPE html>
    <html>
    <head>
    <title>JSP – Hello World</title>
    </head>
    <body>
    <h1><%= “Hello World!” %>
    </h1>
    <p/>
    <a href=”hello-servlet”>Hello Servlet</a>
    </body>
    </html>

  • The HelloServlet class extends HttpServlet and is annotated with @WebServlet. It processes requests to /hello-servlet: a GET request returns HTML code that renders Hello World!.

    package com.example.demo;

    import java.io.*;
    import javax.servlet.http.*;
    import javax.servlet.annotation.*;

    @WebServlet(value = “/hello-servlet”)
    public class HelloServlet extends HttpServlet {
    private String message;

    public void init() {
    message = “Hello World!”;
    }

    public void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException {
    response.setContentType(“text/html”);

    // Hello
    PrintWriter out = response.getWriter();
    out.println(“<html><body>”);
    out.println(“<h1>” + message + “</h1>”);
    out.println(“</body></html>”);
    }

    public void destroy() {
    }
    }

Use the Project tool window to browse and open files in your project or press Ctrl+Shift+N and type the name of the file.

Configure GlassFish

IntelliJ IDEA can build and deploy your application’s artifacts if you specify the location of your server. For this tutorial, you should have the GlassFish server installed. You can download GlassFish from the official project website.

  1. Press Ctrl+Alt+S to open the IDE settings and select Build, Execution, Deployment | Application Servers.

  2. Click the Add button and select Glassfish Server.

  3. Specify the path to the GlassFish server install location. IntelliJ IDEA detects and sets the name and version appropriately.

    GlassFish application server configuration

Create a GlassFish run configuration

IntelliJ IDEA needs a run configuration to build the artifact and deploy it to your application server.

  1. From the main menu, select Run | Edit Configurations.

  2. In the Run/Debug Configurations dialog, click the Add button, expand the Glassfish Server node, and select Local.

  3. Fix any warnings that appear at the bottom of the run configuration settings dialog.

    GlassFish run configuration warning

    Most likely, you will need to fix the following:

    • On the Server tab, set the Server Domain to domain1.

    • On the Deployment tab, add the artifact that you want to deploy: JavaEEHelloWorld:war exploded

  4. On the Server tab, set the URL to http://localhost:8080/JavaEEHelloWorld-1.0-SNAPSHOT/ and save the run configuration.

    GlassFish run configuration done

  5. To run the configuration, press Alt+Shift+F10 and select the created GlassFish configuration.

This run configuration builds the artifact, then starts the GlassFish server, and deploys the artifact to the server. You should see the corresponding output in the Run tool window.

Started GlassFish server and deployed application in the Run tool window

Once this is done, it opens the specified URL in your web browser.

Deployed application output in the web browser

Here is a link to the URL: http://localhost:8080/JavaEEHelloWorld-1.0-SNAPSHOT/

Modify the application

Whenever you change the source code of the application, you can restart the run configuration to see the changes. But this is not always necessary, especially when you can’t restart the server. Most of the changes are minor and don’t require rebuilding the artifacts, restarting the server, and so on. Let’s change the JSP page of the application.

  1. Open index.jsp and change the greeting from Hello, World! to A better greeting..

  2. In the Run tool window, click The Update Application button or press Ctrl+F10.

  3. In the Update dialog, select Update resources because the JSP page is a static resource. Click OK.

  4. Refresh the application URL in your web browser to see the new string: A better greeting.

You can configure the default update action in the run configuration settings: from the main menu, select Run | Edit Configurations. Change the On ‘Update’ action option under the Server tab of the GlassFish run configuration settings.

Configure application update actions in the GlassFish run configuration

With the On frame deactivation option, you can configure to update your resources and classes without redeploying and restarting the server whenever you change focus from IntelliJ IDEA. In this case, you won’t even have to use the Update Application action, just switch to your web browser and refresh the page.

Package the application into a WAR and deploy it on a running server

In the previous steps, we deployed the application using an exploded artifact, where all files are uncompressed. This is useful during the first stages of development, because it allows you to update individual resources and classes without redeploying. When you are happy with your application and ready to share it with others by deploying to a remote server, it is better to use the compressed web archive (WAR) format.

Let’s add a remote GlassFish run configuration to deploy the WAR artifact to a running server. This assumes that you did not terminate the GlassFish instance from the previous steps.

  1. From the main menu, select Run | Edit Configurations.

  2. In the Run/Debug Configurations dialog, click the Add button, expand the GlassFish Server node, and select Remote.

  3. Change the name of this run configuration to distinguish it, for example: Remote GlassFish 4.1.1.

  4. Open the Deployment tab, click the Add button above the table of artifacts to deploy, and select Artifact. Select to deploy the JavaEEHelloWorld:war artifact and click OK.

    Remote GlassFish run configuration artifacts to deploy

  5. Click OK to save the remote run configuration.

  6. Open index.jsp and change the greeting to Hello from WAR!.

  7. Select the new run configuration in the main toolbar and click The Run button or press Shift+F10.

    Remote GlassFish run configuration in the selector

The new configuration builds the WAR artifact and deploys it to the running server. Refresh the URL http://localhost:8080/JavaEEHelloWorld-1.0-SNAPSHOT/ and see the new greeting: Hello from WAR!

Package the application into an EAR

Proper enterprise applications are packaged into EAR files that can contain both WAR and JAR files. Let’s see how to do this in IntelliJ IDEA.

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

    Add Framework Support

  2. In the Add Framework Support dialog, select JavaEE Application under Java EE and click OK.

    IntelliJ IDEA adds the META-INF/application.xml file in your module. This is the deployment descriptor for your application.

  3. Press Ctrl+Alt+Shift+S to open the Project Structure dialog. On the Artifacts page, select the new JavaEEHelloWorld:ear exploded artifact and note that it contains only the javaEEApplication facet resource.

  4. Expand the Artifacts element under Available Elements and double-click JavaEEHelloWorld:war to add it to the EAR artifact structure.

    Add WAR to exploded EAR

    When you see a message that says Web facet isn’t registered in application.xml, click Fix.

  5. Click the Add button, select Java EE Application: Archive, then click For ‘JavaEEHelloWorld:ear exploded’.

    Add EAR artifact

  6. Select the new EAR artifact and click Create Manifest.

    Create manifest for EAR artifact

    Specify the default location under META-INF, next to application.xml.

  7. Open application.xml. It should contain the following:

    <?xml version=”1.0″ encoding=”UTF-8″?>
    <application xmlns=”http://xmlns.jcp.org/xml/ns/javaee”
    xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”
    xsi:schemaLocation=”http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/application_8.xsd”
    version=”8″>

    <module id=”JavaEEHelloWorld-Web”>
    <web>
    <web-uri>JavaEEHelloWorld.war</web-uri>
    <context-root>JavaEEHelloWorldWeb</context-root>
    </web>
    </module>
    </application>

Deploy the EAR artifact

Deploying the EAR artifact is similar to deploying the WAR: you need a remote GlassFish run configuration.

  1. From the main menu, select Run | Edit Configurations.

  2. In the Run/Debug Configurations dialog, click the Add button, expand the GlassFish Server node, and select Remote.

  3. Change the name of this run configuration to distinguish it, for example: Remote EAR GlassFish 6.2.5.

  4. Open the Deployment tab, click the Add button under the table of artifacts to deploy, and select Artifact. Select to deploy the JavaEEHelloWorld:ear artifact and click OK.

  5. Click OK to save the remote run configuration.

  6. Open index.jsp and change the greeting to Hello from EAR!.

  7. Select the new run configuration in the main toolbar and click The Run button or press Shift+F10.

The new configuration builds the EAR artifact and deploys it to the running server. Refresh the URL http://localhost:8080/JavaEEHelloWorldWeb/ and see the new greeting: Hello from EAR!. Note that the URL corresponds to the context-root specified in application.xml.

Troubleshooting

If you get a 404 error, make sure you have selected the Jakarta EE specification version that is compatible with your version of GlassFish when creating the project.

For more information, see the GlassFish version compatibility.

What next?

In this tutorial, we created and deployed a simple Java enterprise application. To extend this knowledge, you can create a RESTful web service as described in Tutorial: Your first RESTful web service.

Last modified: 20 February 2023