Oracle/JCP 缩略语指南
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
项目的电子邮件地址可以在@符号左侧标识缩略语。
正如 Mike Milinkovich 此前在 Jakarta EE 对 Java 商标的权利更新 一文中提到的:
Jakarta EE 规范中可以使用javax包名称空间，但只能“按原样”使用。Jakarta EE 组件规范中不允许修改javax包名称空间。继续使用javax包命名空间的Jakarta EE规范必须与相应的Java EE规范保持TCK兼容。”
Jakarta EE 8 将使用现有的javax名称空间和 Java EE 8 包名，“原样”且不做任何修改，与本指南一致。如果在Jakarta EE 9 或更高版本中对现有Jakarta EE 8 或 Java EE 8 的包和api进行了修改，则必须使用新的（非javax）包名。请参阅上述包命名指南。
Oracle/JCP缩略语
*Jakarta项目不包括Java开发工具包（JDK）和Java虚拟机（JVM）技术。在使用这些缩略语之前，请联系trademark_us@oracle.com。
- EJB
- J2EE
- JAAS
- JACC
- JAF
- JAR
- JASPIC
- JAX (包括 JAXB, JAXP, JAX-WS, JAX-RS and other uses of “JAX”)
- JCA
- JCE
- JCK
- JCP
- JDBC
- JDK*
- JFC
- JFR
- JLS
- JMOD
- JMS
- JMX
- JNDI
- JNI
- JPA
- JPMS
- JRE
- JRMP
- JSF
- JSP
- JSPA
- JSR
- JSTL
- JTA
- JTS
- JVM*
- JWS
- RMI and RMI-IIOP
- SAAJ
