使用 Ant 构建工具构建 BeenThere 样本


J2EE 可移植性
重建此库中提供的样本
入门
确定目录结构
重建和安装样本

J2EE 可移植性

在 J2EE 平台上开发应用程序的一个主要的优点是可移植性。样本库中的所有样本程序是在工作站上开发的,并且不需要更改一行 Java 代码就可在 z/OS 系统上运行。通过在 Intel 或 UNIX 系统上构建 J2EE 应用程序,开发者可以消除 EBCDIC 到 ASCII 或 ASCII 到 EBCDIC 文件转换的难题。开发者可使用工具在开发工作站上轻松地编写和测试企业归档(EAR)文件,然后轻松地将它安装在 z/OS 系统上。

重建此库中提供的样本

每个 WebSphere Application Server(应用程序服务器)for z/OS 客户都被授权使用多平台的 Application Server 介质。如果您将 WebSphere Application Server Base 产品和样本安装在它支持的某个平台上,那么会看到同一个库。一种例外情况是,在单击 sample_name > 使用 Ant 构建 > 平台 > 重建和安装 sample.ear 文件时得到指示信息,要求在该平台上重建 EAR 文件。因为 EAR 文件中的文本文件(XML、xmi、JavaServer Pages(JSP)文件等)的格式必须是 ASCII,所以更容易在 ASCII 机器上编辑那些文件。如果您在 ASCII 机器上更改了 EAR 文件,那么不必进行 EBCDIC 到 ASCII 转换就可以在 z/OS 平台上部署和安装更改后的 EAR 文件。 



入门

在您选择的分布式平台上安装 WebSphere Application Server,并且指出也安装 Application Server 样本应用程序。

在尝试修改或重建样本之前,制作 <profile_root> 目录的备份副本。创建 samples 目录的 zip 文件。您可以通过解压缩此 zip 文件,将 samples 目录恢复为其原始状态。



确定目录结构

按下面所示构建样本目录结构:


profile_root/samples/src/BeenThere 包含 BeenThere 样本的样本源代码。
profile_root/samples/lib/BeenThere 包含 BeenThere 样本的 BeenThere.ear 文件。
profile_root/samples/javadoc/BeenThere 包含构建 BeenThere 样本时生成的 Javadoc 文档。
profile_root/samples/bld/BeenThere 包含所生成的类文件。使用这些类文件生成最终 BeenThere.ear 文件。重建 BeenThere 样本后,bld 目录也会被创建。



重建和安装样本

下列指导描述重建样本的步骤。


运行样本构建脚本

按照下列步骤来运行样本构建脚本,它重建样本:

  1. 打开命令提示符。
  2. 在命令行上,转至 profile_root/samples/src/BeenThere 目录。
  3. 运行样本构建脚本:

  4. 输入以下命令:

    profile_root\samples\bin\BeenThere\buildBeenThere.bat

    输入以下命令:

    . profile_root/samples/bin/BeenThere/buildBeenThere.sh

    • 在 Windows 开发平台上,输入以下命令:

      profile_root\samples\bin\BeenThere\buildBeenThere.bat

    • 在 UNIX 和 Linux 开发平台上,输入以下命令:

      . profile_root/samples/bin/BeenThere/buildBeenThere.sh
    输入以下命令:

    . profile_root/samples/bin/BeenThere/buildBeenThere.sh

现在样本已构建。

profile_root/samples/bin/BeenThere 目录中找到 buildBeenThere.batbuildBeenThere.sh 脚本。这些脚本设置适当的类路径信息,并运行 Ant 构建实用程序。Ant 实用程序读取描述了如何构建样本的 build.xml 文件。请参阅 Jakarta Web 站点以获取有关 Ant 的其他文档。

传送已重建的 BeenThere.ear 文件

通过使用以下指示信息,使用文件传输协议(FTP)将二进制 EAR 文件传送到 z/OS 服务器。

  1. <profile_root>/samples/lib/BeenThere 目录中找到已重建的 EAR 文件
  2. 从开发平台打开与 WebSphere Application Server for z/OS 的 FTP 会话
  3. 转至目录 <profile_root>/samples/lib/BeenThere
  4. del BeenThere.ear
  5. bin
  6. put BeenThere.ear
  7. quit

除去和重新安装 BeenThere.ear 文件

按下面描述的步骤重新安装样本:


  1. 通过打开 Web 浏览器并转至 http://<host_name>:9060/ibm/console 来启动管理控制台,其中 <host_name> 是运行 Deployment Manager 的主机名或 IP 地址。
  2. 通过打开 Web 浏览器并转至 http://<host_name>:9060/ibm/console 来启动管理控制台,其中 <host_name> 是运行 Deployment Manager 的主机名或 IP 地址。
  3. 通过打开 Web 浏览器并转至 http://<host_name>:9080/admin 来启动管理控制台,其中 <host_name> 是运行 Deployment Manager 的主机名或 IP 地址。
  4. 通过打开 Web 浏览器并转至 http://<host_name>:9060/ibm/console 来启动管理控制台,其中 <host_name> 是运行 Deployment Manager 的主机名或 IP 地址。
  5. 单击服务器 > 集群
  6. 选择所有的集群。
  7. 单击停止
  8. 单击应用程序 > 企业应用程序
  9. 选择 BeenThere 应用程序。
  10. 单击卸载
  11. 在管理控制台中主面板的顶部单击保存
  12. 单击保存
  13. 完成安装 BeenThere.ear 文件的步骤。

现在将已重建的 BeenThere.ear 文件部署到您的应用程序服务器。