FeaturesDocs & SupportCommunityBlogsPartners

迁移 NetBeans Visual Web Pack 应用程序至 NetBeans IDE 6.0

2007 年 12 月 [修订版本号:V6.0]
本文档适用于 NetBeans IDE 6.0 Web 支持
   

本教程逐步讲解把 NetBeans Visual Web Pack 5.5 项目导入到 NetBeans IDE 6.0 中的过程。

内容

本页上的内容适用于 NetBeans IDE 6.0

- 迁移用户设置
- 在打开项目时迁移源代码
- 使用页面导航
- 配置文件
- 解决库引用
- 操作数据库
- 部署迁移的应用程序
- 获取有关项目迁移的帮助

 

本文档帮助您把 NetBeans Visual Web Pack 应用程序迁移到 NetBeans IDE 的 Web 支持上。

要使用本教程,您需要安装 NetBeans IDE 6.0,并且选择“Web & Java EE”或“All”安装包。要了解有关操作 NetBeans IDE 的更多信息,请参见 NetBeans 网站上的支持和文档页。

Visual Web JSF 向后兼容工具包提供了增补库,可视 Web 设计师需要用它们来支持基于 J2SE 1.4 或 J2EE 1.4 的项目。这包括:

  • JavaServer Faces 1.1 参考实现(RI)
  • RowSet 参考实现(RI)
  • 来自 JWSDP 1.6 的 JAX-RPC 库

这些库不是开源的,因此被作为单独的 NetBeans 插件分发。要安装这些插件,请进行以下操作:

 

  1. 在主菜单中,单击“工具”>“插件”。这将打开插件管理器。
  2. 在“可用插件”选项卡上,选中“Visual Web JSF Backwards Compatibility Kit”旁边的复选框,再单击“安装”。

迁移用户设置

在启动 NetBeans IDE 6.0 前,请一定先关闭 NetBeans 和 Java Studio Creator IDE 的所有实例。当您安装了 NetBeams IDE 6.0 的 Web 支持后,在第一次运行 IDE 时,您将被询问是否迁移设置,如图 1 所示。单击“确认导入设置”对话框中的“是”以迁移设置。

图 1:“确认导入设置”对话框
图 1:“确认导入设置”对话框

如果您想打开在另一个版本的 IDE 中开发的项目,又没有导入那个版本的用户设置,请照下面操作:

  1. 关闭 NetBeans IDE 6.0
  2. 重命名您不想迁移的 IDE 版本的用户目录名称。
  3. 删除 NetBeans IDE 6.0 的用户目录。要查看用户目录的位置,请选择“帮助”>“关于”,如下图 2 所示。
  4. 重新启动 NetBeans IDE 6.0。
  5. 在“确认导入设置”对话框中,单击“是”以迁移用来创建项目的版本所对应的设置。
    每当您运行 IDE 时,用户目录就被创建。您在步骤 3 中所删除的文件将被重新生成。

     

    要在 NetBeans IDE 6.0 的下次启动时得到提醒,请重命名用户目录。要查看用户目录的位置,请选择“帮助”>“关于”,如下图所示。

    图 2:安装详细信息 图 2:安装详细信息

    在打开项目时迁移源代码

    在 NetBeans IDE 6.0 中打开项目前,请始终要复制项目文件夹。一旦打开了在 NetBeans Visual Web Pack 中创建的项目,您将无法在早期的 IDE 中再次打开该项目。不支持在 NetBeans Visual Web Pack 和 NetBeans IDE 6.0 之间共享项目。注意:目前提供 EJB 和 Web 服务的有限支持。

    当您在 NetBeans IDE 6.0 中通过单击“文件”>“打开项目”来第一次打开一个 Visual Web Pack 应用程序时,以下源代码被迁移:

    • 组件库被添加到 IDE 中。当您在 NetBeans IDE 中打开项目时,一个对话框弹出,告诉您项目中所用到的 complibs 正被添加到“面板/工具”>“组件库管理器”中。您可能需要手动解决库引用。
    • 在打开项目时,JDBC 驱动程序和连接不会被导入。实际上,这发生于“项目”选项卡中的项目节点被展开时,一个小进度条开始“更新遗产项目”。仅仅打开一个项目不会导入数据库设置。

     

    • 注意:推荐您删除将要迁移的项目的副本里的“private”文件夹。这个文件夹位于 myProject/nbproject/private

    使用页面导航

    用在 Visual Web Pack 中的页面导航编辑器现在是 NetBeans IDE 6.0 中的页面流编辑器。

    在 VWP 5.5、5.5.1 以及 Java Studio Creator 中,项目有三个 faces 配置文件,其目的分别是:

    • managed-beans.xml。管理所有的受管 Bean 实例(包括会话、请求和应用 Bean)。
    • navigation.xml。包含所有的导航规则。
    • faces-config.xml。通常为空,除非有任何手动制造的条目。

    对比 NetBeans 6.0 中的新项目,一切都缺省归在单独一个 faces-config.xml 文件中,但您能够添加新的 faces 配置文件,并在它们中添加您自己的规则或条目。

    新的页面流编辑器能用在任何 faces 配置文件上。

    新的页面流编辑器提供 3 中不同的视图让您查看导航规则(您可以用“XML”按钮旁的下拉列表来切换视图):

    • Project。这是缺省视图,显示项目(包括 JSF 页面、HTML 等等)中的所有页面,并带有该特定 faces 配置文件的所有导航规则。
    • Faces Configuration Only。类似地,在这个视图中,当前 faces 配置文件中的所有规则被显示出来,但只显示相关的页面。
    • All Faces Configuration。在这个视图中,所有 faces 配置文件的导航规则和条件被合并在一起,并和所有相关页面一起i显示。

    要了解使用页面导航的更多信息,请参见 Visual Web Pack 教程在 Web 应用程序中导航页面。本教程涵盖 NetBeans 6.0 集成开发环境的页面导航特性。

    配置文件

    刚导入项目时,用户将看到三个配置文件:

    • faces-config.xml
    • navigation.xml
    • managed-beans.xml

    要特别注意的是,当项目运行时,所有这些配置文件中的规则都将被合并。您可以查看所有三个文件的页面流编辑器,并向它们添加导航规则,但这可能造成在不同文件中有冲突的规则。如果您在不同的文件中有同样的 from-view-id 和 from-outcome  元素,但 to-view-id 不同,冲突的规则就会浮现。下面两段代码演示了这种情形的一个例子:

    <navigation-rule>

    <from-view-id>*/Page1.jsp*</from-view-id>
    <navigation-case>
    <from-outcome>*case1*</from-outcome>
    <to-view-id>*/Page2.jsp*</to-view-id>

    </navigation-case>
    </navigation-rule>
    <navigation-rule>
    <from-view-id>*/Page1.jsp*</from-view-id>
    <navigation-case>
    <from-outcome>*case1*</from-outcome>

    <to-view-id>*/Page3.jsp*</to-view-id>
    <redirect/>
    </navigation-case>
    </navigation-rule>
    如果您在导入的项目中使用 navigation.xml 来管理导航规则,就不会有问题。下面的规则应该能帮助您解决这些冲突:
    • 如果冲突是在 faces-config.xml 和另一个文件之间,faces-config.xml 始终会占先。
    • 如果冲突在另两个配置文件之间,例如 navigation.xmlmanaged-beans.xml,那么列在 web.xml 最后的上下文参数(javax.faces.CONFIG_FILES)占先。

    要在一个视图中查看来自所有配置文件的规则,这样您就能删除任何冗余内容:

    1. 右键单击可视编辑器,再从弹出窗口选择“页面导航”。
    2. 在页面流编辑器中,从下拉列表的配置范围中选择“Project”,如下图所示。

      图 3:配置范围菜单
      图 3:配置范围菜单

    注意一旦项目被迁移后,IDE 把新页面的受管 Bean 条目注册到 faces-config.xml,而不是 Sun Java Studio Creator 和 NetBeans 5.5 中的 managed-beans.xml

     

    解决库引用

    如果您收到错误消息说有未解决的库引用,您需要删除这些引用。当您删除库引用时,项目不会有危险。

    1. 右键单击项目节点,选择“属性”。
    2. 单击“库”节点,删除“编译”窗口中无效的库引用旁标有黄色图标的条目。
    3. 展开“生成”>“打包”节点,删除任何无效的库引用。

    操作数据库

    通过以下步骤,也许能高效迁移在同一台计算机上,由同一个用户用早期版本的 NetBeans 或 Sun Java Studio Creator 创建的项目.
    • 要迁移设置,请打开项目,然后展开主项目节点。

      一个进度条将出现在 IDE 右下角。一旦进度条终止,数据库驱动程序和连接,以及项目将被更新以准备在 NetBeans 6.0 中使用。
    如果项目在另一台计算机上,或者由不同的用户用早期版本的 NetBeans 或 Sun Java Studio Creator 创建,那么就需要一些附加步骤。
    1. 打开在 NetBeans Visual Web IDE 中创建的项目。
    2. 右键单击“项目”>“数据源引用”,选择“解决数据源”。
      • 注意:对于在 Java Studio Creator 中创建的项目,请关闭项目,再重新打开。
    3. 在“添加数据库连接”对话框中,添加 JDBC 驱动程序,如果它还没有被注册或用下拉列表设置,然后单击“确定”。
    4. 如果项目使用了多个数据库连接,重复步骤 3。

    还有,请确保目标应用服务器已被注册到“服务”选项卡。缺省情况下已注册 GlassFish V2 应用服务器。

    部署迁移的应用程序

    NetBeans IDE 6.0 标准和完整安装程序包括 Sun Java System Application Server,它是 Glassfish 应用服务器的一个版本。如果迁移的项目原来是被部署到 Sun Java System Application Server 上,那么您可以在 NetBeans 6.0 中部署该项目。

    如果您原来是把迁移的应用程序部署到的服务器不是 Sun Java System Application Server,那么您就需要做一些修改来部署应用程序。

    要把项目部署到 Tomcat 上,您必须安装 Tomcat,它可从 tomcat.apache.org 下载。Tomcat 版本 5 和 6 都经过了 NetBeans IDE 6.0 的测试。要了解更多部署到 Tomcat 的信息,请参见 FAQ 添加外部 Tomcat NB6 上外部 Tomcat 的部署

    获取有关项目迁移的帮助

    如果您对把项目从 NetBeans Visual Web Pack 迁移到 NetBeans IDE 6.0 有更多问题,请使用本文末尾的反馈链接。

    参见

Companion
Projects:
                  Powered by: