设置开发环境

在开发 Java 应用程序之前，必须设置开发环境以解析依赖关系并构建应用程序以进行部署。 CICS® 提供了一套 Java 依赖项，包括 JCICS 和 JCICSX API，以访问资源。 CICS 您既可以使用 IBM® 提供的 SDK，也可以自带集成开发环境进行开发。

开始之前

有哪些 IDE 选项可用?

您可以在 IDE 中使用 IBM CICS SDK 或在您选择的 Java IDE 中开发应用程序。

IBM CICS SDK for Java™ 为 Java 应用程序提供支持，包括 JCICS 和 JCICSX API。它预装在 CICS Explorer® 和 IBM Developer for z/OS (IDz）中预装，也可作为插件安装到现有的 Eclipse 平台中。 IBM CICS SDK for Enterprise Java (Liberty) 提供 Enterprise Java 支持，需要作为 Eclipse 插件单独安装。这些 SDK 提供了必要的库和工具，供您解决 Java 依赖关系、构建应用程序并将其部署到 CICS 中。
如果您使用自己的 Java IDE，例如 Eclipse, IntelliJ, 和 VS Code，您可以通过引用 CICS 提供的 Maven Central 构件或从 USSHOME 手动导入 .jar 文件来解决依赖关系问题。然后，您可以使用 CICS 提供的 Gradle 或 Maven 插件打包应用程序。在部署时，您可以使用 CICS 提供的 Gradle 或 Maven 插件（需要事先配置 CICS 捆绑部署 API），或者编写自己的构建脚本来部署应用程序。

我应该选择哪个 IDE?

不同 Java IDE 之间的差异如下所示。有关 JCICS 和 JCICSX 的比较，请参阅探索 Java API。

表 1. 不同 IDE 的比较。功能在列 c1中列出。 IBM CICS SDK 和自带 IDE 方法在列 c2 和 c3中列出并进行比较。
功能	IBM CICS SDK	自带 IDE
解决 CICS Java 依赖关系，包括 JCICS 和 JCICSX API 类	如果将正确的库添加到构建路径或选择正确的 OSGi 目标平台，那么将自动解析依赖关系。 IBM CICS SDK for Java 在所有版本中包含 JCICS API，在 CICS Explorer for Aqua 3.3 或更高版本中包含 JCICSX API 类（ Aqua 指的是 IBM Explorer for z/OS Aqua ）。如果您使用 CICS Explorer for Aqua 3.3 或更高版本，则 SDK 不再支持 WDT；请使用替代解决方案，如 CICS Explorer 产品文档中安装 CICS Explorer 时 OSGi 应用程序的注意事项中所建议的那样。 IBM CICS SDK for Enterprise Java (Liberty) 包含 Eclipse Web Tools Platform ，它提供了用于开发 Enterprise Java 应用程序的工具。 IBM CICS SDK for Enterprise Java (Liberty) 以 Java 构建路径库或 OSGi 目标平台的形式提供 Enterprise Java 和 Liberty API。	通过在 Maven Central 上引用相应的 Gradle 或 Maven 工件来解决所需的依赖关系：JCICS、JCICSX、 CICS 注释、 CICS 注释处理器库和物料清单 (BOM)。工件可直接从 Maven Central 获取，也可使用 JFrog Artifactory 或 Sonatype Nexus 等工具从本地托管并允许列出的软件源获取。或者，您可以从 USSHOME 手动复制 .jar 文件以进行依赖关系管理。但是，手动复制 .jar 文件会使它们容易与更新不同步。在构建应用程序之前，不会检测到缺少的依赖关系。
构建或打包应用程序	需要手动检查构建结果。如果您正在使用 CICS Explorer，那么它所基于的 Explorer for z/OS 可以提供工具来处理 z/OS上的文件，数据集和作业，包括查看 JVM 服务器日志文件。	Gradle 或 Maven 可以轻松集成到 CI 管道中。
将应用程序部署到 CICS	如果在 CICS 束中部署应用程序，那么需要系统程序员安装，启用或禁用 CICS 中用于束部署的任何现有 BUNDLE 资源，除非授予您同等访问权。	如果使用 CICS 提供的 Gradle 或 Maven 插件进行部署（需要 CICS 捆绑部署 API）：将 CICS 束发送到 API 后，功能标识会自动将包发送到 zFS 并管理开发者的 BUNDLE 生命周期。因此， Java 开发者可以在系统程序员保留控制权的情况下部署捆绑软件。系统程序员必须提前设置 API 及其安全性。从 CICS TS 5.6 开始，该 API 在 CICSPlex® SM 环境中受支持，从 CICS TS 6.1 开始，该 API 在单个 CICS 区域 (SMSS) 中受支持。仅支持 Liberty JVM 服务器进行部署。如果不使用 CICS提供的插件，那么部署应用程序的方式类似于使用 IBM CICS SDK。即，在 CICS 束中部署应用程序时，开发者需要通过 FTP 连接将 CICS 束发送到 zFS ，并要求系统程序员在 CICS中管理 BUNDLE 资源的生命周期。

注：

如果使用 IBM CICS SDK 来为 CICS开发 Enterprise Java 应用程序，那么必须安装 IBM CICS SDK for Enterprise Java (Liberty)。如果要使用从 Eclipse Marketplace 下载的 CICS Explorer 来创建 OSGi 应用程序项目 (EBA) ，那么除了 IBM CICS SDK for Enterprise Java (Liberty)之外，还需要从 Eclipse Marketplace 安装 Liberty Developer Tools (LDT)。
IBM CICS SDK for Enterprise Java (Liberty) 依赖于 IBM CICS SDK for Java。因此，当您安装 IBM CICS SDK for Enterprise Java (Liberty)时，将自动安装 IBM CICS SDK for Java 。
如果需要利用 Gradle 或 Maven 资产 (例如 Maven Central 工件和插件) ，请确保 IDE 相应地支持 Gradle 或 Maven。 IDE 示例有 Eclipse、IntelliJ, 和 VS Code。

过程

要使用 SDK ，请以 CICS Explorer 为例:
1. IBM CICS Java SDK 预装在 CICS Explorer. 如果您想开发企业 Java 应用程序，请将 IBM CICS SDK for Enterprise Java (Liberty) 作为插件安装到您的计算机中。 CICS Explorer 作为插件。有关说明，请参阅 CICS Explorer 产品文档中的下载和安装 CICS Explorer 以及 CICS Explorer 产品文档中的安装 CICS SDK for Enterprise Java and Liberty。
  如果您需要在 CICS Explorer ，请参阅 CICS Explorer 产品文档中的安装 CICS Explorer 时对 OSGi 应用程序的考虑。
2. 重新启动开发环境。
3. 将库添加到构建路径或选择目标平台，以便 SDK 正确解析项目的依赖关系。请参阅 " 创建动态 Web 项目 "、 "创建 OSGi 应用程序项目 "和 "创建企业应用程序项目 "中的步骤 1。
要在您自己的 IDE 中使用 Gradle 或 Maven:
1. 确保您的环境满足以下任一先决条件:
  
  如果要在命令行下使用 Gradle 或 Maven，必须在机器上安装它们。请参阅安装 Gradle 以及下载和安装 Maven。
  
  或者，使用支持 Gradle 或 Maven 的集成开发环境。这些集成开发环境包括 Eclipse, IntelliJ IDEA 和 Visual Studio Code.
2. 使用 Gradle 或 Maven 创建项目，并根据要使用的 API 导入依赖项，如使用 Gradle 或 Maven 管理 Java 依赖项中所述。根据项目类型，您可能需要添加额外的 Gradle 或 Maven 配置。请参阅 " 创建动态 Web 项目 "、 "创建 OSGi 应用程序项目 "和 "创建企业应用程序项目 "中的步骤 1。
要将 USSHOME 目录中的 JAR 文件导入自己的集成开发环境，请参阅手动导入 Java 库。

结果

您的开发环境已准备好为 CICS开发 Java 应用程序。

下一步操作

如果使用 IBM CICS SDK，请参阅使用 IBM CICS SDK 开发应用程序。

如果使用 Gradle 或 Maven，请参阅使用 Gradle 或 Maven 管理 Java 依赖项。