# 教程：您的第一个 Jakarta EE 应用程序 > For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt). 本教程介绍了如何在 IntelliJ IDEA 中创建一个简单的 Jakarta Enterprise Edition (EE) Web 应用程序。 该应用程序将包括一个显示 `您好，世界！` 的JSP页面和一个链接到显示 `您好，世界！` 的Java servlet。 您将使用 Web 应用程序模板创建一个新的 Jakarta EE 项目，告诉 IntelliJ IDEA 您的应用服务器位于何处，然后使用运行配置来构建构件，启动服务器，并将构件部署到服务器上。 > **Note:** > 在没有 Ultimate 订阅的情况下， IntelliJ IDEA 中的 Jakarta EE 支持受限。 您将需要以下内容： | 相关插件 | 默认情况下， IntelliJ IDEA Ultimate 会捆绑并启用以下必需插件。 如果某些功能无法正常运行，请确保以下插件已启用： * Jakarta EE 平台 * Jakarta EE：应用服务器 * Jakarta EE：Web/Servlets * Tomcat 和 TomEE 按照 [插件](managing-plugins.html) 中的说明安装并启用 GlassFish 插件。 | | Java SE Development Kit (JDK) 版本 1.8 或更高版本 | 您可以按照 [Java Development Kit (JDK)](sdk.html#jdk) 中的说明直接从 IntelliJ IDEA 获取 JDK，或手动下载并安装，例如： [Oracle JDK](http://www.oracle.com/technetwork/java/javase/downloads/index.html) 或 [OpenJDK](https://openjdk.java.net/)。 | | Tomcat | [Tomcat](http://tomcat.apache.org/) 应用服务器版本 7 或更高版本。 > **Note:** > 本教程使用 JDK 21、Jakarta EE 11 和 Tomcat 11。 有关其他 Tomcat、Java 和 Jakarta EE 版本之间兼容性的更多信息，请参阅 [https://tomcat.apache.org/whichversion.html](https://tomcat.apache.org/whichversion.html)。 | | GlassFish | [GlassFish](https://projects.eclipse.org/projects/ee4j.glassfish) 应用服务器版本 4.0 或更高版本。 您可以从 [官方存储库](https://github.com/eclipse-ee4j/glassfish) 获取最新版本。 对于本教程而言， Web Profile 子集已足够。 > **Note:** > 本教程使用 Oracle OpenJDK 17、Jakarta EE 9.1 和 GlassFish 6.2.5。 有关其他 GlassFish、Java 和 Jakarta EE 版本之间兼容性的更多信息，请参阅 [https://github.com/eclipse-ee4j/glassfish#compatibility](https://github.com/eclipse-ee4j/glassfish#compatibility)。 | | Web 浏览器 | 您将需要一个 Web 浏览器来查看您的 Web 应用程序。 | Procedure: 使用向导创建新的 Jakarta EE 项目 IntelliJ IDEA 包含一个专用向导，用于基于各种 Jakarta EE 实现创建 Jakarta EE 项目。 在本教程中，我们将创建一个简单的 Web 应用程序。 1. 打开 新建项目 向导： * 如果位于主屏幕，请选择 `![加号](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.platform.icons.expui.general.add.svg) 新建 | ![文件夹图标](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.platform.icons.expui.nodes.folder.svg) 项目……` 。 * 如果已打开另一个项目，请转到 `文件 | 新建 | 项目` 。 2. 从左侧的 生成器 列表中，选择 ![Jakarta EE 徽标](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.java.ultimate.icons.icons.javaee.newui.jakartaEE.svg) Jakarta EE 。 ![Jakarta EE 项目向导的第一步](https://resources.jetbrains.com/help/img/idea/2026.3/jakarta_tutorial_step1_web.png) 3. 按如下方式设置项目设置: * 名称 ： `JakartaEEHelloWorld` * 位置 : 保持原样 * 创建 Git 仓库 : 保持原样 * 模板 : Web 应用程序 * 应用程序服务器 : <无应用程序服务器> * 语言 : Java * 构建系统 ：Maven * 组 : 保持原样 * 工件 : 保持原样 * JDK : Eclipse Temurin 17 准备就绪后，点击 下一步 。 4. 从 版本 下拉列表中，选择 Jakarta EE 11 ，因为本教程使用的 Tomcat 11 与其兼容。 Jakarta EE 9.1 ，因为本教程使用的 GlassFish 6.2.5 与其兼容。 由于在上一步中选择了 Web 应用程序模板， Servlet 已在 依赖项 列表中选中。 对于本教程，无需选择任何其他依赖项。 ![已选择 Jakarta 11 的 Jakarta EE 项目向导第二步](https://resources.jetbrains.com/help/img/idea/2026.3/jakarta_new_project_step_2_web_jakarta_11.png) ![已选择 Jakarta 9.1 的 Jakarta EE 项目向导第二步](https://resources.jetbrains.com/help/img/idea/2026.3/jakarta_new_project_step_2_web_jakarta_9_1.png) 5. 点击 创建 。 Procedure: 探索默认项目结构 IntelliJ IDEA 会创建一个包含一些样板代码的项目，您可以成功构建并部署。 * `pom.xml` 是包含 Maven 配置信息的 项目对象模型 ，其中包括构建项目所需的依赖项和插件。 ```XML 4.0.0 org.example JakartaEEHelloWorld 1.0-SNAPSHOT JakartaEEHelloWorld war UTF-8 21 21 5.11.0-M2 jakarta.servlet jakarta.servlet-api 6.1.0 provided org.junit.jupiter junit-jupiter-api ${junit.version} test org.junit.jupiter junit-jupiter-engine ${junit.version} test org.apache.maven.plugins maven-war-plugin 3.4.0 ``` ```XML 4.0.0 org.example JakartaEEHelloWorld 1.0-SNAPSHOT JakartaEEHelloWorld war UTF-8 11 11 5.9.2 jakarta.servlet jakarta.servlet-api 5.0.0 provided org.junit.jupiter junit-jupiter-api ${junit.version} test org.junit.jupiter junit-jupiter-engine ${junit.version} test org.apache.maven.plugins maven-war-plugin 3.3.2 ``` * `index.jsp` 是当您访问根目录 URL 时打开的应用程序起始页面。 它渲染了 `Hello World!` 并链接到 `/hello-servlet` 。 ```JSP <%@ page contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %> JSP - Hello World

<%= "Hello World!" %>

Hello Servlet ``` * `HelloServlet` 类扩展了 `HttpServlet` 并注解了 `@WebServlet` 。 它处理对 `/hello-servlet` 的请求：GET 请求返回呈现 `Hello World!` 的 HTML 代码。 ```JAVA 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(""); out.println("

" + message + "

"); out.println(""); } public void destroy() { } } ``` 使用 项目 工具窗口浏览并打开您项目中的文件，或按 `Ctrl+Shift+N` (Windows), `⌘ ⇧ O` (macOS), `⌘ ⇧ N` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ O` (macOS System Shortcuts), `Ctrl+Shift+N` (XWin), `Ctrl+Shift+N` (GNOME), `Ctrl+Shift+N` (KDE), `Ctrl+X, Ctrl+F` (Emacs), `Ctrl+P` (Sublime Text), `⌘ P` (Sublime Text (macOS)), `Ctrl+Shift+T` (Visual Studio), `⌘ ⇧ T` (Visual Studio (macOS)), `Alt+Shift+O` (NetBeans), `Ctrl+Shift+R` (Eclipse), `⌘ ⇧ R` (Eclipse (macOS))，然后输入文件名。 Procedure: 配置应用服务器 让 IntelliJ IDEA 知道 GlassFish Tomcat 应用服务器的位置。 1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择 `构建、执行、部署 | 应用服务器` 。 2. 点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 并选择 GlassFish 服务器 Tomcat 。 3. 指定 GlassFish Tomcat 服务器安装位置的路径。 IntelliJ IDEA 会适当地检测并设置名称和版本。 ![GlassFish 应用服务器配置](https://resources.jetbrains.com/help/img/idea/2026.3/rest_ws_glassfish_configure.png) ![Tomcat 应用服务器配置](https://resources.jetbrains.com/help/img/idea/2026.3/rest_ws_tomcat_11_configure.png) Procedure: 创建运行配置 IntelliJ IDEA 需要一个运行配置来构建工件并将其部署到您的应用服务器。 1. 在主菜单中，转到 `运行 | 编辑配置` 。 2. 在 运行/调试配置 对话框中，点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，展开 GlassFish 服务器 Tomcat 服务器 节点，并选择 本地 。 3. 修复出现在运行配置设置对话框底部的任何警告。 ![运行配置警告](https://resources.jetbrains.com/help/img/idea/2026.3/rest_ws_glassfish_run_config_warning.png) 很可能，您需要修复以下问题： * 在 服务器 选项卡上，将 服务器域名 设置为 `domain1` 。 * 在 部署 选项卡上，添加您想要部署的 artifact： `JakartaEEHelloWorld:war exploded` 4. 在 服务器 选项卡上，将 URL 设置为指向 [根资源](#source_code)： ``` http://localhost:8080/JakartaEEHelloWorld_war_exploded/ ``` ``` http://localhost:8080/JakartaEEHelloWorld-1.0-SNAPSHOT/ ``` ![GlassFish 运行配置已完成](https://resources.jetbrains.com/help/img/idea/2026.3/first_javaee_glassfish_run_config_url.png) ![Tomcat 运行配置已完成](https://resources.jetbrains.com/help/img/idea/2026.3/first_javaee_tomcat_11_run_config_url.png) 5. 点击 OK 以保存运行配置。 6. 要运行配置，请按 `Alt+Shift+F10` (Windows), `⌃ ⌥ R` (macOS), `⌥ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ R` (macOS System Shortcuts), `Alt+Shift+F10` (XWin), `Alt+Shift+F10` (GNOME), `Alt+Shift+F10` (KDE), `Alt+Shift+F10` (Emacs), `Alt+Shift+F10` (Sublime Text), `⌃ ⌥ R` (Sublime Text (macOS)), `Ctrl+Alt+Shift+R` (Visual Studio), `⌘ ⌥ ⇧ R` (Visual Studio (macOS)), `Alt+Shift+F10` (NetBeans), `Alt+Shift+F10` (Eclipse), `⌃ ⌥ R` (Eclipse (macOS)) 并选择创建的应用服务器配置。 或者，如果您已在顶部的主工具栏中选择了运行配置，您可以在主工具栏中点击 ![运行图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg)，或按 `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS)) 来运行它。 此运行配置会构建构件，然后启动 GlassFish Tomcat 服务器，并将构件部署到服务器。 您应该会在 服务 工具窗口中看到相应的输出。 ![已在"服务"工具窗口中启动 GlassFish 服务器并部署应用程序](https://resources.jetbrains.com/help/img/idea/2026.3/first_javaee_glassfish_run_tool_window.png) ![已在"服务"工具窗口中启动 GlassFish 服务器并部署应用程序](https://resources.jetbrains.com/help/img/idea/2026.3/first_javaee_tomcat_run_tool_window.png) 完成后，IntelliJ IDEA 会在您的 Web 浏览器中打开指定的 URL。 ![在 Web 浏览器中显示的已部署应用程序输出](https://resources.jetbrains.com/help/img/idea/2026.3/javaee_all_web_browser_output.png) 如果没有，请尝试自行打开 URL： [http://localhost:8080/JakartaEEHelloWorld_war_exploded/](http://localhost:8080/JakartaEEHelloWorld_war_exploded/) [http://localhost:8080/JavaEEHelloWorld-1.0-SNAPSHOT/](http://localhost:8080/JavaEEHelloWorld-1.0-SNAPSHOT/) Procedure: 修改应用程序 每当您更改应用程序的源代码时，您可以重新启动运行配置以查看更改。 但这并不是总是必要的，特别是当您无法重新启动服务器时。 大多数更改都很小，无需重新构建构件、重新启动服务器等。 让我们更改应用程序的 JSP 页面。 1. 打开 `index.jsp` 并将问候语从 `Hello World` 更改为 `更好的问候` 。 2. 在 服务 工具窗口中，点击 ![更新应用程序按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.javaee.updateRunningApplication.svg)或按 `Ctrl+F10` (Windows), `⌘ F10` (macOS), `⌘ F10` (IntelliJ IDEA Classic (macOS)), `⌘ F10` (macOS System Shortcuts), `Ctrl+F10` (XWin), `Ctrl+F10` (GNOME), `Ctrl+F10` (KDE), `Ctrl+F10` (Emacs), `Ctrl+F10` (Sublime Text), `⌘ F10` (Sublime Text (macOS)), `Ctrl+F10` (Visual Studio), `⌘ F10` (Visual Studio (macOS)), `Ctrl+F10` (NetBeans), `Ctrl+F10` (Eclipse), `⌘ F10` (Eclipse (macOS))。 3. 在 更新 对话框中，选择 更新资源 ，因为 JSP 页是静态资源。 点击 OK 。 4. 请在您的网络浏览器中刷新应用程序 URL 以查看新字符串： `更好的问候。` 您可以在运行配置设置中配置默认更新操作：在主菜单中转到 `运行 | 编辑配置` 。 在 服务器 选项卡下更改 执行“更新”操作时 选项的 GlassFish Tomcat 运行配置设置。 ![在 GlassFish 运行配置中配置应用更新操作](https://resources.jetbrains.com/help/img/idea/2026.3/java_ee_glassfish_run_config_update_actions.png) ![在 GlassFish 运行配置中配置应用更新操作](https://resources.jetbrains.com/help/img/idea/2026.3/java_ee_tomcat_11_run_config_update_actions.png) 使用 框架停用时 选项，当您从 IntelliJ IDEA 切换焦点时，您可以配置更新资源和类，而无需重新部署和重新启动服务器。 在这种情况下，您甚至不需要使用 更新应用程序 操作，只需切换到您的网页浏览器并刷新页面。 Procedure: 将应用程序打包成 WAR 并部署在运行中的服务器上 在先前的步骤中，我们使用解压缩的构件部署了应用程序，所有文件都是未压缩的。 这在开发的初始阶段非常有用，因为它允许您在不重新部署的情况下更新各个资源和类。 当您对自己的应用程序满意并准备通过部署到远程服务器与他人共享时，最好使用压缩的 web archive (WAR) 格式。 让我们添加一个 远程 GlassFish 远程 Tomcat 运行配置，以将 WAR artifact 部署到正在运行的服务器。 这假设您没有终止之前步骤中正在运行的服务器。 1. 在主菜单中，前往 `运行 | 编辑配置` 。 2. 在 运行/调试配置 对话框中，点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，展开 Glassfish 服务器 Tomcat 节点，并选择 远程 。 3. 将此运行配置的名称更改为区别开来，例如： `远程 GlassFish 6.2.5` `远程 Tomcat 10.1.5` 。 4. 打开 部署 选项卡，点击表格上方的 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)以部署，并选择 工件 。 选择 `JakartaEEHelloWorld:war` 工件并点击 OK 。 ![远程 GlassFish 运行配置工件部署](https://resources.jetbrains.com/help/img/idea/2026.3/java_ee_glassfish_remote_deployment.png) ![远程 Tomcat 运行配置工件部署](https://resources.jetbrains.com/help/img/idea/2026.3/java_ee_tomcat_remote_deployment.png) 5. 点击 OK 保存远程运行配置。 6. 打开 `index.jsp` 并将问候语更改为 `来自 WAR 的问候！` 。 7. 在主工具栏中选择新的运行配置，然后点击 ![运行图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg)或按 `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS))。 ![选择器中的远程 GlassFish 运行配置](https://resources.jetbrains.com/help/img/idea/2026.3/java_ee_glassfish_remote_config_selector.png) ![选择器中的远程 GlassFish 运行配置](https://resources.jetbrains.com/help/img/idea/2026.3/java_ee_tomcat_remote_config_selector.png) 新的配置构建 WAR 工件并将其部署到运行中的服务器。 刷新 URL 查看新的问候语： `来自 WAR 的问候！` ## 故障排除 ### 与 Jakarta EE 的兼容性 如果您得到一个 `404` 错误，请确保在 [创建项目](#create-new-project) 时，选择了与您的 GlassFish 版本兼容的 Jakarta EE 规范版本。 有关详细信息，请参阅 [GlassFish 版本兼容性](https://github.com/eclipse-ee4j/glassfish#compatibility)。 ### 无法连接到 Tomcat 如果您在尝试将应用程序部署到远程 Tomcat 服务器时看到类似 `无法连接到 localhost:1099` 的错误消息，请尝试以下步骤： * 请确保 Tomcat 服务器正在运行。 例如，启动 [上面描述的](#run_config)本地 Tomcat 运行配置。 * 在配置 JMX 身份验证或（如果不是生产环境）禁用它之前，运行服务器时，请传递 `-Dcom.sun.management.jmxremote.authenticate=false` VM 选项，然后部署应用程序。 ### 较早的 IntelliJ IDEA 版本 如果您使用的是 IntelliJ IDEA 版本 2020.2.2 或更早版本， 新建项目 向导将不会添加 Tomcat 所需的所有必要依赖项。 在这种情况下，打开 `pom.xml` 并添加以下依赖项： ```XML org.glassfish.jersey.media jersey-media-json-jackson 2.31 org.glassfish.jersey.inject jersey-hk2 2.31 ``` 例如，在 2020.2.3 版本中，生成的 `pom.xml` 如下所示： ```XML 4.0.0 com.example RestTomcatHelloWorld 1.0-SNAPSHOT RestTomcatHelloWorld war 1.8 1.8 5.6.2 javax.ws.rs javax.ws.rs-api 2.1.1 provided org.glassfish.jersey.containers jersey-container-servlet 2.31 org.glassfish.jersey.media jersey-media-json-jackson 2.31 org.glassfish.jersey.inject jersey-hk2 2.31 org.glassfish.jersey.core jersey-client 2.31 org.junit.jupiter junit-jupiter-api ${junit.version} test org.junit.jupiter junit-jupiter-engine ${junit.version} test org.apache.maven.plugins maven-war-plugin 3.3.0 ``` ## 接下来做什么？ 在本教程中，您将创建并部署一个简单的 Jakarta EE 应用程序。 为了扩展这些知识，您可以按照 [教程：您的第一个 RESTful web service](creating-and-running-your-first-restful-web-service.html) 所述创建一个 RESTful web service。