XML 工具 - 发行说明

1.0 简介
2.0 对前发行版的更改
3.0 限制
   3.1 XSL 转换和调试
4.0 已知问题
   4.1 打开大型 XML 文件可能会导致工作台突然关闭
   4.2 XML 至 SQL 不支持 BLOB、CLOB 和 Binary 数据类型
   4.3 XML 至 SQL 可能会对不正确的日期或时间格式抛出 SQLException
   4.4 从阿拉伯语/希伯莱语机器上的数据库表生成 XML 模式
   4.5 为 DBCS 机器上的 DB2 XML Extender 生成测试装置和 DAD 文件
   4.6 从包含 DBCS 字符的数据库表生成 XML 模式
   4.7 将带有无限循环的 XSL 样式表应用于 XML 文件
   4.8 在远程 XSL 启动程序中不能识别 XML 目录设置
   4.9 在不使用“从 XHTML 抽取 XML 数据”选项的情况下为 XHTML 模板生成 XSL
   4.10 重新装入不会更改 RMX 和 XMX 编辑器中的任何内容
   4.11 验证和不可解析的 URI
   4.12 如果 bean 具有参数名相同的多个方法,则使用 Java Bean XML/XSL 客户机向导时会发生问题
   4.13 生成 XML 模式或 DTD 文件时可能会遇到 BiDi 编码问题
   4.14 当跟踪远程 XML 转换时,XSL 转换输出视图为空
   4.15 在 XML 模式中重命名名称空间将创建新的名称空间
   4.16 XSL 调试器忽略断点上的启用/禁用标志。

1.0 简介

在 WebSphere Studio 中具有下列 XML 开发环境工具:XML 编辑器、DTD 编辑器、XML 模式编辑器、XSL 编辑器、XSL 调试和转换工具、XML 至 XML 映射编辑器和 RDB 至 XML 映射编辑器(可以使用该编辑器来为 DB2 XML Extender 生成 DAD 文件)。还包括用于从任何 JDBC 数据库存储和检索 XML 数据的 Java 类库和向导、XML 安全性支持、XPath 表达式向导和许多生成器(例如,从 Java bean 生成 XML DOM/XSL 和从 XHTML 文件生成 XSL/XML)。

2.0 对前发行版的更改

已经对 WebSphere Studio V5.1 进行了下列增强:

3.0 限制

3.1 XSL 转换和调试

如果 XML/XSL 文件的路径或文件名具有非 ascii 字符,则 XSL 调试和转换可能不能正确工作。

4.0 已知问题

4.1 打开大型 XML 文件可能会导致工作台突然关闭

当使用任何 XML 编辑器打开大型文件时,务必谨慎操作。如果超出工作台的内存限制,工作台就会突然关闭,而不会保存任何数据(并且没有警告或错误消息)。XML 文件中的元素数目(而不是文件大小)是所需内存量的最佳指示符。内存需求也取决于在工作台中打开的其它内容 - 在某些情况下,可以打开 15 兆字节的文件,但是在其它情况下,打开 1 兆字节的文件也可能会引起问题。因此,建议您在打开大型 XML 文件之前保存工作台中的所有数据。

注意:可以更改分配给 WebSphere Studio 的最大内存量。有关更多信息,参阅工作台自述文件。

4.2 XML 至 SQL 不支持 BLOB、CLOB 和 Binary 数据类型

当列类型为 Binary、BLOB 或 CLOB 时,XML 至 SQL 不会正确地更新数据库表。这适用于 INSERT 和 UPDATE 操作。

4.3 XML 至 SQL 可能会对不正确的日期或时间格式抛出 SQLException

当更新具有 Date、Time 或 Timestamp 数据类型的列的数据库表时,如果目标数据库产品不接受输入 XML 源中的字符串值,则 XML 至 SQL 向导或 xmltosql 和 sqltoxml JAR 文件可能会抛出 SQLException。一个产品与另一个产品的日期和时间格式稍微有所不同。可以使用 SQL 查询构建器来确定这些类型的正确格式。

4.4 从阿拉伯语/或希伯莱语机器上的数据库表生成 XML 模式

当从数据库表生成 XML 模式文件时,“任务”窗格中可能会产生以下错误消息(尤其是在阿拉伯语或希伯莱语平台上):“文件提前结束”。

不过,仍将正确地生成模式文件。刷新您指定的目标工作空间文件夹,然后使用 XSD 编辑器打开该文件。

4.5 为 DBCS 机器上的 DB2 XML Extender 生成测试装置和 DAD 文件

如果要在 Windows 上生成测试装置文件,则生成的批处理文件将 CR 用作行定界符(虽然这些文件应该将 CRLF 用作行定界符)。结果,这些文件可能不能正确运行。在这种情况下,使用文本编辑器(例如,记事本)手工插入行定界符。

另外要注意,应该使用平台的缺省编码生成 DAD 文件,该文件才能正确运行。可以通过从 XML 文件首选项编辑器选择正确的编码值来完成此任务。

4.6 从包含 DBCS 字符的数据库表生成 XML 模式

如果根据包含全角字母和数字名称的数据库表来生成 XML 模式,则在“任务”视图中将接收到错误。建议不要使数据库表名和列名中包含 DBCS 字符。

4.7 将带有无限循环的 XSL 样式表应用于 XML 文件

如果应用于 XML 文件的 XSL 样式表中具有无限循环,则可能会接收到类似如下的错误消息:
Xalan 停止并抛出 java.lang.StackOverflowError,
很有可能是由于深度递归引起的

应在重新运行转换之前修正样式表。如果不修正样式表并立即重新运行转换,则可能会接收到另一条错误消息 - 发生此错误的原因是在虚拟机中的另一个位置可能发生了内存故障。如果发生此错误,则应关闭 WebSphere Studio,重新启动它并修正 XSL 样式表以清除各事项。

4.8 在远程 XSL 启动程序中不能识别 XML 目录设置

当针对包括 DTD 或 XSD 文件的 XML 文件应用 XSL 文件时,将执行您在 XML 目录中的任何设置(如果您在本地 XSL 进程中启动 XSL 调试器的话)。

如果 XSL 文件调用外部 Java bean 并且您必须在远程 XSL 进程中启动 XSL 调试器,则不执行 XML 目录中键映射的 URI 并且您将接收到 java.io.FileNotFound 异常。

要解决此问题,更改 XML 文件以便可以直接定位包括的 DTD 或 XSD(即,不需要通过 XML 目录)。

4.9 在不使用“从 XHTML 抽取 XML 数据”选项的情况下为 XHTML 模板生成 XSL

当数据已存储在 XML 文件中时,您将调用“XHTML 模板的 XSL”向导而不需要选择“从 XHTML 抽取 XML 数据”选项。

由于当前限制,必须手工编辑向导生成的 dataLogic 文件以指定特定于 XML 文件的与数据相关的逻辑,该 XML 文件是转换的主题。示例 dataLogic 文件包括在“从 XSL 和 HTML 创建 XML”示例项目中。

如果不手工编辑与数据相关的逻辑文件,则 XSL 文件将产生不包括任何数据的框架 HTML 文件。

4.10 重新装入不会更改 RMX 和 XMX 编辑器中的任何内容

当在磁盘上更改编辑的文件的内容时所提示的重新装入选项不执行任何操作。对于“小组支持”,要特别注意这一点。在用户检出文件并且该文件的内容与编辑器中文件的内容不同的情况下,编辑器将提示用户重新装入,但重新装入操作将不执行任何操作。在这种情况下,应关闭 RMX 至 XMX 的会话并重新打开它以编辑新检出的文件。

4.11 验证和不可解析的 URI

当遇到不可解析的 URI(例如,在 DOCTYPE 声明中)时 XML 解析器的行为是报告一个致命 IO 错误并且停止任何进一步的处理。不可解析的 URI 看上去既不是语法错误,也不是语义错误,因此,解析器不会尝试处理它。实际上,文档保持未选择状态。

4.12 如果 bean 具有参数名相同的多个方法,则使用 Java Bean XML/XSL 客户机向导时会发生问题

对于“Java Bean XML/XSL 客户机”向导,如果 bean 具有相同参数名的多个方法,则还会用相同的名称生成输入表单的字段。

变通方法是重命名方法参数,以便用于生成 bean 的方法的参数名不发生重复。

4.13 生成 XML 模式或 DTD 文件时可能会遇到 BiDi 编码问题

当从包含希伯莱语或阿拉伯语元素的 DTD 文件生成 XML 模式或从包含希伯莱语或阿拉伯语元素的 XML 模式生成 DTD 时,可能会用某些元素名称的等价十六进制希伯莱语和阿拉伯语编码值对这些元素名称进行编码。要避免此问题,在执行生成之前将原始 DTD 或 XML 模式文件的编码属性更改为 UTF-8:即,XML 声明应为:

<?xml version="1.0" encoding="UTF-8"?>

受影响的编码值列表为:

4.14 当跟踪远程 XML 转换时,XSL 转换输出视图为空

当跟踪在远程应用程序上启动的 XSL 转换时,XSL 调试透视图中的“XSL 转换”输出视图将不会显示任何输出。

4.15 在 XML 模式中重命名名称空间将创建新的名称空间

如果您更改 XML 模式中的目标名称空间,则会使用前缀 Q1 来创建新的名称空间。为了避免这种情况,首先应将全局元素和类型(在实际引用它们之前)移至文档顶部。然后,应用目标名称空间更改。

4.16 XSL 调试器忽略断点上的启用/禁用标志。

可以从 XSL 编辑器弹出菜单中选择启用断点禁用断点,但是 XSL 调试器会忽略断点上的启用/禁用标志。

返回到主自述文件