最终的

教程：您的第一个 RESTful Web 服务

创建一个新的 Java 企业项目

IntelliJ IDEA 包含一个专用向导，用于创建基于各种 Java EE 和 Jakarta EE 实现的 Java Enterprise 项目。在本教程中，我们将创建一个简单的 Web 应用程序。

1. 转到文件| 新 | 项目。

2. 在“新建项目”对话框中，选择Jakarta EE。

   

   输入您的项目的名称：RestGlassfishHelloWorld。对于本教程，使用 Oracle OpenJDK 17 作为项目SDK并选择REST 服务模板。不要选择或添加应用程序服务器，我们稍后会做。选择Java和Maven。单击“下一步”继续。

3. 在“版本”字段中，选择Jakarta EE 9.1，因为本教程中使用的 GlassFish 6.2.5 与该版本兼容。

   提示

   对于 GlassFish 5，选择Java EE 8规范。对于 GlassFish 7，选择Jakarta EE 10。

   在依赖项列表中，选择以下项：

   • 上下文和依赖注入 (CDI)

   • RESTful Web 服务 (JAX-RS)

   • 服务程序

   

   单击创建。

探索默认项目结构

IntelliJ IDEA 使用一些样板代码创建一个项目，您可以成功构建和部署该项目。

提示

使用“项目”工具窗口浏览并打开项目中的文件，或按并键入文件名。CtrlShift0N

• pom.xml是包含 Maven 配置信息的项目对象模型，包括构建项目所需的依赖项和插件。

  pom.xml
  {...}

• HelloResource.java是一个根资源类，它使用以下 JAX-RS 注释来实现 RESTful Web 服务：

  • 该@Path注释标识用于访问该资源（相对于应用程序根）的 URI。

  • 该@GET注释指示该hello()方法将处理对指定 URI 的 HTTP GET 请求。

  • 该@Produces注释指定该方法生成和返回的 MIME 媒体类型。

  src/main/java/com/example/RestGlassfishHelloWorld/HelloResource.java
  {...}

• HelloApplication.java是 的子类javax.ws.rs.core.Application，用于配置应用程序运行资源类中定义的 REST 资源的环境。该@ApplicationPath注释标识应用程序根的 URL 映射（默认情况下，它设置为/api）。

  src/main/java/com/example/RestGlassfishHelloWorld/HelloApplication.java
  {...}

配置应用服务器

让 IntelliJ IDEA 知道GlassFish应用程序服务器所在的位置。

1. 按打开 IDE 设置，然后选择“构建”、“执行”、“部署”| 应用服务器。CtrlAlt0S

2. 单击并选择Glassfish 服务器。

3. 指定GlassFish服务器安装位置的路径。IntelliJ IDEA 会适当检测并设置名称和版本。

   

创建运行配置

IntelliJ IDEA 需要一个运行配置来构建工件并将其部署到您的应用程序服务器。

1. 转到“运行”| 编辑配置。

2. 在“运行/调试配置”对话框中，单击，展开Glassfish Server节点，然后选择“本地”。

3. 修复运行配置设置对话框底部出现的任何警告。

   

   最有可能的是，您需要修复以下问题：

   • 在服务器选项卡上，将服务器域设置为domain1。

   • 在“部署”选项卡上，添加要部署的工件：RestGlassfishHelloWorld:war exploded

4. 在“服务器”选项卡上，将 URL 设置为指向根资源：

   http://localhost:8080/RestGlassfishHelloWorld-1.0-SNAPSHOT/api/hello-world

   

5. 单击“确定”保存运行配置。

6. 要运行配置，请按并选择创建的应用程序服务器配置。AltShiftF10

   或者，如果您在顶部的主工具栏中选择了运行配置，则可以按运行它。ShiftF10

此运行配置构建工件，然后启动GlassFish服务器，并将工件部署到服务器。您应该在“运行”工具窗口中看到相应的输出。

完成此操作后，IntelliJ IDEA 将在您的 Web 浏览器中打开指定的 URL。

如果没有，请尝试自己打开 URL：http://localhost:8080/RestGlassfishHelloWorld-1.0-SNAPSHOT/api/hello-world