1.0 简介
2.0 已知问题
2.1 将模块文件添加至企业应用程序项目
2.2 企业应用程序中的备用部署描述符(alt-dd)元素
2.3 EJB/Web/应用程序客户机项目的 Java 构建路径设置
2.4 不支持 EAR 内的 JAR URI 中具有空格
2.5 企业应用程序项目名称不应该包含 DBCS 字符
2.6 二进制项目是只读的
2.7 删除时自动除去 WebSphere 绑定
2.8 由于 JSP 验证而引起资源锁定
2.9 对新的 J2EE 项目使用非缺省项目位置时发生“无效项目描述”错误
J2EE 透视图包含您在为企业应用程序、EJB、Web 和应用程序客户机项目开发资源时通常会使用的视图。本自述文件描述与 WebSphere Studio 中的 J2EE 开发工具相关联的已知问题、限制与变通方法。在 Web 工具的自述文件中说明了与 J2EE 视图和 J2EE Web 项目相关的一些其它项。
当将其中一种模块文件类型(EJB JAR、WAR、RAR 和“应用程序客户机”JAR 文件)导入企业应用程序项目时,必须使用正确的导入向导,并将模块文件导入适当的项目类型中。不要导入企业应用程序项目中。如果将模块文件导入企业应用程序项目中,则将无法使用“应用程序”部署描述符编辑器将该模块添加到应用程序中。
在 WebSphere Studio 中,当前不支持使用 alt-dd。变通方法是编辑所包含的模块的部署描述符。
建议您尽可能地接受 J2EE 项目类型的 Java 构建路径的缺省设置。要设置“企业应用程序”中包含的各个项目之间的依赖项,请使用“JAR 依赖项”编辑器或“Java JAR 依赖项”属性页面。这将使 MANIFEST.MF 文件的 Class-Path 属性(用于服务器运行时)与项目 Java 构建路径(用于 Java 编译)保持同步。
通常,模块必需的库必须包含在“企业应用程序”中,或者对服务器可视。因此,在将外部库添加至项目构建路径时务必小心谨慎,因为项目有可能无法在服务器上运行。例如,假定您具有一个想要在 WEB 模块中引用的 off_the_shelf.jar 库。您就可以:
- 使用文件系统导入向导来将 off_the_shelf.jar 添加至“企业应用程序”;然后使用“JAR 依赖项”编辑器来使 WEB 模块依赖于 JAR,或者
- 使用 WEB 项目的 Java 构建路径属性来将 JAR 添加至构建路径;服务器就必须对 JAR 具有可视性。
要为单元测试完成此操作,请编辑服务器配置并将 JAR 添加至类路径。
不支持企业应用程序中的模块或实用程序 JAR 中的 URI 中具有空格。在 EAR 中,JAR 或模块中的 MANIFEST.MF 文件的“Class-Path:”属性是用空格定界的相对路径列表。如果被引用的 JAR 的 URI 中包含空格,则 JAR 将不能引用 EAR 中的另一个 JAR。
当创建企业应用程序项目时,建议不要为它指定一个包含 DBCS 字符的名称。
由 EAR 导入创建的二进制项目(可作为导入向导的一个选项)被认为是只读的。不应试图修改二进制项目的内容。但是,可以删除二进制项目和将它替换为资源库中的源版本。应该对二进制项目禁用大多数操作。如果您使用二进制项目,则应尽量避免执行将修改项目或 JAR 的内容的任何操作。
当删除包含 Websphere 绑定的对象时,绑定对象也会被自动删除。例如,如果您删除应用程序部署描述符编辑器的“安全性”页面中带有绑定的安全角色,则也会删除安全角色绑定。如果您重新添加同名的安全角色,则需要时务必重新绑定它。
如果“JSP 验证器”最近对 Web 项目进行了验证,则有可能该项目引用的任何库 JAR 文件或类文件仍在使用中。结果,可能无法删除或移动个别的 JAR 或类文件(例如,如果您选择删除 /WEB-INF/lib 目录)。如果 Web 项目将 EAR 项目中的 JAR 文件作为 Java JAR 依赖项来引用,则可能不能删除 EAR 项目或删除 EAR 项目中的 JAR。要为文件管理活动“释放”这些资源,请关闭 Web 项目,然后再重新打开它。
当您创建新的 J2EE 项目(包括 Java、企业应用程序、Web、EJB、应用程序客户机和连接器项目)时,不能使用已由工作台中的另一项目使用的项目位置。如果选择由另一项目使用的项目位置,该向导将显示“无效项目描述”错误对话框或消息。如果在接收到此消息后通过单击浏览按钮选择有效的项目位置,项目创建仍不会完成。变通方法是单击取消并重新打开项目创建向导。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.