BAR 文件添加资源

要将一组相关资源部署到 集成服务器,请将这些资源包含在 BAR 文件中。

准备工作

为要部署的每个配置创建一个 BAR 文件。 有关更多信息,请参阅 创建 BAR 文件

或者,您可以从已部署的应用程序检索 BAR 文件。 有关更多信息,请参阅 检索已部署的 BAR 文件

关于此任务

您可以将工作空间中的任何可部署资源添加到 BAR 文件。 如果选择 添加工作空间项目源文件,那么将包括 BAR 文件中所有消息流,消息模型模式文件,消息集或其他可部署资源的源和项目文件。 如果未将源文件和项目文件添加到 BAR 文件,请确保保留源文件和项目文件的副本,因为无法从 BAR 文件中的已编译资源重新生成开发资源。 如果将源文件和项目文件添加到 BAR 文件,请确保保留 BAR 文件的副本,因为无法重新生成 BAR 文件或从 集成服务器上的已部署资源重新生成该文件。

有关可以包含在 BAR 文件中的文件的更多信息,请参阅 BAR 文件内容

若要使用 IBM App Connect Enterprise 工具包将文件添加到 BAR 文件中,请按照以下步骤操作。

过程

  1. 双击 BAR 文件以将其打开。
    BAR 文件的内容显示在 BAR 文件编辑器中。 (如果 BAR 文件是新的,那么此视图为空。)
  2. BAR 文件编辑器的 准备 选项卡上,选择要添加到 BAR 文件的可部署工作空间资源:
    • 单击应用程序、共享库、服务和 REST API,以查看可以部署的这些资源的列表。 如果您选择了应用程序、共享库或服务,那么其中包含的所有资源都将随该容器一起进行部署。
    • 单击策略以查看可部署的策略项目的列表。 您可以将多个策略项目添加到 BAR 文件。 这些策略中设置的属性将覆盖在运行时在已部署的消息流,消息流节点和 集成服务器 上设置的属性。
    • 单击 消息流,静态库和其他消息流依赖关系 以查看可直接部署到 集成服务器的各个资源。 部署这些资源后,它们将对同一 集成服务器中的所有其他已部署资源可见。
    注:
    • 如果应用程序引用共享库,那么必须在此应用程序之前或者同时部署该库。 可以将共享库作为引用它的应用程序部署在同一 BAR 文件中,也可以将应用程序和引用的共享库部署在单独的 BAR 文件中。
    • 如果您选择的应用程序引用了一个或多个静态库,那么这些库将作为嵌套的 .libzip 文件添加到应用程序 .appzip 文件中。 所引用的这些静态库是私有库,并且不可供该应用程序外部的资源访问。 因此,在准备选项卡上,缺省情况下未选中这些静态库。 但是,如果您希望将某个静态库部署为集成服务器级别的库(可供其他资源访问),请选中该静态库以便单独进行部署。 将为该静态库创建 .libzip 文件,并在根级别将其添加到 BAR 文件。
    • 如果选择引用其他静态库的静态库,那么还会将这些引用的库作为 .libzip 文件添加到 BAR 文件中。
    • 如果您选择的应用程序涉及一个或多个.NET 应用程序域 ,这些应用程序域将作为文件 .appdomainzip 添加到 BAR 文件的根目录下。
    • 无法将 集成项目 添加到 BAR 文件。 而是将 集成项目 中包含的各个资源添加到 BAR 文件中。
    • 如果解决方案包含 Java™ 代码或消息集,那么必须编译这些资源并将已编译的资源添加到 BAR 文件; 请参阅 打包包含 Java 代码或消息集的资源
    • 如果您选择的消息流包含一个或多个 WebSphere® Adapters 节点,那么将打开一个对话框,以便您可以识别以下资源:
      • 要由 WebSphere Adapters 节点使用的一个或多个 WebSphere Adapters 组件。
      • 一个或多个库,其中包含 WebSphere Adapters 节点所使用的业务对象的 XSD
      有关在 BAR 文件中包含 WebSphere Adapters 的更多信息,请参阅 在 BAR 文件中包含 WebSphere Adapters 资源
  3. 可选: 要包含源文件,请选择 添加工作空间项目源文件

    如果选择 添加工作空间项目源文件,那么会将所有应用程序,库和其他已编译资源的源项目添加到 BAR 文件的 src 文件夹中。

  4. 可选: 要在构建新的 BAR 文件之前从 BAR 文件中除去现有内容,请选择 在构建前除去 BAR 的内容
  5. 可选: 如果再次将消息流添加到 BAR ,并使用 管理 选项卡来更改流参数,请选择 覆盖可配置属性值 以重置配置设置。
    如果未选中此控件,那么替换流时,现有设置将保留不变。
  6. 可选: 要将消息流包含为已编译的消息流 (.cmf) 文件,并将 ESQL 代码直接包含在引用 ESQL 文件的每个消息流的 .cmf 文件中,请选择 编译并直接插入资源。 缺省情况下,将消息流添加到 BAR 文件时,会将其添加为 .msgflow 文件。 缺省情况下,由一个或多个消息流引用的每个 ESQL 文件都部署为单个资源,并且可以由多个 .msgflow 文件访问。
    如果您添加到 BAR 文件的任何流包含 .msgflow 文件中定义的子流,那么必须选择 编译并直接插入资源
  7. 单击 构建并保存

结果

管理 选项卡列出了现在位于 BAR 文件中的文件。 请展开应用程序和库,以查看其内容。 BAR 文件中的已编译资源在树中按字母顺序显示。 您只能对根元素进行编辑。 例如,如果将应用程序添加到 BAR 文件,那么可以重命名 .appzip 文件或向其添加注释。 您无法对 .appzip 文件中的资源进行编辑,但可以对这些资源的可配置属性进行编辑。

无法从 .appzip.appdomainzip.libzip.shlibzip 文件中除去各个资源。 要删除这些资源,必须先删除应用程序、.NET 应用程序域或库。

通过从过滤依据菜单的列表中选择已构建的资源可配置属性,您可以选择不显示源文件。

后续操作

完成以下两个任务之一或全部: