入门指南 on Jakarta® EE: 云原生Java的新家园

如何使用Jakarta EE构建RESTful Web服务

webdev@eclipse-foundation.org (Eclipse Foundation) — Fri, 22 Sep 2023 00:00:00 +0000

这篇博文将向您介绍如何使用 Jakarta EE创建一个 RESTful web service 应用程序.

使用 Jakarta EE, 创建的一个RESTful web 服务样例程序的需求如下:

我们将创建一个服务，该服务在 http://localhost:8080/restfulservice/hello 接收一个HTTP GET¹ 请求。
这个服务将返回请求一个带有JSON格式数据的响应，其内容如下：

{"text": "Hello from Jakarta EE"}

后续可以根据我们的需要进行定制和改进。

OK，已经明确了需求，您可以按照以下步骤开始编程。

建立开发环境

安装Java开发工具包(JDK). 要确定是 Java SE 8 或者更高版本 (本例使用Java SE 8进行开发,使用 Java SE 11 and Java SE 17进行测试). 您可以从Adoptium 选择需要的JDK版本。
安装支持Jakarta EE规范的应用服务器。可以从Jakarta EE官网下载兼容的产品.
安装 Maven 3 或更高版本

您可以使用SDKMan 安装以上所列的程序，可以按照指南的内容了解安装的操作步骤。

如何创建一个RESTful Web 服务工程

您可以使用Jakarta EE的Eclipse Starter完成工程创建，您也可以使用IDE，或者使用熟悉的 Maven archetypes选择一个ESTful的工程完成创建工作。

使用Jakarta EE的Eclipse Starter建立一个新的工程

按照以下步骤，使用Jakarta EE的Eclipse Starter完成工程创建：

使用Jakarta EE对RESTful Web服务进行认证保护

webdev@eclipse-foundation.org (Eclipse Foundation) — Fri, 29 Sep 2023 00:00:00 +0000

本指南向您展示如何使用Jakarta Authentication对RESTful服务进行访问认证。

在我们深入探讨如何对RESTful Web服务进行认证之前，让我们首先概述一下本篇文章中的使用场景。

我们构建一个RESTful Web 服务，该服务通过http://localhost:8080/jakartaee-hello-world/rest/hello的HTTP GET方法进行访问，正常情况下请求会得到如下响应：

{
  "hello": "world"
}

在本文中，我们将重点介绍对这个服务进行访问认证保护，这里只是个简单的样例，实际生产中需要进一步增强逻辑以满足更复杂的需求。

通过一个简单样例，我们可以更好地了解如何使用Jakarta EE对RESTful Web 服务进行认证保护所涉及的基本步骤。如果您对RESTful Web 服务还不了解，请阅读我之前的文章如何构建RESTful Web服务。

准备开发环境：

安装Java开发工具包（JDK）。请确保您拥有Java SE 11或更高版本（我们已使用Java SE 11和Java SE 17进行了测试）。您可以选择任何您喜欢的供应商发行版，也可以从Adoptium获取。
安装支持Jakarta EE的应用程序服务器。您可以下载任何与Jakarta EE兼容的产品。
安装Maven 3或更高版本。

我们可以使用SDKMan安装JDK和Maven，可以按照如何操作指南中提到的步骤进行操作。

如何完成本指南

在本入门指南中，您可以使用Jakarta EE的Eclipse Starter，完成每个步骤，或者跳过您已经知道的基本设置阶段。您还可以使用IDE选择熟悉的Maven原型进行工程构建。

使用Jakarta EE的Eclipse Starter创建新项目

要使用Jakarta EE的Eclipse Starter，我们需要采取以下步骤：

访问https://start.jakarta.ee。该服务将为应用程序设置所有必要的依赖项。当前版本的Starter仅支持Maven。不久会支持Gradle。
从可用选项中选择所需的Jakarta EE版本。目前，选项包括Jakarta EE 8、Jakarta EE 9.1和Jakarta EE 10。此外，您可以选择Jakarta EE Platform或某种Jakarta EE Profile（Web、Core）。
对于此项目，我们选择了Jakarta EE 10 Platform、Java SE 11和WildFly作为运行时。

如何使用Jakarta EE的Jakarta Persistence存储和检索数据

webdev@eclipse-foundation.org (Eclipse Foundation) — Fri, 22 Sep 2023 00:00:00 +0000

本指南向您展示如何使用Jakarta Persistence来存储和检索数据。

我们首先将简要介绍下我们想要构建的系统。接下来，我们将构建一个能够进行数据处理的RESTful web服务，使用Jakarta Persistence将其存储在数据库中，并作为REST端点提供服务。
对于不熟悉RESTful web服务的人，建议阅读我们的之前的文章。

我们将构建一个处理咖啡产品数据的应用程序。该服务将处理一条JSON数据（包含产品ID、名称和价格）。以下是JSON数据的示例：

{
  "id": 1,
  "name": "Coffee-A",
  "price": "2.75"
}

应用程序将存储数据，并提供一些REST端点，用来进行基本的CRUD（增/删/改/查）操作。然后，我们可以根据需要对其进一步定制和改进。

好的，现在我们已经明确了我们的要求，您需要按照以下步骤操作：

设置您的开发环境：

安装Java开发工具包（JDK）。请确保您安装了Java SE 11或更高版本（Java SE 11和Java SE 17我们都测试过）。您可以选择任何供应商的发行版，也可以从Adoptium获取。
安装支持Jakarta EE的应用服务器。下载任何Jakarta EE兼容的产品。
安装Maven 3或更高版本。

要安装JDK和Maven，我们可以使用SDKMan。我们可以按照安装指南中提到的步骤进行操作。

如何完成本指南

在这个入门指南中，您可能会使用Eclipse Starter for Jakarta EE完成每个步骤，也可以跳过您已经知道的基础设置。您也可以从IDE开始，或从知名的Maven原型中选择项目结构。

使用Eclipse Starter for Jakarta EE创建一个新项目

要使用Eclipse Starter for Jakarta EE，我们需要执行以下步骤：

导航至https://start.jakarta.ee。此服务将为应用程序设置所有必要的依赖项。当前版本的Starter仅支持Maven。将来，我们可能能够在Gradle和Maven之间进行选择。
从可用选项中选择所需的Jakarta EE版本。目前，选项包括Jakarta EE 8、Jakarta EE 9.1和Jakarta EE 10。
此外，您可以选择Jakarta EE Platform或Jakarta EE的Profile版本（Web、Core等）。
对于此项目，我们选择了Jakarta EE 10 Platform、Java SE 11和WildFly作为运行时。
选择了所需的选项后，点击生成按钮，将生成项目结构和示例代码，我们可以用以构建并运行。

探索代码结构

解压缩生成的代码，将得到一个应用程序的结构。可以在自己喜欢的IDE中打开，然后可以从命令行运行。

从使用 Jakarta EE 10 构建 Servlets开始

webdev@eclipse-foundation.org (Eclipse Foundation) — Fri, 22 Sep 2023 00:00:00 +0000

本指南旨在带您了解使用 Jakarta Servlet 构建一个简单的 Servlet 应用程序的过程。我们将首先概述我们的目标，然后逐步引导您设置环境、编写代码和部署 Servlet 应用程序。如果您是 Servlets 或 Jakarta EE 的新手，本指南应该是一个很好的起点。

我们将开发一个实现以下功能的应用程序：

提供一个表单，要求用户选择他们的咖啡偏好（例如，黑咖啡、拿铁、冷萃）。
将这些偏好存储在会话中。
动态生成一个“咖啡仪表板”，显示个性化的咖啡推荐。

好的，现在我们已经明确了我们的要求，您需要按照以下步骤操作：

设置开发环境：

安装 Java 开发工具包（JDK）。请确保您安装了 Java SE 11 或更高版本（我们已使用 Java SE 11 和 Java SE 17 进行测试）。您可以选择任何供应商的发行版，也可以选择 Adoptium。
安装支持 Jakarta EE 的应用服务器。下载任何 Jakarta EE 兼容的产品。
安装 Maven 3 或更高版本

安装 JDK 和 Maven，我们可以使用 SDKMan。我们可以按照如何操作指南中提到的步骤进行。

如何完成本指南

在这个入门指南中，您可以使用 Eclipse Starter for Jakarta EE，完成每个步骤，或者跳过您已经知道的基础知识阶段。您也可以从 IDE 开始，或从知名的 Maven 原型中选择一个项目结构。

使用 Eclipse Starter for Jakarta EE 创建一个新项目

要使用 Eclipse Starter for Jakarta EE，我们需要采取以下步骤：

入门指南 on Jakarta® EE: 云原生Java的新家园

如何使用Jakarta EE构建RESTful Web服务

建立开发环境

如何创建一个RESTful Web 服务 工程

使用Jakarta EE的Eclipse Starter建立一个新的工程

使用Jakarta EE对RESTful Web服务进行认证保护

准备开发环境：

如何完成本指南

使用Jakarta EE的Eclipse Starter创建新项目

如何使用Jakarta EE的Jakarta Persistence存储和检索数据

设置您的开发环境：

如何完成本指南

使用Eclipse Starter for Jakarta EE创建一个新项目

探索代码结构

从使用 Jakarta EE 10 构建 Servlets开始

设置开发环境：

如何完成本指南

使用 Eclipse Starter for Jakarta EE 创建一个新项目

如何创建一个RESTful Web 服务工程