要为 Java™ 应用程序开发 Web 表示层,可以创建 动态 Web 项目。
开始之前
确保已 设置开发环境。
Liberty 添加并由应用于 CICS TS V5.1的 APAR 引入的限制会阻止从 WAR 文件中部署的 Servlet 访问 OSGi 捆绑软件。 此限制包括对直接安装在 CICS 束中的 OSGi 束的访问权。 要克服此限制,必须将应用程序部署为 WAB ,作为 EBA (OSGi 应用程序项目) 的一部分。 EBA 是 Web 和 OSGi 组件可以进行交互的容器。
关于此任务
如果您正在使用 IBM CICS SDK for Java 或 IBM CICS SDK for Java EE, Jakarta EE and Liberty 预安装在 CICS Explorer® (如以下指示信息中所示) 或 IBM Developer for z/OS (IDz) 中, 您可以参阅 CICS Explorer 和 IBM CICS SDK for Java 帮助,其中提供了有关如何完成以下每个步骤以开发和打包 Web 应用程序的完整详细信息。
如果您正在使用构建工具链 (例如 Maven 或 Gradle) ,那么可以在 Maven Central 上使用 CICS提供的工件来定义 Java 依赖关系。
过程
- 为应用程序创建 Web 项目。
- CICS Explorer 如果要使用 CICS Explorer,请创建 动态 Web 项目 并更新构建路径以添加 Liberty 库。
- 右键单击 动态 Web 项目 ,然后单击 。 这将打开项目的“属性”对话框。
- 在 Java 构建路径中,单击 库 选项卡。
- 单击 添加库 并选择 CICS 与 Java EE, Jakarta EE 和 Liberty。
- 单击 下一步,选择 CICS 版本,然后单击 完成 以完成添加库。
- 单击确定以保存更改。
- Gradle 对于 Gradle 用户,创建 Gradle 项目。 在 build.gradle 文件中,指定以下内容并 声明对 CICS提供的工件的依赖关系。
plugins {
id 'war'
}
- Maven 对于 Maven 用户,创建 Maven 项目。 在 pom.xml 文件中,指定
<packaging>war</packaging> 并 声明对 CICS提供的工件的依赖关系。 如果您不熟悉 Maven ,那么可以从 maven-archetype-webapp archetype 开始并对其进行修改。
- 开发 Web 应用程序。 您可以使用 JCICS API 来访问 CICS 服务,使用 JDBC 来访问 DB2® ,使用 JMS 来访问 IBM MQ。 IBM CICS SDK for Java EE, Jakarta EE 和 Liberty 包含使用 JCICS 和 JDBC的 Web 组件的示例。
- 可选: 如果要使用 CICS 安全性保护应用程序,请在 动态 Web 项目 中创建 web.xml 文件以包含 CICS 安全性约束。 IBM CICS SDK for Java EE, Jakarta EE and Liberty 包含此文件的模板,其中包含 CICS的正确信息。 请参阅 在 Liberty JVM 服务器中认证用户 以获取更多信息。
- 创建一个或多个 CICS 束项目以打包应用程序。 添加 CICS 资源的定义和导入。 每个 CICS 束都包含一个标识和版本,因此您可以以精细方式管理更改。
- 可选: 如果要将来自 URI 的入站 Web 请求映射到在特定事务下运行,请将 URIMAP 和 TRANSACTION 资源添加到 CICS 束。 如果未定义这些资源,那么所有工作都在提供的事务(称为 CJSA)下运行。 这些资源作为 CICS中的束的一部分进行动态安装和管理。
结果
您可以设置开发环境,从 动态 Web 项目创建 Web 应用程序,并将其打包以进行部署。
下一步操作
准备好部署应用程序时,将 CICS 束项目导出到 zFS。 这样会构建引用的项目并将其包含在到 zFS 的传输中。 或者,您可以按照 Liberty 部署模型进行操作,将该应用程序作为 WAR 导出并将其部署至正在运行的 Liberty JVM 服务器的 dropins 目录。