test

Service Registry 3 2005Q4 发行说明

第 1 章 Service Registry 3 2005Q4 发行说明

本文档提供了 Service Registry 3 2005Q4 的以下信息。

Service Registry 3 2005Q4 中的新增功能

本节介绍 Service Registry 3 2005Q4 中的新增功能、功能性以及所支持的产品。

残疾人士辅助功能

要获得自本介质发行以来所发布的辅助功能，请参考 Sun 提供的关于 "Section 508" 标 准符合性的产品评估文档，以确定哪些版本最适合部署辅助功能解决方案。可在以下网址找到应用程序的更新版本：http://sun.com/software/javaenterprisesystem/get.html。有关 Sun 在辅助功能方面所做的承诺，请访问 http://sun.com/access。

特定于实现的 API

Service Registry 实现了 Java API for XML Registries (JAXR) 规范 1.0 版。编写 JAXR 1.0 是为了支持 UDDI 和 ebXML Registry 2.0 规范。在 Service Registry 中实现 JAXR 时，针对 JAXR 1.0 附加了一些非标准的规范内容。由于这些 API 附加内容将被考虑添加到未来的 JAXR 标准中，因此它们会对将来版本的 JAXR 规范有所帮助。

在将来的 Service Registry 发行版中这些 API 附加内容会有所变更。Sun 将尽量保持 将来 Service Registry 发行版中的这些 API 的向后兼容性。在某些情况下，可能无法实 现向后兼容性。建议要使用这些 API 附加内容的客户注意在将来发行版的 Service Registry JAXR 提供者中的这些内容可能会发生的变更。

将要取消的功能

用户注册机制

此发行版的 Service Registry 有其自己的用户管理和验证机制。计划在将来的发行版中将 Registry 更新为采用基于 SAML 的机制（如 ebXML Registry 标准中所述，此组件是该标准中的一个实现），并将在相应的发行版及其以后的发行版中使用 Access Manager 进行用户管理和验证。

在此发行版中，Service Registry 客户的用户注册信息由 Service Registry 维护。在将来的发行版及其以后的发行版中，客户的这些信息将由 Access Manager 维护。要升级至某一将来的 Service Registry 版本的客户需要将他们的用户信息迁移至 Access Manager，以便维持注册用户和 Registry 内容之间建立的连接（例如，审计追踪）。Sun 打算提供一个迁移工具用来简化此迁移。

此发行版中修复的错误

下表列出了在 Beta 中报告并在 Service Registry 3 2005Q4 中已修复的错误。

表 1–1 此发行版中修复的错误

错误号 

说明 

6253534 

详细信息面板弹出式窗口的运行出现错误（Web 控制台） 

6254054 

插槽弹出式面板重复（Web 控制台） 

6262387 

Web 控制台运行速度慢 

6268023 

添加子组织时，实际上却将组织添加到其自身（Web 控制台） 

6268025 

SpecificationLink 的详细信息面板缺少“用法参数”字段（Web 控制台）

6268029 

ClassificationScheme 详细信息面板不显示任何子概念（Web 控制台）

6268048 

将子概念添加到 ClassificationScheme 中导致出现错误（Web 控制台）

6268163、6288713 

Web 控制台中的文档链接损坏 

6268961 

AuditableEvent.getRegistryObject 返回 AuditableEvent 对象（JAXR 提供者）

6269991 

创建新的 ExtrinsicObject 过程中，选择对象类型时显示错误的树（Web 控制台）

6272143 

在 Application Server 上部署 JAXR RA 时报告错误 

6272183、6277552 

Service Registry3 安装后额外的配置步骤 

6273999 

重复的组件 ID 异常 

6276299、6277679 

“用户注册向导”中的“上载文件”窗口挂起（Web 控制台） 

6276674 

标签包含重复的 X（Web 控制台） 

6276701 

单击“详细联系信息”时抛出异常（Web 控制台） 

6277675 

使用“生成关键字对和下载 PKCS12 密钥库”选项时用户注册失败（Web 控制台） 

6278540 

用户执行禁止的操作时没有出现错误消息（Web 控制台） 

6279674 

将系统信息库项添加到保存的 ExtrinsicObject 中时出现错误（Web 控制台）

6280492 

Web 控制台需要单独的“保存”和“应用”按钮（Web 控制台） 

6281089 

迭代查询重复显示以前的结果（JAXR 提供者） 

6281292 

管理工具需要 UUID 而不是 URN（管理工具） 

6284357 

出现涉及 ExtrinsicObject 对象的 Web 控制台错误

Beta 中报告的下列 JAXR 提供者错误的优先级别已降低：

已知问题和错误

下列已知问题和错误会影响 Service Registry 3 2005Q4 发行版的操作。

无法检索 Organization 对象的 EmailAddress 对象 (6290339)

问题摘要：JAXR 提供者无法从 Organization 对象检索电子邮件地址。如果您发布一个包含电子邮件地址的 Organization 对象，发布看上去成功了，但 OrganizationImpl.getEmailAddresses 方法未返回任何结果。该问题还会导致 Web 控制台中显示空的结果。

执行发布操作时，ClassificationScheme 显示保持不变 (6297023)

问题摘要：在 Web 控制台中，如果在发布对象（如 ExtrinsicObject 或 ExternalLink）时选择了 ClassificationScheme 中的概念，则下次发布其他对象时，会在同一位置打开 ClassificationScheme 窗口，即使该对象属于不同的对象类型也是如此。

类似地，如果您按分类执行搜索，再执行一些关闭“搜索”表单的其他操作（例如发布操作），然后再打开“搜索”表单，则 ClassificationScheme 的显示与关闭“搜索”表单时相同。

尝试创建 Organization 对象之间的引用导致出现错误 (6298946)

问题摘要：在 Web 控制台中，如果您对两个 Organization 对象选中了“拾取”复选框并单击“关联”，然后单击“保存”以保存默认关系（对象引用），则 Web 控制台报告错误，但没有详细的错误消息。服务器日志中将显示堆栈追踪。

将新的系统信息库项添加到外部对象时丢失内容版本注释 (6301689)

问题摘要：在 Web 控制台中，如果您发布不含系统信息库项的 ExtrinsicObject，然后添加系统信息库项并为该系统信息库项提供内容版本注释，则在保存了更改的 ExtrinsicObject 后搜索该项时，将不显示内容版本注释。

重复的用户名导致出现意义不确切的错误消息 (6303812)

问题摘要：在 Web 控制台中，当用户尝试创建具有生成的证书的用户帐户，并指定对于服务器来说已知的别名时，在 Web 控制台中“步骤 3”页面上将出现以下错误消息：

出现错误。请参见服务器日志或与 Registry 支持部门联系。

解决方法：检查服务器日志。可在堆栈追踪中找到根源：

Caused by: java.lang.Exception: Key pair not generated, alias name already 
exists

一些搜索返回意外的结果 (6312083)

问题摘要：在 Web 控制台中，按名称搜索人员或用户对象时，无法返回数据库中任何预定义的用户，或具有定义的“人名”（不是“名称”）的任何人员或用户。此外，搜索其名称包含特定数目字符的对象（例如使用搜索字符串 "__" 查找两个字符的名称）时，返回许多其名称包含非指定数目字符的对象。

创建证书标识名时，注册向导忽略必需的值 (6312094)

问题摘要：在 Web 控制台中，用户注册向导在为其生成的证书创建标识名 (Distinguished Name, DN) 时，将使用一些您在“新用户详细信息”页面中指定的可选值（“国家/地区”、“省/自治区/直辖市”以及“城市”）。但该向导将只使用您在“用户验证详细信息”页面中指定的一个必需值，而忽略所有其他值。（它使用的唯一值是“名称”值。）

解决方法：要在证书 DN 中包括“城市”、“省/自治区/直辖市”或“国家/地区”，请在“新用户详细信息”页面以及“用户验证详细信息”页面中指定这些值。

尝试为 ExternalLink 和 ServiceBinding 对象设置 URI 失败 (6312531)

问题摘要：如果在配置 Service Registry 后，管理员忘记为部署了 Registry 的 Application Server 实例的 JavaTM 虚拟机 (Java Virtual Machine, JVM) 设置代理主机和端口，则 Web 控制台用户无法为 ExternalLink 对象指定外部 URI，或为 ServiceBinding 对象指定访问 URI。当 URI 格式实际上正确时，错误消息报告其无效。

解决方法：按《Service Registry 3 2005Q4 管理指南》中的“允许访问外部 Web 站点”所述设置代理主机和端口。

Service Registry 重新安装后配置失败 (6313327)

问题摘要：如果您使用 Java Enterprise System 卸载程序卸载 Service Registry，则重新安装并执行安装后配置时，配置脚本运行失败并显示以下错误消息：

域注册表已存在。请指定其他域。

问题在于卸载程序并不停止或删除 Registry 的 Application Server 域。必须手动执行该任务。

解决方法：在重新安装 Service Registry 之前，请停止 Registry 的 Application Server 域，然后删除该域。有关详细信息，请参见《Service Registry 3 2005Q4 管理指南》中的“重新安装 Service Registry”。

使用 -alias 选项时，管理工具运行失败 (6313791)

问题摘要：如果您尝试使用管理工具执行需要管理员权限的任务，则将出现堆栈追踪和 NoClassDefFoundError。出现该错误的原因是管理工具 JAR 文件的清单类路径中缺少文件。

解决方法：按照《Service Registry 3 2005Q4 管理指南》中的“使用管理工具”中的说明进行操作。

创建使用无效概念的 ExtrinsicObject 或 ExternalLink 后出现错误 (6318002)

问题摘要：在 Web 控制台中，如果您创建了一个 ExtrinsicObject 并选择了不属于 ExtrinsicObject 的概念的概念，则创建看上去成功了，但实际上出现了错误。当您创建了 ExternalLink 并选择了不属于 ExternalLink 的概念的概念时，也会出现该问题。

在服务器日志中，这些错误显示为 NullPointerException。

如果概念是属于 RegistryObject 的另一个子概念，则主要影响是搜索新对象时找不到新对象。如果概念是属于 ClassificationScheme 而不是 ObjectType，则将损坏数据库。当您重新启动服务器时，出现运行时错误 (InvocationTargetException)。

对象类型概念必须是 ExtrinsicObject 或 ExternalLink 概念中的子概念，但 Web 控制台并不强制此要求。

解决方法：使用管理工具查找使用了错误概念的对象。使用 select 命令查找对象，并使用 rm 删除它们。该任务的步骤如下。

  1. 按《Service Registry 3 2005Q4 管理指南》中的“停止并重新启动用于 Registry 的 Application Server 域”所述重新启动 Service Registry。

  2. 按《Service Registry 3 2005Q4 管理指南》中的“启动管理工具”所述以注册表管理员或损坏对象的拥有者身份启动管理工具。

  3. 转至数据库中的顶层位置：


    admin> cd /

  4. 使用 select 命令列出要删除的对象。如果您是以注册表管理员身份启动了该工具，则使用以下命令（全部在一行）：


    admin> select ro.* FROM RegistryObject ro, ClassificationNode cn 
WHERE ro.objectType = cn.id AND NOT ( cn.path = 
'/urn:oasis:names:tc:ebxml-regrep:classificationScheme:ObjectType
/RegistryObject' 
or cn.path like 
'/urn:oasis:names:tc:ebxml-regrep:classificationScheme:ObjectType
/RegistryObject/%' )

    如果您是以对象的拥有者身份启动了该工具，则使用以下命令（全部在一行）：


    admin> select ro.* FROM RegistryObject ro, ClassificationNode cn, 
AffectedObject ao, AuditableEvent ae WHERE ro.objectType = cn.id AND 
ae.user_ = $currentUser AND ao.id = ro.id AND ao.eventId = ae.id AND NOT 
( cn.path = 
'/urn:oasis:names:tc:ebxml-regrep:classificationScheme:ObjectType
/RegistryObject' 
or cn.path like 
'/urn:oasis:names:tc:ebxml-regrep:classificationScheme:ObjectType
/RegistryObject/%' )

  5. 使用 rm 命令删除对象。指定要删除的每个对象的 URN。


    admin> rm urn1 urn2 ...

  6. 再次运行 select 命令验证这些对象是否已不在 Registry 中。

删除 AuditableEvent 造成已创建的对象出现异常 (6323057)

问题摘要：如果您删除了 AuditableEvent，而其“受影响对象”列表中包含您拥有的一个或多个对象，则将损坏受影响对象的审计追踪。尤其是删除您自己的 User 对象的已创建事件时，会出现严重问题。例如，您删除该事件后，每当您执行 FindAllMyObjects 搜索时，都会出现运行时异常。

在单击“应用”按钮之前尝试查看系统信息库项导致出现错误 (6324423)

问题摘要：在 Web 控制台中，如果您创建了一个 ExtrinsicObject 并添加了一个系统信息库项，则在您单击“保存”或“应用”按钮之前，只要您上载文件，“查看系统信息库项内容”链接就变为活动状态。如果您在单击“应用”之前单击该链接，则将出现错误 404 消息。在该链接成为有效链接之前，不应变为活动状态。

解决方法：请勿在单击“应用”之前尝试查看系统信息库项。

在后续搜索中被固定的对象重复出现 (6324437)

问题摘要：如果您使用了 Web 控制台的固定功能来固定对象的位置，则当您执行其他搜索时，该对象将多次出现在“搜索结果”区域中。

解决方法：通过单击“注销”按钮或“结束会话”按钮结束当前会话。开始新会话后，搜索操作将返回正确的结果。

Explorer 显示错误的数据 (6325095)

问题摘要：当您使用“浏览器”菜单查看 ClassificationScheme 概念时，显示具有两个概念而不是一个概念的子节点 XML 和 Registry。在两种情况下，以上节点均紧 跟着正确的节点（分别为 XMLSchema 和 RegistryPackage）显示。

重新安装 Service Registry 会删除现有的系统信息库数据库 (6329272)

问题摘要：重新安装 Service Registry 的 ant install 命令也会删除和重新安装系统信息库数据库。如果管理员以前没有备份数据库，则这会导致用户数据的永久丢失。

管理员应按照《Service Registry 3 2005Q4 管理指南》中的“重新安装 Service Registry”中的说明进行操作：在重新安装之前备份数据库。

服务器重新启动后立即登录导致出现异常 (6330540)

问题摘要：如果用户在管理员重新启动 Service Registry 后立即访问 Web 控制台，且该用户执行的第一个操作是登录，则该用户尝试搜索时将出现异常。异常与以下所示类似：

出现错误。有关详细信息，请参见以下内容：无法初始化搜索 panel. java.lang
.NullPointerException。请查看服务器日志以了解更多详细信息，或与您的 
Registry 管理员联系。

解决方法：如果您在服务器重新启动后立即访问 Web 控制台，请先执行搜索，然后再登录。

无法将 ClassificationNode 添加到现有节点中 (6331538)

问题摘要：如果您使用 Web 控制台将新概念 (ClassificationNode) 添加到现有的 ClassificationScheme 或您未创建的 ClassificationNode 中，则会出现错误，指示当前用户不具有添加新节点的权限。

解决方法：管理员具有向任何 ClassificationScheme 或 ClassificationNode 添加 ClassificationNode 的权限。可以按照《Service Registry 3 2005Q4 管理指南》中的“创建管理员”中的说明进行操作使您自己成为管理员并添加概念，也可以要求您所安装的 Service Registry 的管理员来添加概念。

修补程序和必需的固件级别

暂无。

Service Registry 3 2005Q4 文档

可在 http://docs.sun.com/app/docs/coll/1314.1 和 http://docs.sun.com/app/docs/coll/1383.1 中获得 Service Registry 文档集。要了解 Service Registry，请参阅下表中列出的书。

表 1–2 Service Registry 文档

文档标题 

内容 

《Service Registry 3 2005Q4 发行说明》

该文档包含有关 Service Registry 的最新信息（包括已知问题）。 

《Service Registry 3 2005Q4 管理指南》

该文档介绍如何在安装 Service Registry 之后对其进行配置以及如何使用 Registry 附带的管理工具，还介绍了如何执行其他管理任务。 

《Service Registry 3 2005Q4 用户指南》

该文档介绍如何使用 Service Registry Web 控制台搜索 Service Registry 及向其中发布数据。 

《Service Registry 3 2005Q4 Developer’s Guide》

该文档介绍如何使用 Java API for XML Registries (JAXR) 搜索 Service Registry 及向其中发布数据。 

本地化问题

Service Registry 3 2005Q4 中的下列错误与本地化有关。

Web 控制台中有一些字符串未本地化 (6276676)

问题摘要：在 Web 控制台中，有些应本地化的字符串显示为英语。这包括“创建新注册表对象”页面中的选项卡；“自定义”页面中的支持语言列表；“欢迎”页面、版权文字及标题区域；电话号码和电子邮件地址类型的下拉式列表；以及日志消息。此外，当您切换浏览器语言环境并重置语言时，有些标签仍保持以前的语言。

对于外部对象，不支持多字节文件名 (6298088)

问题摘要：在 Web 控制台中，如果您选择具有多字节名称的文件作为 ExtrinsicObject 的系统信息库项，则文件名将被损坏，并且将无法查看文件。

UDDI 资源包未本地化 (6305138)

问题摘要：Service Registry 的 UDDI 界面的资源包未本地化。在此界面中操作时出现的错误消息均只为英语。

如果 Application Server 域使用了非英语语言环境，则注册表将无法使用英语语言环境 (6305210)

问题摘要：如果您使用非英语语言环境启动 Service Registry 的 Application Server 域，则无法将 Web 控制台的默认语言更改为英语，即使您在 Web 浏览器中将默认语言环境更改为英语也是如此。

解决方法：使用管理控制台来更改 Application Server 域的语言环境。

  1. 打开管理控制台；有关说明，请参见《Service Registry 3 2005Q4 管理指南》中的“使用 Application Server 管理控制台”。

  2. 展开“独立实例”节点，然后单击“服务器（管理服务器）”。

  3. 单击“高级”选项卡。

  4. 单击“域属性”选项卡。

  5. 在“语言环境”字段中，键入 en。

  6. 单击“保存”。

联机帮助字符串有错误的法语翻译 (6313372)

问题摘要：在使用法语语言环境的 Web 控制台中，“注册表对象”区域的右上角的“帮助”链接为 “Objets du registre Aide”，它应为 “Aide Objets du Registre” 或 “Aide pour les Objets du Registre”。

在非默认语言环境中创建的对象没有名称 (6316300)

问题摘要：如果默认的语言环境与您的语言环境不同，且您使用 Web 控制台创建了一个对象，则当您单击“应用”时，该对象的名称显示为 null，即使您在“名称”字段中为该对象键入了一个值也是如此。

非英语语言环境的 Web 控制台包含未本地化的字符串 (6317212, 6317242, 6317489, 6317568, 6322668, 6325023)

问题摘要：Web 控制台中的一些字符串没有针对非英语的语言环境本地化，或未正确本地化。

使用 -locale 选项时，管理工具未正确启动 (6325116)

问题摘要：如果您启动管理工具时使用 -locale 选项指定了非英语语言环境，则消息以英语而不是指定的语言环境显示。

文档问题

Service Registry 3 2005Q4 中的下列错误与文档相关。

按名称查询时，对于每种典型的 ClassificationScheme 都检索到多份 (6307262)

问题摘要：假定开发者指南样例程序 JAXRGetCanonicalSchemes.java 从 Registry 检索 18 种典型分类方案及其概念，该程序实际上对每种分类方案检索八份，则总共有 144 份。该问题实际上是本地化问题，因为该程序针对每种支持的语言环境都检索一份分类方案。