Skip to content

2.13 平台契约

本节描述 Jakarta EE 产品提供商在实现 Jakarta EE 平台时必须满足的 Jakarta EE 契约。Jakarta EE 规范概要可包含这些功能的部分或全部内容,具体参见《规范概要》章节。

2.13.1 Jakarta EE 应用程序接口(APIs)

Jakarta EE 应用程序接口定义了 Jakarta EE 应用组件与 Jakarta EE 平台之间的契约,该契约同时规定了运行时接口与部署接口。

Jakarta EE 产品提供商必须按照本规范中描述的语义与策略实现 Jakarta EE 应用程序接口。应用组件提供商需提供符合这些接口与策略的组件。

2.13.2 Jakarta EE 服务提供者接口(SPIs)

Jakarta EE 服务提供者接口定义了 Jakarta EE 平台与可接入 Jakarta EE 产品的服务提供者之间的契约。Jakarta 连接器接口定义了用于将资源适配器与 Jakarta EE 应用服务器集成的服务提供者接口,实现 Jakarta 连接器接口的资源适配器组件被称为连接器。Jakarta 授权接口定义了用于将安全授权机制与 Jakarta EE 应用服务器集成的服务提供者接口。

Jakarta EE 产品提供商必须按照本规范中描述的语义与策略实现 Jakarta EE 服务提供者接口。服务提供者组件的提供商(如连接器提供商)应提供符合这些接口与策略的组件。

2.13.3 网络协议

本规范定义了应用组件到行业标准网络协议的映射关系。该映射支持未安装 Jakarta EE 产品技术的系统对应用组件进行客户端访问。有关互操作性所需的网络协议支持详情,参见《互操作性》章节。

Jakarta EE 产品提供商需通过行业标准协议发布已部署的应用组件。本规范定义了 Servlet 与页面到 HTTP、HTTPS 协议的映射,以及 Jakarta 企业 Bean 组件到 IIOP、SOAP 协议的映射。Jakarta EE 11 不再要求支持带附件的 Jakarta SOAP,具体参见《移除的 Jakarta 技术》章节。

2.13.4 部署描述符与注解

部署描述符与 Java 语言注解用于向部署人员传递应用组件的需求。部署描述符与类文件注解是应用组件提供商或组装人员与部署人员之间的契约。应用组件提供商或组装人员需在组件的部署描述符中,或通过类文件注解,指定应用组件的外部资源需求、安全需求、环境参数等内容。Jakarta EE 产品提供商需提供部署工具,用于解析 Jakarta EE 部署描述符与类文件注解,并支持部署人员将应用组件的需求映射至特定 Jakarta EE 产品与环境的能力。