Sun™ Java™ Studio Enterprise 7 2004Q4 发行说明

有关 Java Studio Enterprise IDE 新发行版本的最新信息，请参阅开发人员资源 Web 站点 http://developers.sun.com/jsenterprise

本发行说明部分...	提供信息...
A. 简介	本发行说明与 Java Studio Enterprise 产品的简介。
B. 新内容：增强功能与新功能	此发行版本的 Java Studio Enterprise 产品的新功能和增强功能。
C. 限制	Java Studio Enterprise IDE 的使用限制。
D. 系统需求	在任何受支持的平台上安装 Java Studio Enterprise 最低配置所需的硬件需求。
E. 操作系统、服务器、数据库、ORB 和版本控制系统	此发行版本支持的操作系统和其他软件。
F. 平台	运行 Java Studio Enterprise IDE 的操作系统。
G. 安装说明	介绍了新的安装过程中的重要步骤，此过程分为两个部分，并且具有灵活的安装选项。
H. 模块说明	有关各个模块的信息。
I. 错误与问题	列出了与此发行版本产品的功能相关的错误和问题，并提供了可行的解决方法。
J. 辅助功能	本产品的辅助功能。
K. NetBeans 开放源代码项目	有关 NetBeans 开放源代码项目的信息来源。
L. 可再发行文件	Java Studio Enterprise 产品的 IDE 部分随附的可再发行的二进制文件。
M. 指向 Sun Java Studio Enterprise 产品捆绑的选定服务器产品发行说明的链接	Java Studio Enterprise 产品捆绑的选定服务器的发行说明链接表。

A. 简介

Sun Java Studio Enterprise 将 Sun 的开发人员工具和服务器产品合并为一个企业级的集成开发环境 (IDE)。IDE 支持在同时属于 Java System 的服务器上实施从开发到部署的方案。

此最新发行版本的 IDE 提供了一些工具和功能，用于提高每位软件开发人员和整个团队的生产力及工作效率：

• 利用新的 UML 可视且直观的建模功能，可以快速显示您的代码结构。

• 利用新的性能分析功能，可以快速查找应用程序中出现的问题。

• 利用新的协作功能，可以实现在 IDE 中与他人一起解决复杂的问题。

• 利用新的重构功能，可以快速复用少量或大量的代码。

B. 新内容：增强功能与新功能

Sun Java Studio Enterprise 产品中的 IDE 集成了以下新功能。（另请参阅模块说明。）

• UML 2.0 建模支持。IDE 集成了 UML 建模功能。该功能完全遵循现有的 UML 标准以及即将发布的 UML 2.0 规范。这种功能具有以下优点：
  • 支持 UML 中的所有图、对象、属性以及定义的关系

  • 动态的无标记双向工程建模以及实时的源代码同步

  • 基于模式开发的设计中心（包含一个模式目录）并且支持定制模式

  • 无标记逆向工程，可帮助您快速分析现有的代码库

  • 可以为 UML 项目生成 HTML 文档

• 企业应用分析。IDE 包含一个分析器，可以提供下列功能：
  • 全方位 J2EE 事务监视。在 J2EE 应用程序中捕获所有基于浏览器的事务详细信息，包括事务双向工程。以表格和图表的形式列出数据以便进行详细分析。

  • 方法级别的性能分析。利用另存为可检索的结果树的性能信息，分析应用程序的设计及行为，并且可以有选择地对部署在目标应用服务器上的任何应用程序的方法进行分析。

  • 内存性能分析。捕获应用服务器中的内存数据，并显示其随时间的变化情况。

  • 负载测试。模拟负载情况（用户数、每位用户的延迟时间），并在应用程序开发早期对应用程序的设计进行压力测试。

• 支持协作开发。Sun Java Studio 的开发人员协作功能提供：
  • 可识别代码的即时消息传送。通过 Intranet 或 Internet 及防火墙与工作组中的多位开发人员进行交流。此功能使用代码编辑功能（如语法着色、代码完成以及代码文档的弹出式窗口）来解释 Java、XML 和 HTML 代码。

  • 实时文件共享。组织代码检查工作，并与分布式团队中的多个成员进行协作。您的团队成员可以同时处理同一个文件的不同部分。利用临时的保护块描述，用户可以直观地对共享文件进行协作。

• 重构支持。IDE 包含一个可用来快速重构应用程序的模块。利用此重构功能可以实现：
  • 移动和重命名类、字段及方法

  • 查找使用实例

  • 封装字段

  • 提取方法

• JavaHelp 2。IDE 使用最新的 JavaHelp 发行版本，它为 IDE 用户提供了一些改进功能，例如多主题打印。

• 修复早期存在的问题：
  • 安装。现在，可以将 JSE 门户安装在使用 Windows FAT32 的多分区计算机上。（此错误编号为 5006945。）

  • 调试 EJB。IDE 的调试功能已得到改进。

  • 性能。IDE 中新增的 NetBeans 窗口布局功能（将在后面介绍）以及性能优化功能，消除了早期发行版本中存在的各种问题。

• 包含 NetBeans 3.6 的大部分功能。新的 IDE 基于 NetBeans 3.6，但不具备 J2EE 1.3 级别支持的 J2EE 和 Web 开发功能。

• 全新外观。IDE 完美的全新外观与其内在的操作系统可谓是相得益彰：Windows 的原有外观以及所有其他平台的 Java（金属）外观。（要设置不同的外观，请使用 --laf LaF_class-Name 开关启动 IDE。）此外，经过重新设计的 IDE 属性表单为您查看所有对象属性提供了更佳的视图效果。

• 新增的窗口布局功能。现在，您可以轻松地拖放窗口并预览新的窗口布局。可以更快速、便捷地导航：使用 Ctrl-`，在打开的 IDE 窗口和文档之间切换。启动特定任务时，系统将自动显示与该任务相关的窗口。

• 新增和改进的编辑功能。源代码编辑器支持代码折叠。IDE 会自动插入结束的方括号、引号和圆括号。编辑器中标记的待编辑项会无缝地显示在“待做事项”窗口中。并且继承的方法也会自动标注在空白区域中。源代码编辑器在鼠标悬停时所出现的工具提示中显示编译错误，并且源代码编辑器允许您同时查看多个文档，并与窗体编辑器集成。您可以将任何 Java 文件作为 HTML 输出以进行 Web 发布。利用“克隆文档”，可同时查看文档的不同部分。

• Ant 1.6.1 支持。可以更轻松地管理 Ant 类路径和 Ant 版本。

• JUnit 3.8.1 支持。您可以在文本和 GUI 模式下自动生成测试和测试套件。

• 版本控制集成。IDE 现在支持用于 Windows 平台的 PVCS 和 Microsoft Visual SourceSafe (VSS)。在 CVS 中，客户端和命令行界面现在使用相同的 GUI。VCS 命令输出的显示已得到改进。

C. 限制

• 将开发人员协作功能与防火墙结合使用。
  如果您在使用“协作”和 IM 服务器时，不希望关闭系统防火墙，则可以访问端口 5222。

• UML 建模限制。
  • UML 建模双向工程和逆向工程功能不支持在方法内定义的类。

  • 在此发行版本的 UML 建模功能中，EJB 设计模式不支持在 IDE 中部署 EJB 组件，也不支持部署 IDE 的 EJB 测试客户端。（错误 5077421）

  • 某些所需的 import 语句未插入到已生成类的源代码中。但是，可以在源代码编辑器中手动增加它们，即从上下文菜单中选择“增加 import”。

  • 要访问签入到源代码库中的 UML 项目，您必须将 Java Studio 项目命名为最初创建 UML 项目时使用的名称。在协同工作环境中，所有团队成员必须使用相同的 Java Studio 项目名称。

• 每个用户目录包含一个 IDE 实例。在 NetBeans 3.6 发行版本中，多个 IDE 实例不能再同时使用同一个用户目录。

D. 系统需求

下表列出了在任何支持的平台上安装 IDE 配置的系统需求。左列表示需求类型：硬件系统、内存和磁盘空间。右列表示每个平台的需求。

注意：在 UltraSPARC® III 和 x86 上运行 Gnome 的 Solaris™ 10 平台已通过测试，但此发行版本的 IDE 不支持它。

注意：可选服务器所需的大部分空间用于安装路径，而大约 80 MB 的空间用于 /var/opt 和 /etc/opt。

E. 操作系统、服务器、数据库、ORB 和版本控制系统

下表显示了 Sun Java Studio Enterprise IDE 支持的产品。

SunRay 服务器作为多用户平台受到支持。
受支持的 UML 版本为 UML 2.0 Draft（草案）。

所有捆绑服务器均包括本地和远程配置，但是 Web 服务器除外，它不支持远程部署。

F. 平台

软件平台：

J2EE：

• J2EE 1.3（自动将 J2EE 1.2 或更低版本的文件转换为 J2EE 1.3）

J2SE：

• JDK 1.4.2_05（仅适用于 32 位 JVM） - 这是经过验证的平台。
• JDK 1.4.1_06（仅适用于 32 位 JVM）

多用户硬件平台：

SunRay 服务器

注意：Java Studio Enterprise 软件包含 Java Enterprise System 专用于开发的所有组件。在部署时不能使用这些许可证。

G. 安装说明

Sun Java Studio 以一张 DVD、两张 CD 或两个下载文件的形式，提供了一整套的工具和服务器。您可以快速安装需要立即使用的工具，然后在任何方便的时候安装可选服务器。可以根据需要定制您的下载及安装。

例如，如果您已经安装了支持的服务器，则可能希望只安装 IDE。或者，希望只安装所需的服务器。安装程序会实现所有必需的相关性。

DVD 中包含了一些文件，这些文件中含有为所有受支持平台提供的 IDE 及所有捆绑组件。两张 CD 或两个下载文件（分别为每个平台提供一套）中包含以下组件和服务器。

CD 1 或文件 1 工具组件	Java Studio Enterprise IDE 应用服务器 消息队列 协作运行环境
CD 2 或文件 2 可选服务器	Web 服务器 目录服务器 访问管理器 门户服务器

在插入 DVD 时，不会自动调用安装程序。而是出现一个 Web 页，要求您进行选择。

请参阅《Sun Java Studio 安装指南》，以获得安装该产品的完整信息。

H. 模块说明

UML 建模

• 如果您已使用 UML 建模功能对类进行建模，并随后使用编辑器手动定义了一个字段，那么 IDE 会自动增加一个 getter 方法和一个 setter 方法。如果您创建了一个类，而后使用 UML 建模功能处理代码（例如，“逆向工程”或“工具”>“通过源更新模型”），那么当您在源代码编辑器中打开源代码时，也会发生上述情况。对于尚未获得 getter 和 setter 方法的任何字段，IDE 都会自动为其创建这些方法。

  若要禁止 IDE 增加这些方法，请执行以下操作：

  主菜单 > 建模 > 首选项 > 双向工程 > Java > 创建存取 (Accessor) 方法

  将此特性设置为“否”。

• 如果转到项目树中更改注释元素的名称，则新注释名称还会替换注释的主体文本。（错误 5070917）
  解决方法：使用 UML 属性编辑器重命名该注释。

重构

• 在执行某些重构操作后，可能会发生编译错误。
  使用“重构”子菜单操作对代码进行重构时，IDE 会警告您如果继续进行重构操作，则有可能产生大部分（并非全部）编译错误。下表显示了一些 IDE 虽不捕获但却有可能发生的编译错误。
  IDE 不显示的警告有：
  • 将受保护成员的类移到另一个包中（错误 5081618）。

  • 重命名被某些类覆盖的方法，这些类可以扩展类（错误 5074837 和 5069665）。

  • 移动被覆盖的方法、进行覆盖的方法、被覆盖的字段或进行覆盖的字段（错误 5075343、5082178 和 5082230）。

  解决方法：在每次重构操作后，请从“生成”菜单中选择“全部生成”以确保没有任何代码中断。如果每次重构操作后执行上述解决方法，则可以比较容易地诊断出错误。每次重构操作后运行 JUnit 测试也是一种很好的做法。

• 请注意重构和 UML 建模之间的交互操作。
  如果项目与 UML 建模关联，并且您希望使用重构操作，则最好创建一个新项目并使用该项目进行重构。如果已对代码执行逆向工程或同步，则项目会与 UML 建模相关联。
  在源代码中使用重构操作时，UML 建模会监视并应用这些自动操作，从而会产生以下问题。

  如果对包含 getter 和 setter 方法的字段使用“重构”>“重命名”操作，则 UML 建模会发现名称更改，并自动更改 getter 和 setter 方法名称。因此，即使“重构预览”窗口不显示 getter 和 setter 方法，它们也会被更改。

  虽然重构操作更改所有已安装源代码中的字段名称，但 UML 建模只更改当前源文件中的 getter 和 setter 名称，因而会影响任何使用这些方法的其他类。为避免出现这些问题，请手动将方法名称改回为原始名称。

Web 应用程序框架

您可能发现在上下文菜单上没有启用“执行页”>“执行页（重新部署）”。如果出现这种情况，请右键单击“基本 ViewBean（页）”来执行该页。如果没有启用此选项，请右键单击应用程序并选择“标识模块”。

I. 错误与问题

安装
性能分析
UML 建模
协作
重构
Portlet Builder
JavaServer Pages
Web 应用程序框架
服务器
J2EE 调试器
版本控制
其他

安装

4973270 在无提示模式下，不能使用在其他主机或平台上生成的状态文件进行安装或卸载。

描述：如果状态文件在其他主机或其他操作系统上生成的，则可能无法使用该文件。例如，如果使用 Windows 机器，并且试图在无提示模式下使用 Solaris SPARC 机器上生成的状态文件进行安装，那么控制台可能会显示“Corrupt statefile”（状态文件损坏）消息。（所有平台）

解决方法：编辑状态文件，然后重新调用无提示安装程序。有关具体说明，请参阅《Sun Java Studio 安装指南》第 7 章。

4981429 访问管理器控制台（http://localhost/amconsole 或 http://machine-name.ntdomain/amconsole）将用户重定向到门户。

描述：如果在域名（DNS 后缀）为 NTDOMAIN 的 Web 服务器上安装访问管理器，则无法使用访问管理器控制台。（所有平台）

解决方法：（在 Web 服务器上安装）请确保机器的域名全部为小写字符，例如 ntdomain 或 sfbay.sun.com。

（在应用服务器上安装）在应用服务器上安装访问管理器后，编辑 IS6.1/config/xml/amPlatform.xml 文件，并从 iplanet-am-platform-cookie-domains 设置中删除 .ntdomain 值。请确保在安装后启动服务器之前执行此操作。

4981447 应用服务器可能因端口冲突而无法启动。

描述：卸载产品的早期版本并安装新版本。使用“启动所有服务器”命令。应用服务器管理控制台和实例可能无法启动。(Windows)

解决方法：按以下方式编辑 config 文件夹中的 server.xml 文件：将 ORBPORT 更改为未使用的端口号。

4989825 IDE 目录没有安装在指定的网络驱动器上，而是安装在 /opt 上。

描述：已在安装期间指定了网络安装位置，但 SUNWjstudio 目录却创建在 /opt 上。安装日志显示了指定的安装目录，但却没有在该处安装 IDE 目录。IDE 不能安装在装有 NFS 的文件系统中。(Solaris)

解决方法：将 IDE 安装在本地安装的磁盘分区中。

5019983 应用服务器管理口令未安全存储在 /opt/SUNWappserver/statefile 中。

描述：安装后，应用服务器管理口令以纯文本方式存储在磁盘上的状态文件中，超级用户具有该文件的一般读取权限。（另请参阅相关的错误 6202864。）(Solaris)

解决方法：如果超级用户社区中的管理口令存在安全性问题，那么可以使用 chmod 400 命令将状态文件的访问权限手动更改为 -r-------。然而，这可能会造成插件丢失您的访问数据（错误 6185561）。

5081060 安装 IDE 或某些服务器时出现问题。安装程序不接受 DNS 域名。

描述：如果独立的 Solaris 系统使用动态主机配置协议 (DHCP) 而不是静态 IP 地址来配置环境，则可能会在试图安装 IDE 时遇到问题。(Solaris)

解决方法：使用以下命令 Ping 您的本地机器：

#ping -s fully_qualified_host_name

如果此命令失败，请按以下方式将全限定主机名 (FQHN) 手动增加到 /etc/hosts 列表中：

127.0.0.1 localhost loghost
IP_address host_name FQHN # added by DHCP

5101681 取消安装 Web 服务器后留下了失效的注册项。

描述：如果在开始安装盘 2 的同时取消 Web 服务器安装，则会启动卸载进程。但是，此时已在注册表中建立了注册项，并且某些项还会保留下来。(Windows)

解决方法：手动清理系统注册表，删除任何包含 Webserver 字符串的项。有关详细信息，请参阅《Sun Java Studio 安装指南》第 15 章中的“识别并修复不完全的卸载”部分。

6201183 作为缺省容器的 Web 服务器使用非标准端口时，系统不显示访问管理器服务器登录页。

描述：如果应用程序使用 Web 服务器作为缺省容器，并且未将 Web 服务器配置为使用标准端口 (80)，则策略代理不会自动配置为使用正确的端口。（所有平台）

解决方法：在 studio_home\PolicyAgent\IdentityServer\j2ee_agents\config\e__Sun_ jstudio_04Q4\AppServer7\domains\domain1\server1\config\amagent.properties 文件的以下项中，将 Web 服务器端口号更改为实际端口，而不是缺省端口：

com.sun.am.policy.amFilter.loginURL
com.sun.am.policy.amFilter.port.check.map
com.iplanet.am.server.port
com.iplanet.am.console.port
com.iplanet.am.profile.port
com.iplanet.am.naming.url
com.iplanet.am.notification.url
com.iplanet.services.cdsso.CDCURL
com.iplanet.services.cdc.authLoginUrl
com.sun.identity.agents.notification.url

然后重新启动容器服务器。

6202186 在 Solaris Sparc 8 上进行应用服务器配置失败。

描述：如果选择创建应用服务器的非超级用户实例，则会导致盘 1 安装失败。(Solaris)

解决方法：请参阅《Sun Java Studio 安装指南》以了解详细的清除说明。

6202864 应用服务器管理口令未安全存储在 /opt/SUNWam/SUNWam/j2ee_agents/.installer_inputs 中。

描述：安装后，应用服务器管理口令以纯文本方式存储在磁盘上的安装程序输入文件中，超级用户具有该文件的一般读取权限。（另请参阅相关的错误 5019983。）(Solaris)

解决方法：如果超级用户社区中的管理口令存在安全性问题，可以使用 chmod 400 命令将状态文件的访问权限手动更改为 -r-------。

性能分析

6195552 在启用分析器的情况下试图调试应用程序时，您可能会收到“连接被拒绝”或“连接中断”的消息。启用

描述：(Windows XP) 如果为某一服务器实例启用分析器，然后重新启动该实例，启用某个应用程序的分析器，并且尝试对该应用程序进行调试时，调试会话可能会停止，并且有可能看到“当试图联系 [主机名] 时连接被拒绝”消息。
（SPARC-S2 上的 Solaris 8）如果执行相同的操作，调试会话可能会停止，并且有可能看到“断开与服务器实例的连接”消息，并且最终会显示一条消息，说明会话已停止。

解决方法：为该服务器实例禁用分析器。为该应用程序禁用分析器过滤器。然后，在调试之前停止并重新启动该服务器实例。

UML 建模

5095083 “Web 报告”进度对话框在第一次打开时似乎挂起。

描述：通过选择“建模”>“报告”>“Web 报告”，设置报告选项，然后单击“完成”，出现的进度对话框似乎表明系统没有做出响应。（所有平台）

解决方法：在进度对话框中单击“取消”。实际上，并没有取消 Web 报告，它已成功生成。

只有在新用户目录中第一次使用 Web 报告功能时，才会发生这一异常情况。此后，进度对话框会按预期方式进行响应。在所有情况下，都会正确生成报告。

5110005 取消选择或重新选择元素后，将无法使用“文档”窗格中的对齐选项。

描述：(Windows)

解决方法：请执行以下任意操作：

• 编辑类元素的源 HTML 文件以指定所需的对齐方式。例如：

  <p align="center">第 2 行</p>

  变为

  <p align="right">第 2 行</p>

• 在编辑器中保存更改 (Ctrl-S)。

• 删除并重新创建无法应用对齐方式的行。

6174892 在 UML 安装向导中，忽略了在“文件名”字段中键入名称而指定的主文件系统。

描述：在使用此向导创建新项目时，会出现这种问题。（单击“建模”标签，键入所需的目录路径作为主 UML 建模文件系统，单击“完成”。）文件选择器的预选目录是实际安装的目录，而不是指定的目录。（所有平台）

解决方法：不使用“文件名”字段，而是浏览至所需的目录，然后选择它。

6182658 当使用 ClearCase 版本控制系统时，您可能会收到一些错误消息。

描述：当您对一切正常表示怀疑时，可能会看到一些冗长的消息，如 cleartool: Error: Element name is already checked out to view viewname（cleartool：错误：元素 name 已签出到视图 viewname 中）或 cleartool: Error: Can't create directory element because name already exists（cleartool：错误：无法创建目录元素，原因是 name 已存在）。(Windows)

解决方法：忽略这些消息，只需查看为 ClearCase 增加的内容是否已完成。

6183736 如果命名的项目与已删除项目的名称相同，设计中心则可能不显示该项目中的元素。

描述：在设计中心目录中创建一个新的设计模式项目，对其命名，然后将其删除。创建另一个新项目，使用与第一个项目相同的名称。然后在此新项目中创建一个图。该图可能不显示在项目树中；项目可能显示为空。（所有平台）

解决方法：重新启动 IDE。现在，将显示新项目中创建的所有新元素。

6185174 不能使用属性表单来删除文本属性。

描述：如果试图使用属性编辑器清除属性中的文本，那么该文本还会重新出现。（所有平台）

解决方法：使用源代码编辑器或“UML 文档”窗口。

6187139 打开概览窗口时，某些菜单项不显示。

描述：如果打开概览窗口，在上下文菜单中不显示“插入/删除属性”和“插入/删除操作”项。（所有平台）

解决方法：请执行以下操作之一：

• 关闭概览窗口，然后再打开上下文菜单。
• 使用属性表单来执行插入或删除操作。

6188808 编辑源代码以更改参数的多重性时，模型中未反映出此更改。

描述：在创建类图时，增加一个类和一个方法，然后编辑该方法以更改其参数的多重性，UML 模型不能进行正确地更新。（所有平台）

解决方法：右键单击源代码编辑器，然后选择“工具”>“通过源更新模型”。

- UML 建模和多字节问题

5100837 使用多字节字符增加 extends 子句会导致类定义无效。

描述：创建一个新项目或类图，放置并使用多字节字符命名一个类，为该类创建一个操作，放置并命名第二个类，使用源代码编辑器增加一个 extends 子句，以便让第二个类成为第一个类的扩展。然后重新定义超类方法。代码和模型似乎已正确更新。然而，单击项目树或类图时，类定义语法不完整。（所有平台）

解决方法：应该在源代码编辑器中将类名粘贴到 extends 子句中。

5103318 不能在编辑控件或项目树中输入多字节字符的属性或操作名称。

描述：使用编辑控件或项目树输入多字节字符的属性或操作名称时，不会在模型中反映这些更改。（所有平台）

解决方法：应使用属性编辑器或源代码编辑器。

5103320 在命名类时，不能使用编辑控件输入多个多字节字符。

描述：编辑控件不能将此输入反映到项目树中。（所有平台）

解决方法：应使用项目树或属性编辑器。

6194570 在日语语言环境中，Web 报告可能无法正确显示字符串。

描述：生成 Web 报告时，每个 HTML 的编码规范始终为 Shift-JIS。但嵌入字符串（如图名称）的编码取决于系统语言环境。因此，在 EUC_JP 环境中使用 IDE 时，实际编码 (EUC_JP) 与 HTML 编码规范不匹配，字符串可能显示为乱码。（所有平台）

解决方法：如果在 Web 报告页中无法正确显示多字节字符，请将浏览器的编码值更改为其他编码。

- UML 建模和版本控制问题

5110009 IDE 的主“版本”菜单与“UML 工作区”窗格中的“源代码控制”菜单不对应。

描述：主“版本”菜单用于控制“文件系统”标签中的文件对象，它与“UML 源代码控制”菜单提供的功能不匹配。UML 建模元素可以包含多个文件。如果试图手动对各个 UML 相关文件进行版本控制，则可能会出现不一致的结果。（所有平台）

解决方法：仅使用“UML 源代码控制”菜单为 UML 建模元素应用版本控制操作。

6186711 在提交文件时，可能会看到两个提交对话框，而不是一个。

描述：创建一个图，并为其增加一个元素。此时将出现一个对话框，询问您是否要将更改增加到库中，在成功后将显示“提交”选项的复选框。如果选中此复选框，接下来您会看到两个对话框，它们都要求您进行确认。

解决方法：请不要选中“继续提交”对话框。系统将自动执行提交。

6199175 第一次操作时，可能无法将包增加到源代码控制中。

描述：安装一个新的版本控制文件系统，并从中创建一个新的 UML 建模项目。然后创建一个新图和包。您可以将项目和图增加到源代码控制中，但可能无法增加包。（所有平台）

解决方法：尝试通过上下文菜单命令再次执行此操作。

6197911 如果使用版本控制，并且将类增加到类图中，则可能会出现空指针异常。

描述：如果将图增加到库中，然后再将其签出以增加元素，则可能会出现空指针异常。（所有平台）

解决方法：如果确实增加了该类，则可以忽略空指针异常。

6199207 IDE 未显示 UML 建模项目在 ClearCase 的控制下，并且
6199388 在进行某些 VCS 操作后，IDE 会丢失 UML 建模对象的 VCS 状态图标。

描述：UML 建模版本控制接口与用户安装的版本控制系统之间可能产生各种竞争情况。因此，UML 建模可能会报告一个或多个模型元素的版本控制状态已丢失或不正确。（所有平台）

解决方法：请执行以下方法之一：

• 在“UML 工作区”窗格中展开“UML 建模”项目节点，然后调用“源代码控制”>“刷新状态”。

• 如果其他用户将任务签入到相同的源代码控制库中，请调用“源代码控制”>“获取最新版本”。也可以使用上述操作来替换“刷新状态”操作，如前一项中所述。

• 在某些情况下，可能需要再次将项目增加到源代码控制中，并且需要恢复正确的版本控制状态。

有关 UML 建模的详细信息，请参阅模块说明。

协作

5071137 登录后，“协作”窗口中缺少会话节点。

描述：登录后，在会话资源管理器视图中不显示新会话节点。该视图只显示“无活动的会话”。(Solaris)

解决方法：关闭“协作”窗口，然后再次将其打开。

5074617 文件所有权可能会意外转让。

描述：如果用户离开某一对话，可能会将该用户的文件所有权转让给对话中的其他参与者。如果用户由于网络故障而必须离开对话，这纯属于一种意外。(Solaris)

5081098 共享和保存可视化窗体时将重新打开窗体窗口。

描述：在 IDE 之间共享某个可视化窗体文件时，会发生这种情况。当一个 IDE 的用户在文件中保存更改时，将重新打开窗体的 Java 文档和编辑器文档来刷新该文件。（所有平台）

解决方法：如果要在一个 IDE 中保存文件，请在另一个 IDE 中关闭并重新打开该文件。

5087286 按 F6 键无法总是在“共享文件”区域执行 Java 类。

描述：如果用户在“共享文件”区域创建了一个 Java 类，则有可能在试图使用 F6 键执行该类时失败。(Windows)

解决方法：使用以下方法来执行 Java 类：即右键单击该节点，然后从上下文菜单中选择“执行”。

5092524 可能无法正确重命名共享文件。

描述：一个用户在“对话共享文件”区域创建了一个类，然后对其进行重命名。另一个用户看到的仍是该类的原始名称。第一个用户可能会收到一条消息，说明无法重命名该类。(Windows)

解决方法：要重命名共享文件，请执行以下操作：

1. 将共享文件复制到本地文件系统。

2. 在本地文件系统中重命名该文件。

3. 删除共享文件夹中的共享文件。

4. 将重命名的文件从本地文件系统复制到共享文件夹中。

5107314 无法使用多字节用户名或口令进行登录。

描述：在协作帐户或会话中，不能使用多字节或扩展的 ASCII 字符作为用户名、口令、公共对话名称或显示名称。（所有平台）

6181648 如果文件过大，IM 服务器可能会中断文件共享连接。

描述：如果用户试图共享一个超过 IM 服务器缓冲区限制大小的文件，则可能会发生连接中断，并且显示包含以下内容的消息：An operation on a socket could not be performed because the system lacked sufficient buffer space or because a queue was full（由于系统缓冲区空间不足或队列已满，无法执行套接字上的操作）。(Solaris)

解决方法：共享文件不能超过 IM 服务器缓冲区的大小限制。用户可以共享大小为 1 MB 的文件。

6182376 无法删除文件共享期间生成的包。

描述：在文件共享对话期间，一个用户在“共享文件”区域创建并填充一个包，然后另一个用户生成该包。如果第一个用户试图快速删除该包，则可能会出现一条消息，说明无法删除此包。协作文件系统可能尚未解锁。(Windows)

解决方法：请稍等片刻，然后再尝试删除。

6186295 无法编辑增加到共享文本文件、Java 文件或 XML 文件中的空行。

描述：在文件共享对话期间，一个用户共享某个文本文件、Java 文件或 XML 文件，而另一个用户则打开该文件。第一个用户编辑该文件的最后一行。在第二个用户的副本中，将在文件的末尾增加一个空行。如果第二个用户编辑该行，则更改不会反映到第一个用户的副本中。(Windows)

解决方法：请不要编辑增加的空行。

重构

5055514、5060310、5075305、5081618、6184456 在使用重构功能移动类和静态成员时出现警告。

描述：使用重构功能在包之间移动静态成员（方法或变量）之前，请确保它们没有引用其他受保护的成员，并且也没有被其他受保护成员所引用。例如，如果将静态受保护方法从一个包移到另一个包，则在将其移到目标包外部的类后，可能会看不到该方法。您可以使用“查找使用实例”来执行此类检查。也可以将这些成员指定为公共成员，以便让它们在移动操作后可见。

在移动类时，如果某个文件具有多个顶级类，并且如果移动其中的一个类，则自动移动其他的顶级类。在将某个类移到不同的包时，有时可能会发现多余或错误的 import 语句，您必须将其删除或更正。（所有平台）

5058187 有时重构无法识别变量。

描述：重构操作有时无法识别单字符变量，如 x[] 或 x++。（所有平台）

解决方法：尝试在变量后面加一个空格。

5074078 选择“重构”>“重命名类”会更改所有使用该对象旧名称的注释。

描述：使用重构功能重命名对象时，请务必在预览窗口中检查注释部分。IDE 会更改所有使用旧名称的注释，无论这些注释是否适用于被重命名的对象。（所有平台）

解决方法：清除您不希望 IDE 更改的任何注释的复选框。

5070205 核心中存在的撤消/重做问题

描述：在“文件系统”窗口中，如果“重构”>“重命名”操作是从节点上下文菜单中调用的，则“编辑”>“撤消”操作无法撤消该操作。（所有平台）

解决方法：在“文件系统”窗口中，要撤消从上下文菜单生成的重构操作，请先在源代码编辑器中打开源文件。

6200832 试图重构 ViewBean 时，可能会产生空指针异常。

描述：使用 Web 应用程序框架创建一个应用程序，然后在其中创建一个 ViewBean。在 ViewBean 中试图使用重构操作（如重命名变量）时，会出现空指针异常。（所有平台）

解决方法：在执行任何重构操作之前，下载并安装 Servlet API JAR，它位于：http://java.sun.com/products/servlet/reference/api/index.html。

有关重构的详细信息，请参阅模块说明。

Portlet Builder

5097924 仿真器消息中的多字节字符显示为 ??。

描述：在使用应用服务器时，仿真器中的消息并非来自本地化的捆绑文件。（如果使用的是 Tomcat，则不会出现该问题。）（所有平台）

解决方法：请执行以下操作之一：

• 以日语或中文用户的身份，登录到仿真器窗口中。(Mao 是日语用户；Chong 是中文用户。)

• 将服务器实例的语言环境设置为您的语言环境。或者，按照如下所述设置管理服务器的语言环境（针对错误 5108171）。

5108171 在其他语言环境中使用打包器时，可能会看到多字节字符的消息显示为 ??。

描述：要在其他语言环境中使用打包器并正确显示本地化的消息，必须手动设置应用服务器实例的语言环境。（如果使用的是 Tomcat，则不会出现该问题。）（所有平台）

描述：通过应用服务器管理 GUI，将服务器实例的语言环境更改为适当的语言环境（“语言环境”项位于服务器实例的“高级”标签中）。或者，将语言环境保留为空，让服务器实例在启动时选用系统的语言环境。编辑并保存语言环境字段，然后应用更改并重新启动服务器。

5104746 无法正确显示在仿真器中设置的包含多字节字符的属性。

描述：如果在亚洲语言环境中仿真 Portlet 应用程序，然后增加一个属性字符串并选择“执行”，则在属性表单中无法正确显示多字节字符。（平台）

解决方法：在属性名称或值中不要使用多字节字符。

6182165 对于 Tomcat，如果超级用户仿真尚未完成，非超级用户仿真将会失败。

描述：对于 Tomcat，在超级用户执行的第一个仿真完成之前，非超级用户执行的仿真操作将会失败。无法将任何 portlet*.jar 文件复制到 jwsdp/common/lib 中，该目录是写保护的。(Solaris)

解决方法：请执行以下操作之一：

• 将 user_dir/pb/data/commonlibs/ 中的 jar 文件复制到 install_dir/Ent_04Q4/jwsdp/common/lib

• 以超级用户的身份启动 IDE，然后再以非超级用户的身份启动它。

6182257 如果以非超级用户身份安装应用服务器，则应用服务器上的超级用户仿真将会失败。

描述：在这种情况下，应用服务器已安装完毕，因此，非超级用户有权进行访问。现在，超级用户运行 IDE 并尝试执行仿真。IDE 的用户目录属于超级用户所有，但应用服务器进程却在非超级用户帐户下运行（即使它是由超级用户从超级用户的 IDE 进程中启动的）。因此，服务器进程写入 /tmp/u1/system/SIMportletcontainer.log 的尝试将会失败。(Solaris)

解决方法：为任何应该拥有应用服务器的非超级用户授予以下内容的写入权限（如果日志文件不存在，则创建它们）：

root_user_dir/system/portletbuilderapp.log
root_user_dir/system/SIMportletcontainer.log
root_user_dir/ps/web/tmp/portletDepolyer.log
root_user_dir/ps/web/WEB-INF/classes/

6194516 Portlet Set 值随属性窗口的关闭而消失。

描述：创建一个 Portlet 应用程序，然后创建一个 Portlet。在“文件系统”窗口中，右键单击 Portlet 应用程序节点，然后从上下文菜单中选择“属性”。（在这种情况下，没有从“窗口”菜单中打开“属性”。） 打开 Portlet Set 并在属性表单中查看该值。如果关闭该窗口并单击“属性”窗口，Portal Set 值将消失。（所有平台）

解决方法：单击属性编辑器中的任意位置，Portlet Set 值将重新出现。

JavaServer Pages

4959762 如果没有对 Bean 类进行预编译，JSP 编译将会失败。

描述：如果 JSP 通过 jsp:useBean 标记使用 Bean，并且 Bean 类尚未经过编译，则 JSP 无法进行编译。您可能会收到这样的错误消息：
JSP.jsp [-1:-1] beans.Bean
Errors compiling JSP.(Windows)

解决方法：编译 JSP 之前，先编译 JSP 中的所有 Bean 类。

Web 应用程序框架

4960761 转换后，应用程序的显示名称可能无法正确显示。

描述：在使用转换应用程序向导转换应用程序时，该向导可能无法从 web.xml 文件中正确加载应用程序显示名称，并且该名称可能不会显示在“应用程序属性”窗口中。(Windows)

解决方法：打开应用程序的“设置与配置”节点，选择“部署描述符”并编辑“显示名称”属性。

5079813 应用程序可能因插件不能识别模块包而无法运行。

描述：Web 应用程序框架插件有时无法识别 Web 应用程序框架应用程序内的模块包。多数情况下，会在创建新的应用程序或启动 IDE 后出现这种问题。（所有平台）

解决方法：右键单击应用程序节点，然后选择“标识模块”。

6201472 如果在 Web 应用程序中禁用访问管理器“安全”属性，然后试图运行该应用程序时，您可能会收到一条错误消息（HTTP 状态 500 错误）。

描述：启用 Web 应用程序的“安全”属性后，运行该应用程序，然后使用“其它配置”>“Sun Java System Identity Server”属性编辑器（用于访问管理器）来禁用“安全”属性，但应用程序的 web.xml 文件仍包含一些安全值。除非重新启用或完全禁用安全属性，否则将不能打开 Web 应用程序。（所有平台）

解决方法：使用“其它配置”>“Sun Java System Identity Server”属性编辑器删除任何遗留的安全约束和安全角色。然后重新部署 Web 应用程序。

服务器

4892779 CMP 模块初始选择产生异常。

描述：您可以正常启动 IDE。第一次装入并选择大型的 EJB 模块（例如，100 个 CMP bean 和许多 CMR）时，IDE 似乎运行正常，但随后可能产生料想不到的异常。(Windows 2000)

解决方法：在启动 IDE 时，请使用以下选项根据系统容量来增加可用内存：-J-Xmxnnnm
其中 nnn 要大于缺省启动值 256。

4965961 只能在应用服务器中使用 JWSDP1.3 增强功能。

描述：要在其他受支持的应用服务器中使用 JWSDP1.3，需要具有 jwsdp-common-lib.jar 文件。（所有平台）

5015087 在当前 IDE 版本中使用先前版本创建的数据库结构或 EJB 模块（或者只是很大的 EJB 模块）时，发生 CMP 映射错误，并且响应速度也显著下降。

描述：如果您尝试在当前 IDE 版本中部署由 Sun ONE Studio 4 创建的 EJB 模块或数据库结构，则可能会发生容器管理关系 (CMR) 验证错误。尤其是 CMP bean 具有两个以上的关系时，这些关系可能会丢失。此外，如果尝试打开由 Sun ONE Studio 4 创建的大型 EJB 模块，则当前版本的 IDE 可能会挂起。（所有平台）

解决方法：这些错误会清楚地显示在输出窗口中。请使用 CMP bean 的属性表单来更正这些错误。

6176639 示例应用程序 appserver 已被成功部署，但在访问管理器中执行它时却出现异常。

描述：如果 /usr/j2se 目录不包含 JDK 1.4 或更高版本，则无法正确配置策略代理。(Solaris)

解决方法：如果从 JSE 7 安装应用服务器或访问管理器，请确保 /usr/j2se 目录或符号链接中包含所需的 JDK 版本。如果不包含，请创建一个从不正确的文件路径到包含所需 JDK 版本的 IDE 安装目录的符号链接。

创建符号链接请使用此命令：ln -s /usr/jdk/entsys-j2se /usr/j2se

6199998 在试图运行已配置为使用 DataDirect 驱动程序的应用程序时，可能会出现 ClassNotFound 异常。

描述：注册数据库连接池后，应用服务器的 server.xml 文件缺少一个斜线，这会导致 DataDirect 驱动程序在 Solaris 上无法正常使用。(Solaris)

解决方法：创建和注册连接池后，请手动增加缺少的斜线，方法如下。

1. 在 IDE 的安装目录中，打开此文件：/Appserver7/domains/domain1/server1/config/server.xml
   （根据服务器实例更改此路径。）

2. 在文件中，搜索 classpath-suffix 元素。

3. 查找名为 sm*.jar（例如，smbase.jar、smresource.jar）的 jar 路径。

4. 将正斜线 (/) 增加到路径的起始处。

6201117 重命名 DatasetNavigator 或 DatasetLocator 组件可能会导致应用程序错误。

描述：您将 ViewBean 增加到使用 Web 应用程序框架创建的应用程序中，然后将 DatasetNavigator（或 DatasetLocator）组件增加到页面上，并对导航器或定位器进行重命名。在源代码编辑器中打开 ViewBean 的 JSP 时，将正确地更新 标记，但可能不会正确更新内部的 。这种情况将导致运行时出现应用程序错误，如Invalid child name（子项名称无效）。（所有平台）

解决方法：重命名其中的一个组件时，请确保手动重命名组件的嵌套 containerView 标记。

J2EE 调试器

5065466 IDE 可能会让您在创建新会话的同时保留一个调试器会话的运行。

描述：安装一个 J2EE 应用程序，然后在应用程序的 EJB 模块中启动调试会话。EJB 模块已被部署。如果试图在同一个 EJB 模块中启动另一个调试会话，则会出现一个对话框，询问您是否要在启动新会话时保留现有会话。然而第二个会话并没有启动。(Windows)

解决方法：在调试 J2EE 应用程序或 EJB 模块时，如果调试器在 Java 类（如 SessionBean 类）中停止，而您希望重新启动该调试器，则在重新启动之前，请确保选择该应用程序或 EJB 模块节点。

版本控制

5082087 使用记事本打开 VSS 控制下的文本文件修订版时，会引发异常。

描述：创建一个文本文件 (.txt)，使其处于 VSS 控制下，然后创建若干此文件的修订版本。为该文件调用“显示版本”并展开文件修订版本。右键单击任意的修订版本，然后选择“打开”。输出结果将显示在 .txt 文件中，而不是在命令行中滚动输出。当关闭 .txt 文件时，IDE 会抛出异常。(Windows)

解决方法：如果将 notepad.exe 指定为用于查看 .txt 文件的应用程序，则会出现这种情况。要解决这一问题，请显式删除应用程序与 .txt 文件之间的任何关联：在数据库 ss.ini 文件中，增加下列 Extension_Association 行：
.txt =
此行可以确保具有 .txt 扩展名的文件与应用程序没有关联。

5104939 有时右键单击处于版本控制下的 web.xml 节点时，IDE 会不断询问您是否从版本控制系统中获取可写入的文件。

描述：安装任意的 VCS 文件系统，在其中创建一个新的 Web 模块，将该 Web 模块增加到库中，然后右键单击 web[Current] 节点以查看属性。或者，从上下文菜单中运行另一个命令。然而，IDE 会不断询问您是否要签出文件。（所有平台）

解决方法：将 Web 模块增加到版本控制系统中之前，请确保打开 web.xml 节点的“属性”窗口。这将强制初始化该 Web 模块的服务器特定文件。

只有在使用 UML 建模功能时，才会出现某些版本控制错误。请参阅该部分内容以了解详细信息。

其他

5091569 没有按预期方式从 IDE 中打开外部浏览器窗口。

描述：使用 Mozilla 作为 Web 浏览器时，如果已打开 IDE，但尚未运行 Mozilla 实例，则在试图从 IDE 中调用它时，可能不会打开浏览器窗口。（所有平台）

解决方法：在 IDE 外部打开一个浏览器窗口。IDE 将重用该窗口。

J. 辅助功能

文档

您可以通过辅助技术来阅读这些以易读格式提供的 Sun Java Studio Enterprise 开发人员工具和服务器文档。

IDE 中的联机帮助文档

IDE 提供了许多辅助功能，可以让您以最舒适和最方便的方式来阅读和使用该产品。这些功能包括：

• 助记符与键盘快捷键
• 可定制字体
• 可定制颜色
• 可定制工具栏
• 可定制样式表

要获得有关 IDE 辅助功能的信息，请打开联机帮助，然后单击目录中的“辅助功能”主题。

修改层叠样式表以获得辅助功能

修改联机帮助中层叠样式表的指令时要求提供额外的信息。

大多数帮助集使用在 modules/docs/usersguide.jar 中存储的样式表。如果更改此样式表，则同时还会影响大多数其他帮助集的显示。但数据库结构帮助集例外，它使用在 dbschema.jar 中存储的样式表。

要更改联机帮助的层叠样式表，请执行以下操作：

1. 在 IDE 安装目录中，导航到 modules/docs。

2. 使用 jar 命令行实用程序对 JAR 文件进行解压缩。

在 Microsoft Windows 和 UNIX 系统上，该命令为：

jar xf jar-file

对于 jar-file，请使用下列文件之一：

• usersguide.jar - 用于大多数帮助集的样式表
• dbschema.jar - 数据库结构联机帮助

Jar 工具复制这些文件，并将其写入当前目录中。然后根据归档中的包结构重新生成目录结构。

3. 在解压缩的层次结构中，导航至包含要编辑的样式表的目录：

• 一般联机帮助 - org/netbeans/modules/usersguide
• 数据库结构 - com/sun/forte4j/modules/dbmodel/docs

4. 在文本编辑器中，打开 ide.css 文件。根据您的偏好编辑文件，并保存它。

6. 返回安装目录中的 modules/doc，然后更新 JAR 文件。在 Microsoft Windows 和 UNIX 系统上，该命令为：

jar ufv jar-file input-file

对于 jar-file，请使用原始 JAR 文件的名称，例如，usersguide.jar；对于 input-file，请使用以下名称之一：

• org，用于用户指南帮助集
• com，用于数据库结构帮助集
  

Solaris 操作环境

Solaris 操作环境允许您使用“窗口样式管理器”设置窗口行为。在 Sun Java Studio Enterprise IDE 中使用助记符时，应将窗口行为设置为“在窗口中单击将其激活”。

如果未设置此选项，在某些情况下，某个助记符可能会失效。

K. NetBeans 开放源代码项目

IDE 基于 NetBeans 开发源代码项目（位于 http://www.netbeans.org）。NetBeans 是基于社区的项目，它鼓励人们以各种新颖的创新方式使用 NetBeans IDE 平台。并号召所有开发人员群策群力拓展 NetBeans IDE 内容并改进它所基于的框架，使开发社区能够开发出或为开发社区提供功能非常强大的工具集。

L. 可再发行文件

下列二进制文件随 Sun Java Studio Enterprise IDE 一起提供，并可再次发行：

• dbschema.jar
• xerces-2.6.0.jar
• cvslib.jar
• AbsoluteLayout.jar
• sql.jar
• standard.jar
• jaxen-full.jar
• jstl.jar
• saxpath.jar
• jato-2_1_4.jar

M. 指向 Sun Java Studio Enterprise 产品捆绑的选定服务器产品发行说明的链接