IBM Rational Web Developer 修订包 6.0.1.1 － 发行说明

适用于 Rational Web Developer V6.0、6.0.0.1 或 6.0.1

© Copyright International Business Machines Corporation 2000, 2005. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

1.0 关于此发行版
2.0 产品修订历史
   2.1 累计修订
   2.2 调试器
   2.3 企业生成语言（EGL）
   2.4 J2EE 工具
   2.5 JavaServer Faces
   2.6 Page Designer
   2.7 Struts
   2.8 XML 工具
   2.9 数据工具
   2.10 服务器工具
3.0 安装信息
   3.1 安装指示信息
   3.2 硬件需求
   3.3 软件需求
   3.4 必须共存的软件
4.0 已知问题与局限性
   4.1 EGLSDK 和 EGLCMD 的局限性
   4.2 EGL Java™ 生成的多组任何类型的记录
   4.3 BLOB 和 CLOB 函数的说明不正确
   4.4 EGL 字符串并置中不再出现填充空格
   4.5 Crystal Reports® 不能用来与基于 z/OS® 和 iSeries™ 的数据库产品建立 JDBC 连接
   4.6 不支持从 XML 数据源生成 Crystal Reports 以在 WebSphere® Application Server v5.x 上显示
   4.7 Faces Client 组件 － onRowAdd 事件被添加至 DataGrid
5.0 客户支持
6.0 声明与商标

1.0 关于此发行版

要查看此文件的最新版本，请参阅在以下网址中提供的发行说明：www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rwd/6011/html/nl/zh_CN/readme_6011.html。

IBM® Rational® Web Developer 修订包 6.0.1.1 包含对版本 6.0.1 发行版的修订和下列增强功能：

EGL 构建器性能改进

EGL 构建器的性能得到了显著的改进。可预期看到下列两方面的显著改进：构建整个工作空间所需的时间和在开发各部件时构建它们所需的时间。如果“自动构建”首选项在过去通常是关闭的，则尝试在工作时打开它。

第一次用 EGL V6.0.1.1 构建每个项目时，将会自动修改项目根目录中的 .project 文件，以便它引用新的 EGL 构建器。此更新完成之后，项目的所有将来构建都会使用新的 EGL 构建器。建议用户在启动 V6.0.1.1 并装入工作空间之后手工调用构建，以便先用新的 EGL 构建器构建项目，然后再进行进一步的开发。手工构建可通过从工具栏中选择项目 > 全部构建来进行调用。

注意：如果启用了“自动构建”选项，则在为现有工作空间第一次启动版本 6.0.1.1 产品时或在新的和现有的工作空间中导入了项目之后，项目更改为使用新的 EGL 构建器。如果禁用了“自动构建”选项，就必须手工调用构建以迁移至新的 EGL 构建器。已配置用版本 6.0.1.1 产品创建的所有新项目，以使用新 EGL 构建器。

新的 EGL 问题类型

作为构建器性能改进的一部分，已为 EGL 创建新的问题类型。在“问题”视图中显示错误时，会用到这些问题类型。在安装 V6.0.1.1 之后，可能必须更新“问题”视图以便正确显示这些新的问题类型。要更新视图，从“问题”视图下拉菜单中选择过滤器选项。在所显示的对话框中，确保选择了下列类型（需要滚动该表来找到这些 EDT 条目）：

消息差别

作为构建器性能改进的一部分，我们做了一些工作以便发出的验证错误消息方面的一致性更好。当捕获了所有相同的错误情况时，您就有可能看到与先前数量不同的错误消息。另外，发出的消息文本也可能与先前的不同。以前，当从某一调用了函数的部件（程序、库等等）中验证引用的函数时，所有错误消息都位于函数调用语句上。现在，这些错误消息位于被调用函数中发生错误的特定行上。每条错误消息都包含调用部件的名称。这使找到错误的原因更容易。

使用表单语法更改

作为构建器性能改进的一部分，我们在如何处理表单方面进行了更改。但是，如果表单组在多个表单上具有名称相似的字段并且程序对这些字段具有非限定引用，就有可能会导致混淆错误。我们添加了新的“Use forms”（使用表单）语法，以便客户可以指定在名称解析过程中查找哪些表单。

use <formgroup-name>.<form-name>、<formgroup-name.form-name> 等等。

如果遇到与解析表单字段相关的新验证错误，为了解决这些问题，可完全限定对表单字段的引用，或者可使用称为“组织所用表单”的新操作。此操作对程序进行分析以查看实际使用了什么表单，然后创建适当的 Use 语句。此操作在 EGL 项目、EGL 包和 EGL 文件的上下文菜单上提供。同时在 EGL 编辑器的上下文菜单上也提供。如果程序存在严重错误，例如，语法错误、use 语句未解析或使用多个非帮助表单组，则此操作会发出一条消息，指出由于程序中存在错误，不能执行操作，也不会应用任何更改。但是，如果存在其他错误，例如此操作要解决的混淆错误，则此操作能起作用。如果存在足够严重的错误，使 EGL 不能识别 I/O 语句的错误，则此操作不能检测该语句上的表单并且结果可能不包括所有使用的表单。因此，除了混淆错误之外，建议将此操作与已完全编译好的程序一起运行。

注意：useformGroup 仍然受支持，且可以使用。它是列出 use 语句的表单组中每个表单的快捷方式。

COBOL 兼容性的 EGL SQL 检索选项

在 EGL 声明时，可以使用 SQL 检索功能来从 SQL 表的列中创建 SQL 记录。如果您希望新的 SQL 记录与 COBOL 程序兼容（即，结构项级别号已修订一些记录，以及使用 CHAR 而不是 STRING 基本类型），则选择“SQL 检索首选项”窗口上的创建与 COBOL 兼容的记录定义复选框。

可定制 JSF 表的行编辑按钮标签

添加了三个新的“行编辑”属性供定制按钮标签之用：editLabel 用于“编辑”按钮标签，saveLabel 用于“保存”按钮标签，cancelLabel 用于“取消”按钮标签。

2.0 产品修订历史

2.1 累计修订

此修订包包括 Rational Web Developer V6.0.1 和下列临时修订：

2.2 调试器

（PK12617）当在断点处停止时，调试器对 Java 源代码执行的搜索不返回结果。

2.3 企业生成语言（EGL）

2.4 J2EE 工具

2.5 JavaServer Faces

2.6 Page Designer

2.7 Struts

2.8 XML 工具

2.9 数据工具

现在，支持使用 DB2® 通用 JDBC 驱动程序来构建 Java 存储过程，这些存储过程的源代码大于 32K，目标是 DB2 UDB z/OS 版 V7 服务器。在添加此支持之前，只有 DB2 UDB z/OS V8 Java 存储过程支持“通用驱动程序”。为了使此支持起作用，必须安装 DB2 z/OS 版 V7 APAR（PK01445）。

2.10 服务器工具

（PK10862）当使用 WebSphere 测试环境 V6 时，带 ClearCase 视图的添加和除去项目选项不能将 WAR 文件与 Web 库项目配合使用。

3.0 安装信息

3.1 安装指示信息

有关安装 IBM Rational Web Developer 修订包 6.0.1.1、安装先决条件、从命令行进行安装以及设置更新服务器的本地镜像的信息，请参阅安装指示信息，网址为：www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rwd/60/install_instruction/6011/nl/install_zh_CN.html。

3.2 硬件需求

有关此修订包的硬件需求，参阅安装指示信息。

3.3 软件需求

此修订包可在 IBM Rational Web Developer 6.0、6.0.0.1 或 6.0.1 的基础上安装。

3.4 必须共存的软件

如果您使用本地更新并且安装了多个产品，则必须将所有已安装产品的 6.0.1.1 修订包下载到本地更新站点。这是因为它们之间存在依赖性。如果您安装了多个产品但只下载一个修订包，并运行 Rational Product Updater，则当您搜索更新时，Updater 将产生一条警告，指出缺少其中一项必需的更新。另外，这种情况只适用于使用本地更新站点的客户。

要同时安装这些修订包，将它们下载到本地更新站点。然后使用 Rational Product Updater 从更新站点同时安装所有修订包。

例如，假定系统上同时安装了 Rational Application Developer 和 Rational Software Modeler。因为这些产品的修订包是互相依赖的，所以必须同时安装它们。将这两个修订包下载到本地更新站点，并运行 Rational Product Updater 以更新安装。

4.0 已知问题与局限性

4.1 EGLSDK 和 EGLCMD 的局限性

版本 6.0.1 文档未能包括 EGLSDK 和 EGLCMD 命令的下列局限性和建议。

对于两个命令：

  1. 要解决运行 EGLSDK 或 EGLCMD 时出现的 OutOfMemoryError，尝试增大 JVM 堆大小。使用以下命令：
    java [-msstart_sizem] -mxmax_sizem application

    start_size
    可选的起始 JVM 堆大小，以兆字节计，在运行 application 时使用。

    max_size
    最大 JVM 堆大小，以兆字节计，在运行 application 时使用。此值不应大于系统可用 RAM 的一半。

    application
    EGLSDK 或 EGLCMD，后跟其常用参数。

    以下示例假设系统具有 2GB 可用 RAM：

         java -ms512m -mx1024m EGLCMD EGLListDetailForTUI/EGLCommandFile.xml -data D:\WorkSpace

对于 EGLSDK：

  1. 确保 emfworkbenchedit.jar 位于 Java 类路径中。该 jar 文件在以下目录中： 
    installationDir\rwd\eclipse\plugins\com.ibm.wtp.emf.workbench.edit_version\emfworkbenchedit.jar
    installationDir
    产品安装目录，例如 C:\Program Files\IBM\RSPD\6.0。如果在安装您现在正在使用的产品之前安装并保留了 Rational Developer 产品，则您需要指定在先前安装中使用的目录。

    version
    插件的已安装版本；例如，1.0.0
  2. 如果您想要对 z/OS® 或 iSeries™ 启用 COBOL 生成，则确保运行时 jar 文件 eglgencobol.jar 位于您的类路径中。该 jar 文件在以下目录中： 
    installationDir\egl\eclipse\plugins\com.ibm.etools.egl.batchgeneration_version
    installationDir
    产品安装目录，例如 C:\Program Files\IBM\RSPD\6.0。如果在安装您现在正在使用的产品之前安装并保留了 Rational Developer 产品，则您需要指定在先前安装中使用的目录。

    version
    插件的已安装版本；例如，6.0.0
  3. EGL 不支持从 SDK 生成 pageHandler。要以批处理方式创建 pageHandler，请使用 EGLCMD。

对于 EGLCMD：

  1. 在从命令提示符执行 EGLCMD 之前关闭工作台 UI 的所有实例。
  2. 如果您使用向导来创建命令文件，则不要将该命令文件移至另一个目录。该命令文件必须位于包含用来生成代码的部件 EGL 的工作空间中。
  3. 使用 -data 选项来指定 EGLCMD 的工作空间。否则 EGL 将使用缺省工作空间，它可能不是您想要的工作空间。
  4. 当使用 EGLCMD 生成 pageHandler 时，务必要使用构建描述符选项 genProject。这使 EGL 能够自动处理所有 J2EE 部署信息。
  5. 如果您将 EGLCMD 和 genDirectory 构建描述符选项用于不包含 Web 组件的项目，则 EGL 将在工作台外部编译程序。为此，Java 编译器（javac.exe）必须位于系统路径中，而 EGL Java 生成代码（eglbatchgen.jar，在安装目录的 bin 目录中）必须位于系统类路径中。
  6. 如果针对 iSeries 进行生成，则可能还需要将 xml.jar（可在安装目录的 eclipse\jre\lib 中找到它）放在类路径上。由于 EGLCMD 的类路径中存在的项太多也会导致问题，所以类路径中应该只含有这四个文件eglutil.jar、startup.jar、eglbatchgen.jar 和 xml.jar 以便针对 iSeries 进行生成。
  7. 如果您使用 EGLCMD 生成 pageHandler，则必须用受管 Bean 和导航规则条目手工更新 faces-config.xml 以使页面处理程序正常运行。

4.2 EGL Java 生成的多组任何类型的记录

从版本 6.0.1.1 开始，只要生成 Java，就可以创建多组任何类型的记录。如果生成 COBOL，则旧规则仍然适用：您只能创建一组 Basic、SQL 或 DLISegment 记录。

4.3 BLOB 和 CLOB 函数的说明不正确

以下函数的说明不正确：

这些“attach”函数将变量（BLOB 或 CLOB）与文件资源（指定的或临时的系统文件）相关联，但不会将变量的内容写至该资源。任何先前内存或文件关联将被释放。后续操作（例如从数据库读到变量中）将更新文件。

4.4 EGL 字符串并置中不再出现填充空格

以前，当您在 EGL 字符串并置中包括限长字符串变量并且 itemsNullable 为 YES 时，会用空格填充变量的值至最大长度。当 itemsNullable 为 NO 时，不会添加填充空格。从版本 6.0.1.1 开始，将不会再填充任何空格。

4.5 Crystal Reports 不能用来与基于 z/OS 和 iSeries 的数据库产品建立 JDBC 连接

不支持从 Crystal Reports 与基于 z/OS 和 iSeries 的数据库产品建立 JDBC 连接。

 

4.6 不支持从 XML 数据源生成 Crystal Reports 以在 WebSphere Application Server V5.x 上显示

Crystal Reports XML 驱动程序要求应用程序服务器至少符合 J2EE 1.4，因此不支持 Websphere Application Server V5.x 运行时，该运行时符合 J2EE 1.3。
 

4.7 Faces Client 组件 － onRowAdd 事件被添加至 DataGrid

在运行时将新行添加至 Faces Client 组件 DataGrid 时，可为各字段指定缺省值并将缺省值设置为 NULL。

通过使用 onRowAdd 事件处理程序，在将新行的新 EObject 添加至 DataGrid 时可解释它：

  1. 将 onRowAdd 属性添加至 datagrid 标记：
    <odc:dataGrid allowRowAddAndDelete="false" styleClass="dataGrid" showSelectionColumn="false" pageSize="10" id="dataGrid1" onRowAdd = "return myOnRowAddHandler( this, event);">
  2. 然后，可以在处理程序中编写任何 JavaScript ，或使用处理程序来在新行的 EObject 中设置缺省属性。当用户尝试将新行添加至 DataGrid 时，将调用此处理程序。以下代码示例将样本 EObject 的 AGE 字段的值设置为 NULL：
    myOnRowAddHandler(thisObj, thisEvent) {
    //thisObj is DataGrid Control
    var objs = thisObj.Adapter.EObjects;
    objs[objs.length-1].eSet("AGE",null);
    }

5.0 客户支持

Rational Web Developer 的产品主页为 www.ibm.com/software/awdtools/developer/web/。有关 FAQ、已知问题与修订的列表以及其他支持信息，请访问位于以下网址的产品支持页面：www.ibm.com/software/awdtools/developer/web/support/index.html。

6.0 声明和商标

© Copyright IBM Corporation 2000, 2005. All Rights Reserved.

本 IBM 产品中包括的 XDoclet 文档经许可才能使用，并且包含在以下著作权归属声明中：Copyright © 2000-2005, XDoclet Team. All rights reserved.

部分内容基于 Design Patterns: Elements of Reusable Object-Oriented Software, by Erich Gamma, Richard Helm, Ralph Johnson and John Vlissides, Copyright © 1995 by Addison-Wesley Publishing Company, Inc. All rights reserved.

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

本信息是为在美国提供的产品和服务编写的。IBM 可能在其他国家或地区不提供本文档中讨论的产品、服务或功能特性。有关您当前所在区域的产品和服务的信息，请向您当地的 IBM 代表咨询。任何对 IBM 产品、程序或服务的引用并非意在明示或暗示只能使用 IBM 的产品、程序或服务。只要不侵犯 IBM 的知识产权，任何同等功能的产品、程序或服务，都可以代替 IBM 产品、程序或服务。但是，评估和验证任何非 IBM 产品、程序或服务，则由用户自行负责。

IBM 公司可能已拥有或正在申请与本文档描述的内容有关的各项专利。提供本文档并未授予用户使用这些专利的任何许可。您可以用书面方式将许可查询寄往：

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

有关双字节（DBCS）信息的许可查询，请与您所在国家或地区的 IBM 知识产权部门联系，或用书面方式将查询寄往：

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

本条款不适用英国或任何这样的条款与当地法律不一致的国家或地区：International Business Machines Corporation“按现状”提供本出版物，不附有任何种类的（无论是明示的还是暗含的）保证，包括但不限于暗含的有关非侵权、适销和适用于某种特定用途的保证。某些国家或地区在某些交易中不允许免除明示或暗含的保证。因此本条款可能不适用于您。

本信息中可能包含技术方面不够准确的地方或印刷错误。此处的信息将定期更改；这些更改将编入本资料的新版本中。IBM 可以随时对本资料中描述的产品和／或程序进行改进和／或更改，而不另行通知。

本信息中对非 IBM Web 站点的任何引用都只是为了方便起见才提供的，不以任何方式充当对那些 Web 站点的保证。那些 Web 站点中的资料不是 IBM 产品资料的一部分，使用那些 Web 站点带来的风险将由您自行承担。

IBM 可以按它认为适当的任何方式使用或分发您所提供的任何信息而无须对您承担任何责任。

本程序的被许可方如果要了解有关程序的信息以达到如下目的：（i）允许在独立创建的程序和其他程序（包括本程序）之间进行信息交换，以及（ii）允许对已经交换的信息进行相互使用，请与下列地址联系：

Intellectual Property Dept. for Rational Software
IBM Corporation
3600 Steeles Avenue East
Markham, Ontario
Canada L3R 9Z7

只要遵守适当的条件和条款，包括某些情形下的一定数量的付费，都可获得这方面的信息。

本资料中描述的许可程序及其所有可用的许可资料均由 IBM 依据 IBM 客户协议、IBM 国际软件许可协议或任何同等协议中的条款提供。

涉及非 IBM 产品的信息可从这些产品的供应商、其出版说明或其他可公开获得的资料中获取。IBM 没有对这些产品进行测试，也无法确认其性能的精确性、兼容性或任何其他关于非 IBM 产品的声明。有关非 IBM 产品性能的问题应当向这些产品的供应商提出。

版权许可：

本信息包括源语言形式的样本应用程序，这些样本说明不同操作平台上的编程方法。如果是为按照在编写样本程序的操作平台上的应用程序编程接口（API）进行应用程序的开发、使用、经销或分发为目的，您可以任何形式对这些样本程序进行复制、修改、分发，而无须向 IBM 付费。这些示例并未在所有条件下作全面测试。因此，IBM 不能担保或暗示这些程序的可靠性、可维护性或功能。

凡这些样本程序的每份拷贝或其任何部分或任何衍生产品，都必须包括如下版权声明：

©（贵公司的名称）（年）。此部分代码是根据 IBM 公司的样本程序衍生出来的。© Copyright IBM Corp. 2000, 2005. All rights reserved.

如果您正在查看此信息的软拷贝，图片和彩色图例可能无法显示。

编程接口信息

编程接口信息用来帮助您使用此程序来创建应用软件。

通用编程接口允许您编写获取此程序工具的服务的应用软件。

然而，本信息还可能包含诊断、修改和调整信息。诊断、修改和调整信息用来帮助您调试应用软件。

警告：不要将此诊断、修改和调整信息用作编程接口，因为它是会更改的。

商标和服务标记

下列各项是 International Business Machines Corporation 在美国和／或其他国家或地区的商标：

Java 和所有基于 Java 的商标是 Sun Microsystems,Inc. 在美国和／或其他国家或地区的商标。

Windows® 和 Windows NT® 是 Microsoft® Corporation 在美国和／或其他国家或地区的商标。

Intel® 和 Pentium® 是 Intel Corporation 或其子公司在美国和／或其他国家或地区的商标或注册商标。

Linux® 是 Linus Torvalds 在美国和／或其他国家或地区的商标。

其他公司、产品或服务名称可能是其他公司的商标或服务标记。