Home 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 12

webdev@eclipse-foundation.org (Eclipse Foundation) — Thu, 26 Feb 2026 00:00:00 +0000

Jakarta EE 12 focuses on robust and flexible enterprise Java, supporting reliable applications while enabling modularity, interoperability, and architectural choice.

This page will be updated regularly to reflect new proposals, milestones, and specification work as they become available.

Updated

Not Updated

New

* Candidate for inclusion.

Change Log

webdev@eclipse-foundation.org (Eclipse Foundation) — Fri, 12 Apr 2024 00:00:00 +0000

Batch 2.1 Change Log

成为赞助商 | Jakarta EE

webdev@eclipse-foundation.org (Eclipse Foundation) — Wed, 03 Apr 2024 00:00:00 +0000

成为 Jakarta EE 工作组的赞助商，

推动未来企业级Java的发展

您的组织将在塑造开源企业级Java的未来以及确保全球Java社区持续增长和成功方面发挥关键作用。

加入我们的赞助计划：

您的
支持

将帮助我们维护和扩展我们的计划。

您的
贡献

将确保 Jakarta EE 社区继续成为世界各地开发者、企业和技术爱好者充满活力和创新的平台。

您的
参与

将支持一系列旨在推广 Jakarta EE 的计划，包括营销和促销活动、活动、内容创作、社区赠品等。

从使用 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，我们需要采取以下步骤：

Change Log

webdev@eclipse-foundation.org (Eclipse Foundation) — Thu, 11 May 2023 00:00:00 +0000

Release for Jakarta EE 10

Change Log

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

Release for Jakarta EE 10

Change Log

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

Release for Jakarta EE 10

Change Log

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

Release for Jakarta EE 10

Change Log

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

Release for Jakarta EE 10

Change Log

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

Release for Jakarta EE 10

Change Log

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

Release for Jakarta EE 10

为何选择 Jakarta EE?

webdev@eclipse-foundation.org (Eclipse Foundation) — Thu, 20 Oct 2022 14:49:08 -0400

JAKARTA EE 是标准

Jakarta EE是一套企业Java应用程序开发的规范标准，其稳定性、可移植性和向后兼容性使其得到了广泛的理解和采纳。

Jakarta EE 规范过程

webdev@eclipse-foundation.org (Eclipse Foundation) — Wed, 31 Aug 2022 13:00:00 -0400

Jakarta EE 规范过程 (JESP) 适用于由 Jakarta EE 工作组 运营的 规范项目 的 规范过程 。

Jakarta EE 规范委员会 特此采纳 Eclipse Foundation Specification Process v1.3 (EFSP) 作为 Jakarta EE 规范过程，并作出如下修改:

对 Jakarta EE 规范过程 的任何修改或者修订, 包括新版 EFSP 的采纳, 以及 EFSP 中规定的任何其他投票要求，必须经 规范委员会 绝对多数 成员的批准, 以及 绝对多数 的 Jakarta EE 战略成员 的批准.
所有规范委员会批准投票期间的最短持续时间如下所述（尽管EFSP规定了例外程序，但这些期限不得缩短）
a. 创造物（Creation）审查: 7 个自然日;
b. 计划（Plan）审查: 7 个自然日;
c. 进度（Progress）审查: 14 个自然日;
d. 发布（Release）审查: 14 个自然日;
e. 服务发布（Service Release）审查: 14 个自然日; 以及
f. JESP 更新: 7 个自然日.

Change Log

webdev@eclipse-foundation.org (Eclipse Foundation) — Wed, 15 Jun 2022 00:00:00 +0000

Release for Jakarta EE 9

帮助我们一起塑造云原生Java的未来

webdev@eclipse-foundation.org (Eclipse Foundation) — Fri, 04 Mar 2022 09:00:00 -0400

加入 Jakarta EE

想要参与 Jakarta EE 项目或者相关倡议, 从建立一个 Eclipse Foundation 账号开始。

然后你就可以选择如下的任何方式参与进来：

加入讨论

加入我们的社区频道，以便了解最新的社区倡议，并根据自己的情况选择参与。

通过社交媒体加入

如何提交贡献

选择一个你感兴趣的 Jakarta EE 项目, 加入项目的邮件列表与项目团队沟通。

在提交贡献之前，确保相关的准备工作已经就绪：作为个人，请登陆你的Eclipse Foundation 账号，并签署 Eclipse 贡献者协议（ECA），这样你就可以与项目团队协作，并提交你的贡献。访问 Eclipse 贡献者协议（ECA）页面以获得更多信息。如果你所在的机构已经是 Jakarta EE 工作组的成员, 你所在的机构会有一个成员单位提交与贡献协议覆盖了所有做出贡献的员工，这将大大简化您的工作!

登陆 Eclipse Foundation 账号

成为提交者

Jakarta EE 贡献者有资格成为提交者。可以通过以下几种方式成为提交者：1）对于现有的 Jakarta EE 项目，通过选举实现！在您做出了表明您了解开源项目工作原理的贡献之后，该项目的当前提交人将发起一次选举。现任委员必须在选举中投票；因此，创建一个高质量贡献的公共记录以便提交者（和社区）可以审查，是整个过程中最重要的部分。2）另一种选择是通过做出初步贡献，成为新的 Jakarta EE 规范项目的提交人。项目的相应项目管理委员会（PMC）提名一组初始提交人，供执行董事（或其代表）批准

Change Log

webdev@eclipse-foundation.org (Eclipse Foundation) — Fri, 26 Mar 2021 00:00:00 +0000

Release for Jakarta EE 9

Change Log

webdev@eclipse-foundation.org (Eclipse Foundation) — Sun, 21 Mar 2021 00:00:00 +0000

Release for Jakarta EE 9

Change Log

webdev@eclipse-foundation.org (Eclipse Foundation) — Sun, 21 Mar 2021 00:00:00 +0000

Release for Jakarta EE 9

Change Log

webdev@eclipse-foundation.org (Eclipse Foundation) — Sun, 21 Mar 2021 00:00:00 +0000

Release for Jakarta EE 9

Change Log

webdev@eclipse-foundation.org (Eclipse Foundation) — Sun, 21 Mar 2021 00:00:00 +0000

Release for Jakarta EE 9

Change Log

webdev@eclipse-foundation.org (Eclipse Foundation) — Wed, 17 Mar 2021 00:00:00 +0000

Release for Jakarta EE 9

Jakarta EE 规范过程指引

webdev@eclipse-foundation.org (Eclipse Foundation) — Thu, 04 Mar 2021 00:00:00 +0000

内容

介绍

本指南是一份循序渐进的实用指南，旨在帮助Jakarta EE规范项目的开发人员了解Jakarta EE规范过程的各个步骤(JESP).
本指南旨在提供一份有用的工具，所以 如有任何疑问，请直接移步 JESP 了解完整内容
如果您对 Jakarta EE 规范的开发有任何疑问或意见，不要犹豫，请直接联系 Specification Committee
JESP 遵循 Eclipse 规范过程 (EFSP).

创建评论

Jakarta 规范项目的创建方式与 Eclipse Development Process (EDP) 的其他项目一致.
Jakarta 规范项目必须经由规范委员会许可.
点击此处了解如何在 EFSP 中创建评论.

计划评审

在对新规范的主版本或副版本进行大规模开发工作之前，每个规范项目都需要进行计划评审.
服务版本不需要进行计划评审.
了解EFSP中关于计划评审的更多内容.

版本评审

JUG的"Adopt a Spec"程序

webdev@eclipse-foundation.org (Eclipse Foundation) — Sat, 01 Feb 2020 16:09:45 -0400

本程序旨在通过采纳 Jakarta EE 规范 来鼓励JUG领导者和成员的参与。其目标是为了增加 Jakarta EE 规范 演进过程中开发者群体的参与。

Adopters

JUG领导者可以提供的帮助:

确保对所采用的 Jakarta EE 规范 的主题进行一致的讨论，例如，将现有的JUG会议的一部分用于与所采用规范相关的讨论，安排每月与各小组中运行本程序的JUG代表进行电话联系。

JUG成员如何参与:

参与规范开发(包括API，规范文档，TCK，实现)
撰写关于规范的博客并发表在 JakartaBlogs
在社交媒体（如Twitter）上推广规范
编写一个完整的端到端的web应用测试 (就像 Jakarta EE Pet Store 一样 )
阅读规范文档并对意义含混的部分进行评论
在现有的基础上编写更多的测试：
- Jakarta EE GitHub 的所有库: https://github.com/jakartaee
- 示例 1 - Jakarta Servlet: https://github.com/jakartaee/servlet
- 示例 2 - Jakarta Messaging: https://github.com/jakartaee/messaging

我们可以为JUG提供:

在JUG所采纳的规范页面上列出JUG的名称，以表示对其组织的推广和认可
允许JUG拥有举办本地区 JakartaOne Livestream 活动的优先权，并提供框架和工具
支持JUG举办 Jakarta EE 发布会（例如，每年为一个 Jakarta EE 发布会提供一次 Jakarta EE 演讲材料和素材）
在EclipseCon的“创新平台”促进“Adopt a Spec”活动
在EclipseCon和其他的活动中安排“与专家面对面”等类似的非正式聚会和讲座
提供Jakarta EE Livestream实时编码环节的参与机会。
提供参与相关会议的机会，与 Jakarta EE 委员会以及相关专家讨论 Jakarta EE 相关话题。

如何注册:

如果有意注册本程序，请准备好提供如下信息：准备采纳的规范名称，JUG的网站链接和LOGO。此处列明了创建 Jakarta EE pull request 的一些步骤。

Oracle/JCP 缩略语指南

webdev@eclipse-foundation.org (Eclipse Foundation) — Wed, 26 Jun 2019 16:10:38 -0400

Guidelines for the use of existing Oracle/JCP Acronyms. Supplement to the Eclipse Foundation Eclipse徽标和商标政策指南

Version 1.0 - June 26, 2019

相关指南的目标是避免混淆，并确保开发人员社区可以轻松地识别 Jakarta EE 项目、规范、测试套件或其他相关项是来自Oracle/JCP还是来自 Eclipse/Jakarta EE 过程。

Oracle/JCP缩略语列表显示在本文档的底部。

对于 Jakarta EE 项目、规范、测试套件和其他相关材料的名称，完整项目名称/标题和任何范围声明不应包含已标识的缩略词。

正确示例: “Jakarta Message Service Specification”
错误示例: “JMS Specification”
错误示例: “Jakarta Message Service (JMS) Specification”

Jakarta EE 项目当前的 短名称（或ID）有时来自Oracle/JCP缩略语（例如jaxrs api、jaf和jpa api）。对于为这些项目创建的存储库，在以下GitHub组织名称中使用这些项目的当前短名称仍然是可以接受的：

eclipse (e.g. github.com/eclipse/[current_short_names])
eclipse-ee4j
jakartaee
eclipse-jakartaee

对于在Eclipse Foundation创建的项目，可以继续接受使用以下格式的URL中这些项目的当前ID和短名称：

eclipse.org/projects/[current id]
projects.eclipse.org/projects/[current short name]

为了获得最大的灵活性和清晰性，我们鼓励项目更改其短名称，以更接近新规范名称（如果适用），并尽可能避免使用Oracle/JCP缩略词。

如果规范文档（或相关材料）中包含对Oracle/JCP首字母缩略词的引用，则应包括类似如下的语句：“除非另有说明，否则本文档中对JMS的引用指的是Jakarta 消息服务。”该句子的大小必须清晰易读，并应出现在规范文档（或相关文件）的开头段落，而非一个难以辨认的小脚注。读者不应该通过滚动、翻页或单击链接来访问该语句。

可以在某个Eclipse或Jakarta来源字符串的右侧标识URL、存储库名称、包名称、类名或方法名称等相关缩略语。

正确示例: github.com/eclipse-ee4j/jms
正确示例: eclipse.org/projects/ee4j.jms
正确示例: jakarta.jms.JMSContext

项目的电子邮件地址可以在@符号左侧标识缩略语。

邮件列表

webdev@eclipse-foundation.org (Eclipse Foundation) — Sun, 03 Mar 2019 10:00:00 -0400

Jakarta EE Community	The list is used for updates & connecting with everyone in the ecosystem
Jakarta EE Working Group	The list is used for discussions on topics relevant to Jakarta EE Working Group Members; tackling tasks & working with each other
Jakarta EE Platform	The list is used for technical discussions on topics related to a platform for hosting Jakarta EE Applications
Jakarta EE Technology Compatibility Kits	The list is used for technical discussions on Jakarta EE Technology Compatibility Kits
Jakarta EE Specifications	The list is used for discussions on evolution of Jakarta EE specifications
JakartaEE Spec Project Leadership discussions	JakartaEE Spec Project Leadership discussions
Jakarta EE Marketing	This list is used for discussions on marketing, collateral, branding, devrel, jakartaone and activities related to enhancing the Jakarta EE brand with community collaboration.
Jakarta EE Examples	The list is used for discussions on documentation, samples, tutorials of APIs
Jakarta Activation	The list is used for technical discussions related to standardizing services for MIME type data Access
Jakarta Annotations	The list is used for technical discussions related to declarative style annotations for common semantic concepts
Jakarta Authentication	The list is used for technical discussions related to low-level container SPI for authentication mechanisms
Jakarta Authorization	The list is used for technical discussions related to low-level SPI for authorization modules, which are repositories of permissions
Jakarta Batch	The list is used for technical discussions related to API plus an XML-based batch job specification language
Jakarta Bean Validation	The list is used for technical discussions related to object-level constraint declaration and validation facility.
Jakarta Concurrency	The list is used for technical discussions related to API for application-level concurrency that integrates with the container
Jakarta Config	Jakarta Config project developer discussions
Jakarta Connectors	The list is used for technical discussions related to the architecture connecting applications to enterprise info systems
Jakarta Context and Dependency Injection	The list is used for technical discussions related to declarative dependency injection and supportive services
Jakarta Data	The list is used for technical discussions related to data repoisitories
Jakarta Enterprise Beans	The list is used for technical discussions related to deployment APIs for assembled Jakarta EE applications
Jakarta Expression Language	The list is used for technical discussions related to expression language for Java applications
Jakarta Interceptors	The list is used for technical discussions related to defining means of interposing on business methods
Jakarta JSON Binding	The list is used for technical discussions related to binding framework for converting POJO to/from JSON docs
Jakarta JSON Processing	The list is used for technical discussions related to parsing, generating, transforming and query JSON docs
Jakarta Mail	The list is used for technical discussions related to a framework to build mail and messaging applications
Jakarta Messaging	The list is used for technical discussions related to Jakarta Messaging. Messaging via loosely coupled reliable async services
Jakarta MVC	The list is used for technical discussions related to standardizing the action-based model-view-controller pattern
Jakarta NoSQL	The list is used for technical discussions related to creating applications with NoSQL databases
Jakarta Persistence	The list is used for technical discussions related to management of persistence and object / relational mapping
Jakarta RESTful Web Services	The list is used for technical discussions related to development of web services following the REST pattern
Jakarta Security	The list is used for technical discussions related to standards for creating secure Jakarta EE applications
Jakarta Server Faces	The list is used for technical discussions related to Jakarta Server Faces used for building user interfaces for web apps
Jakarta Server Pages	The list is used for technical discussions related to defining templates engine for web applications
Jakarta Servlet	The list is used for technical discussions related to Jakarta Servlets; handles HTTP requests and responses
Jakarta Standard Tag Library	The list is used for technical discussions related to tags to simplify the JSP development
Jakarta Transactions	The list is used for technical discussions related to handling transactions consistent with X/Open XA-Specs
Jakarta Websocket	The list is used for technical discussions related to API for Server and Client endpoints for Websocket protocol
Jakarta XML Web Services	The list is used for technical discussions related to means for XML-based Web Services based on SOAP

成员单位

webdev@eclipse-foundation.org (Eclipse Foundation) — Thu, 28 Feb 2019 16:09:45 -0400

Jakarta EE 简讯存档

webdev@eclipse-foundation.org (Eclipse Foundation) — Mon, 04 Jun 2018 10:00:58 -0400

Jakarta EE Newsletters Archives

2020

2019

2018

常见问题解答

webdev@eclipse-foundation.org (Eclipse Foundation) — Sat, 07 Apr 2018 16:09:45 -0400

常见问题解答

什么是Jakarta EE？

Jakarta EE是云原生、轻量级和传统的企业级Java应用程序的未来

新的Jakarta EE平台由Java EE技术创建，该技术由甲骨文公司捐献
Eclipse基金会是云原生Java开放创新的大本营
Jakarta EE 工作组致力于实现Java EE技术和治理过程的现代化，使其变得更加开放，更植根于社区

“Jakarta EE”这个名称有哪些特殊寓意？因何得名？

在Java的早期阶段，Apache Jakarta 项目为Java生态系统贡献了许多令人激动的创新。它对于在Java平台内部和周围建立一个强大的开源社区方面发挥了特别重要的作用。根据维基百科的说法，这一名称是根据当时讨论创建这个项目时所在的Sun Microsystems公司的会议室名称命名的。

在2018年2月，社区曾为Java EE新命名发起投票。将近7000名社区成员进行了投票，并有超过64%的成员投给了Jakarta EE。从Java EE 到Jakarta EE这篇文章，也解释了称谓变化背后所隐含的历史。在 Jakarta 项目于2011退役后，Apache软件基金会友好地允许 Eclipse Foundation 重新启用这一名称。

Jakarta EE平台都涵盖了哪些方面？

首先，Jakarta EE完全兼容于Java EE 8平台。所有Java EE 8的组成部分，包括相关规范、参考实现（RI）和技术兼容套件（TCKs）都已转移到 Eclipse Foundation

Jakarta EE 商标指引

webdev@eclipse-foundation.org (Eclipse Foundation) — Thu, 05 Apr 2018 16:10:38 -0400

Version 1.2 - March 12, 2020

本文档是对 Eclipse Foundation 《Eclipse 徽标和商标政策指南》的补充。(本补充文档与 Eclipse Foundation 的《 Eclipse 徽标和商标指南》一起统称为“政策”) 以处理 Jakarta EE 徽标（如后文所定义的）可被允许的相关使用。The Jakarta EE 包括但不限于, 下列的名称或/及标志: Jakarta EE, Jakarta EE 工作组, Jakarta EE 成员以及 Jakarta EE 兼容性, (统称 “Jakarta EE 徽标”)。 Jakarta EE 品牌使用手册定义了 Jakarta EE 徽标用法的完整指南。对 Jakarta EE 徽标的使用必须始终符合本政策。

Jakarta EE 徽标的使用受到如下限制 (需要具备相关资格要求):

“Jakarta EE 兼容性”标志仅限于与“兼容软件产品”一起使用。“兼容软件产品”是指根据当时的TCK流程，通过使用 技术兼容套件 （“TCK”）认证为 Jakarta EE Profiles 兼容实现 的任何产品，相关术语在当时的 Jakarta EE 规范过程 中定义。
“Jakarta EE 兼容性”标记的使用仅限于与以下公司发行的兼容软件产品（定义见下文）结合使用：
1. Jakarta EE 工作组的参与成员/企业成员/战略成员，同时也是Jakarta EE 兼容性商标许可协议的被许可方; 以及
2. Jakarta EE 工作组的访客（Guest）成员, 满足以下条件:
  - Jakarta EE 兼容标志的使用得到 Jakarta EE 工作组指导委员会的一致批准；且
  - 此类访客成员也是 Eclipse Foundation 商标许可下的被许可方。
在下列情况下：Jakarta EE 工作组中信誉良好的战略成员有权利在 Jakarta EE 兼容软件产品官方列表中列示一款开源兼容的应用服务器，以及其公司名称、公司网站的链接，以及一个指向开源项目的下载链接（用户可以在通过该链接获得兼容的应用服务器）：
- 经 Jakarta EE 指导委员会批准；
- 该成员遵循Jakarta EE TCK流程来运行适用的TCK；
- 该成员和该开源项目符合 Eclipse Foundation TCK 许可证 的所有要求；且
- 该产品的标识可被列示在 Jakarta EE 官方兼容软件产品列表中的前提是，它是由开源项目提供的。该授权战略成员将 Jakarta EE 兼容性徽标与开源兼容应用程序服务器一起使用。他们还可能在其网站和其他宣传资料中包括 Jakarta EE 官方兼容软件产品列表的链接。

对于满足上述资格要求并希望列入 Jakarta EE 官方兼容软件产品列表的任何产品，必须提供以下信息：

webdev@eclipse-foundation.org (Eclipse Foundation) — Mon, 01 Jan 0001 00:00:00 +0000

Creation Review PR template

When creating a specification project plan review, create PRs with the content defined as follows.

Link to Specification Project:

Include the following in the PR:

An index page wombat/_index.md following template
Title should be on the form “Jakarta Wombat”

webdev@eclipse-foundation.org (Eclipse Foundation) — Mon, 01 Jan 0001 00:00:00 +0000

Plan Review PR template

When creating a specification project plan review, create PRs with the content defined as follows.

Include the following in the PR:

A directory in the form wombat/x.y where x.y is the release major.minor version.
An index page wombat/x.y/_index.md following template
Title should be on the form “Jakarta Wombat X.Y (under development)”
Includes a plan for the release. Usually, a couple of statements is enough. Otherwise, a link to a document describing the release.
Includes a detailed description of any backward incompatibility (Mark with N/A and check if none)
Declares optional features if there are any (Mark with N/A and check if none)
Includes minimum Java SE version
Describe any updates or required changes including splitting out the TCK (Mark with N/A and check if not planned)
Link to updated release record

webdev@eclipse-foundation.org (Eclipse Foundation) — Mon, 01 Jan 0001 00:00:00 +0000

Progress Review PR template

When creating a specification project plan review, create PRs with the content defined as follows.

Include the following in the PR:

A directory in the form wombat/x.y where x.y is the release major.minor version.
An index page wombat/x.y/_index.md following template
Title should be on the form “Jakarta Wombat X.Y (under development)”
Specification PDF in the form of jakarta-wombat-spec-x.y-Mn.pdf
Specification HTML in the form of jakarta-wombat-spec-x.y-Mn.html
For a Progress Review, that sufficient progress has been made on a Compatible Implementation and TCK, to ensure that the spec is implementable and testable.
Link to updated release record

webdev@eclipse-foundation.org (Eclipse Foundation) — Mon, 01 Jan 0001 00:00:00 +0000

Specification PR template

When creating a specification project release review, create PRs with the content defined as follows.

Include the following in the PR:

A directory in the form wombat/x.y where x.y is the release major.minor version, and the directory contains the following.
Specification PDF in the form of jakarta-wombat-spec-x.y.pdf
Specification HTML in the form of jakarta-wombat-spec-x.y.html
A specification page named _index.md following the template at:
https://github.com/jakartaee/specification-committee/blob/master/spec_page_template.md
For a Progress Review, that sufficient progress has been made on a Compatible Implementation and TCK, to ensure that the spec is implementable and testable.
For a Release Review, a summary that a Compatible Implementation is complete, passes the TCK, and that the TCK includes sufficient coverage of the specification. The TCK users guide MUST include the instructions to run the compatible implementations used to validate the release.
Instructions MAY be by reference.
- Updated release record
- Generated IP Log
- Email to PMC
- Start release review by emailing EMO
The URL of the OSSRH staging repository for the api, javadoc:
The URL of the staging directory on downloads.eclipse.org for the proposed EFTL TCK binary:
The URL of the compatibility certification request issue:
Specification JavaDoc in the wombat/x.y/apidocs directory.
If desired, an optional second PR can be created to contain just the JavaDoc in the apidocs directory.

Note: If any item does not apply, check it and mark N/A below it.

webdev@eclipse-foundation.org (Eclipse Foundation) — Mon, 01 Jan 0001 00:00:00 +0000

specifications

This site is powered by Netlify.

webdev@eclipse-foundation.org (Eclipse Foundation) — Mon, 01 Jan 0001 00:00:00 +0000

Specification Service Release PR template

When creating a service release, create PRs with the content defined as follows.

Include the following in the PR:

The URL of the Eclipse Project release record:
The URL of the OSSRH staging repository for the api, javadoc:
The URL of the staging directory on downloads.eclipse.org for the proposed EFTL TCK binary:
The URL of the compatibility certification request (CCR) issue:
Specification JavaDoc in the wombat/x.y/apidocs directory.
Changelog file at this location describing service release updates, wombat/x.y/changelog.
Update wombat/x.y/_index.md accordingly.
Start service release review by emailing Specification Committee and referencing this PR.

Note: Specifications themselves do not have service releases. Only the associated API (limited to JavaDoc updates), JavaDoc, and TCK artifacts can have service releases. Thus, the Specification version does not use the third digit – only the x.y version is used in the Specification directory structure.

Developer portal

webdev@eclipse-foundation.org (Eclipse Foundation) — Mon, 01 Jan 0001 00:00:00 +0000

Develop with Jakarta EE

Build secure, portable, scalable, cloud native apps using Jakarta EE APIs.

Get started

Generate a Jakarta EE project template and begin building right away.

Join Jakarta EE

webdev@eclipse-foundation.org (Eclipse Foundation) — Mon, 01 Jan 0001 00:00:00 +0000

Become a member

Shape the future of enterprise Java

Join industry leaders and innovators driving Jakarta EE forward. As a member, you'll help guide the technology's evolution, influence key decisions, and gain visibility as part of the open enterprise Java ecosystem.

Learn about membership

Contribute to projects

Turn your expertise into impact.

Join our global community of developers and make your mark on the Jakarta EE platform. From code to documentation, every contribution helps strengthen open, cloud native enterprise Java.

Home 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 12

Jakarta EE 12 Platform

Jakarta EE 12 Web Profile

Jakarta EE 12 Core Profile

Change Log

成为赞助商 | Jakarta EE

推动未来企业级Java的发展

您的支持

您的贡献

您的参与

赞助商权益

从使用 Jakarta EE 10 构建 Servlets开始

设置开发环境：

如何完成本指南

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

Change Log

Change Log

Change Log

Change Log

Change Log

Change Log

Change Log

为何选择 Jakarta EE?

JAKARTA EE 是标准

Jakarta EE 规范过程

Change Log

帮助我们一起塑造云原生Java的未来

加入 Jakarta EE

加入讨论

如何提交贡献

成为提交者

Change Log

Change Log

Change Log

Change Log

Change Log

Change Log

Jakarta EE 规范过程指引

内容

介绍

创建评论

相关步骤

计划评审

相关步骤

版本评审

JUG的"Adopt a Spec"程序

Adopters

JUG领导者可以提供的帮助:

JUG成员如何参与:

我们可以为JUG提供:

如何注册:

Oracle/JCP 缩略语指南

邮件列表

成员单位

Jakarta EE 简讯存档

Jakarta EE Newsletters Archives

2020

2019

2018

常见问题解答

常见问题解答

什么是Jakarta EE？

“Jakarta EE”这个名称有哪些特殊寓意？因何得名？

Jakarta EE平台都涵盖了哪些方面？

Jakarta EE 商标指引

Creation Review PR template

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

您的
支持

您的
贡献

您的
参与