在 NetBeans IDE 中如何使用 Tomcat

如何将 Tomcat 用作 NetBeans 项目

http://wiki.netbeans.org/wiki/view/NetbeansedTomcat

 

在 NetBeans IDE 中如何使用 Tomcat

作者：Daria Titova

2007年 5 月

在本教程中，您将学习将 Tomcat 转换为 NetBeans 项目并了解如何在 NetBeans IDE 中运行、调试和配置 Tomcat 项目。

目录

»

                      简介

              所需软件

              本文档中使用的符号

                      练习

              将 Tomcat 转换为 Netbeans 项目

              构建 Tomcat 项目

              运行 Tomcat

              调试 Tomcat

              使用 Netbeans Profiler 配置 Tomcat 服务器

                      补遗：使用 NetBeans 5.5.1

                      小结

                      另请参阅

简介

在本教程中将向您介绍，如何在 NetBeans IDE 中轻松开发大型（几十万行代码）工业实力项目。通过在 Tomcat 服务器示例上执行操作即可完成。

NetBeans 集成开发环境 (IDE) 是一个免费的软件开发人员开源集成开发环境。NetBeans IDE 为开发人员提供了他们创建专业的跨平台桌面、企业、Web 以及移动应用程序所需的所有工具。

在本教程中，您将学习如何将流行的 Tomcat 项目转换为 NetBeans 项目，这将有助于用户在 NetBeans IDE 中开发、调试和配置 Tomcat 服务器。

有关 NetBeans 功能和所支持技术的详细信息，请参阅 http://www.netbeans.org/products/ide/features.html。

有关如何使用 NetBeans IDE 的详细信息，请参阅支持和文档页面。

所需软件

开始之前，您需要在计算机上安装以下软件：NetBeans IDE 6.0。
由于现在正在开发 NetBeans 6.0，因此请使用 NetBeans IDE 6.0 Preview (M9)，可从 NetBeans IDE 6.0 Preview (M9) 下载，或者在 http://bits.nbextras.org/netbeans/6.0/nightly/ 上查看最新的工作版本。
还可以使用 NetBeans 5.5.1 版本，请参阅补遗：使用 NetBeans 5.5.1 部分中的一些注释。不要忘了安装 NetBeans Profiler 5.5.1，因为它不是 NetBeans 5.5.1 IDE 的一部分。

本文档中使用的符号

                   <NETBEANS_HOME> - NetBeans IDE 安装目录

                   <USER_HOME> - 用户的主目录。例如：“C:/Documents and Settings/user_home”

                   <tomcat_root> - 下载 tomcat 源的目标目录。

练习

将 Tomcat 转换为 Netbeans 项目

下载 Tomcat 源：

1. 转到 http://tomcat.apache.org/download-60.cgi 并下载 Source Code Distributions 部分中的 .zip 文件。

2. 将此 .zip 文件（在我们的示例中，此文件名为 apache-tomcat- 6.0.13 -src.zip）解压缩到 <tomcat_root> 目录中。

将 Tomcat zip 文件在 <tomcat_root> 下解压缩之后，将创建一个子目录，在此例中名为 apache-tomcat- 6.0.13 -src。例如，在 Windows 下，如果您在驱动器的根目录 C:/tmp/ 下解压缩了 Tomcat zip 文件，则会创建 C:/tmp/apache-tomcat-6.0.13-src。在 Solaris/Linux 下，如果在 /home/username 目录中解压缩了 Tomcat zip 文件，则会创建 /home/username/apache-tomcat-6.0.13-src 目录。

创建 Tomcat Netbeans 项目：

1. 下载附件中的 nbproject.zip 文件，并将其解压缩到 <tomcat_root> 目录中。
注意：如果您安装了 NetBeans 5.5.1 ，则使用 nbproject551.zip 文件。

2. 在 <tomcat_root> 目录中，创建具有以下内容的 build.properties 文件，使用该内容指定外部库的目录（例如，<tomcat_root>/jars）和代理配置（如果需要）。此步骤是必需的，因为 Tomcat 使用从外部源下载的库。

例如，您的 build.properties 文件看起来应类似于以下内容：

# ----- Default Base Path for Dependent Packages -----
     
     

# Replace this path with the directory path to where dependencies binaries
     
     

# should be downloaded
     
     

base.path=C:/tmp/apache-tomcat-
     
     
      
      6.0.13
     
     -src/jars
     
     

# ----- Proxy setup -----
     
     

# Uncomment if using a proxy server
     
     

proxy.host=my.proxy
     
     

proxy.port=8080
     
     

useproxy=on
     
     

3. 启动 NetBeans IDE。

注意：要进行构建，Tomcat 需要 JDK 1.5。如果您安装了 NetBeans 以及 JDK 1.6，则将 IDE 配置更改为使用 JDK 1.5。要执行此操作，请打开 <NETBEANS_HOME>/etc/ 目录下的 netbeans.conf 文件，然后将 JDK 位置更改为指向 JDK 1.5：

# Default location of JDK, can be overridden by using --jdkhome <dir>:
     
     

netbeans_jdkhome="C:/Program Files/Java/jdk
     
     
      
      1.5.0
     
     _11"
     
     

然后，启动 IDE。

4. 在 IDE 中，从主菜单中选择 Open Project，然后从 <tomcat_root> 目录中打开 Tomcat 项目。

注意：由于我们尚未下载所需的外部库，因此 Netbeans 在 Java 类上显示红色的 X。我们将在下一个练习中完成此操作。

构建 Tomcat 项目

1. 在 Projects 窗口中，右键单击 Tomcat 6.0 项目节点，然后从弹出菜单中选择 Properties。选择左侧的 Java Sources ClassPath 类别，并将 <NETBEANS_HOME>/java1/ant/ant.jar 文件添加到此类路径中。

由于 NetBeans 编辑器没有从 Ant 构建脚本中获得类路径信息，因此该步骤是必需的。尽管该模块将构建类路径，但是它在编辑器中看起来不太好。

2. 右键单击 Tomcat 6.0 项目节点，然后从弹出菜单中选择 Download。NetBeans 将下载所需的库，解压缩它们，并为 Tomcat 构建依赖关系。

请等待，直到完成下载。您将在 Output 窗口中看到一条“BUILD SUCCESSFUL”消息。

注意：如果您从特殊位置下载文件时获得任何错误，请在原始的 <tomcat_root>/tomcat/build.properties.default 文件中编辑该文件的 .loc 条目。在下面的示例中，在原始的 sun 站点位置没有找到 Eclipse 编译器，此位置已被注释掉，并且添加了另一个位置：

# ----- Eclipse JDT, version 3.2 or later -----
     
     

jdt.home=${base.path}/eclipse/plugins
     
     

jdt.lib=${jdt.home}
     
     

jdt.jar=${jdt.lib}/org.eclipse.jdt.core_
     
     
      
      3.2.3
     
     .v_686_R32x.jar
     
     

# jdt.loc=http://sunsite.informatik.rwth-aachen.de/eclipse/downloads/drops/R-
     
     
      
      3.2.2
     
     -200702121330/eclipse-JDT-3.2.2.zip
     
     

jdt.loc=http://www.mirrorservice.org/sites/download.eclipse.org/eclipseMirror/eclipse/downloads/drops/R-
     
     
      
      3.2.2
     
     -200702121330/eclipse-JDT-3.2.2.zip
     
     

3. 右键单击 Tomcat 6.0 项目节点，然后从弹出菜单中选择 Build。

现在，您已经完成了 Tomcat 服务器源代码。

运行 Tomcat

要运行 Tomcat 服务器，请执行以下操作：

1. 用登录名 admin 和密码 adminadmin 创建一个 Tomcat 用户。为了执行该操作，请在 <tomcat_root>/output/build/conf 目录下修改 tomcat-users.xml 文件以使其如下所示：

<?xml version='1.0' encoding='utf-8'?>
     
     

<tomcat-users>
     
     

  <role rolename="manager"/>
     
     

  <role rolename="admin"/>
     
     

  <user username="admin" password="adminadmin" roles="admin,manager"/>
     
     

</tomcat-users>
     
     

2. 在 Project 窗口中，右键单击 Tomcat 节点，然后从弹出菜单中选择 Start Tomcat。

请等待，直到您在 Output 窗口中看到一条类似于“INFO: Server startup in 7019 ms”的消息。

在您的 Web 浏览器中，键入 localhost:8080。您将看到 Tomcat 正在运行！

浏览默认情况下在您的 Tomcat 服务器上部署的应用程序。

3. 要停止运行 Tomcat，请右键单击 Tomcat 项目节点，然后从弹出菜单中选择 Stop Tomcat。

调试 Tomcat

1. 从 org.apache.catalina.startup 程序包中打开 Bootstrap.java 类，并在第 387 行设置一个断点。

2. 右键单击 Tomcat 项目节点，然后从弹出菜单中选择 Debug Project。

IDE 将打开 Debugger 窗口，在调试器中运行 Tomcat，直到达到断点为止。可以执行 Step Into、Step Over 和其他调试活动。
要完成调试，请按工具栏中的 Finish 按钮。

使用 Netbeans Profiler 配置 Tomcat 服务器

1. 在 Projects 窗口中，右键单击 Tomcat 项目节点，然后从弹出菜单中选择 Profile Project。

2. 在 Profile Tomcat 6.0 窗口中，接受默认值“CPU > Analyze Performance”，然后单击 Run 按钮。

将在 Netbeans IDE 中打开 Profiler 选项卡。

3. 在 Profiler 选项卡中，单击 VM Telemetry 查看内存（堆）更改等等。在运行的 Tomcat 上执行一些活动，即运行来自 Tomcat Web Application Manager 页面的不同 Web 应用程序，您将会看到如何更改内存堆的大小。

4. 要完成配置，请在 Profiler 选项卡中的 Controls 下按 Stop 按钮。还可以右键单击 Projects 选项卡中的 Tomcat 项目节点，然后从弹出菜单中选择 Stop Tomcat。

---

补遗：使用 NetBeans 5.5.1

如果您使用 NetBeans 5.5.1 ，请不要忘记单独安装 NetBeans Profiler 5.5.1。

与创建 Tomcat NetBeans 项目的步骤有一个差别。按照练习中说明的步骤：使用 nbproject551.zip 中（而不是 nbproject.zip）所述的步骤执行操作。NetBeans 5.5.1 对 project.xml files 使用旧版本的 XML 架构，nbproject551.zip 包含相应的文件。

---

小结

在本文中，您学习了如何执行以下任务：

                   将 Tomcat 转变为 Netbeans 项目。

                   构建并运行 Tomcat 项目。

                   调试 Tomcat。

                   使用 Netbeans Profiler 配置 Tomcat 服务器。

另请参阅

                   NetbeansedJRuby

                   NetbeansedJEdit

参考：

                   文档：http://www.netbeans.org/kb/index.html

                   获得问题：http://www.netbeans.org/issues/enter_bug.cgi

                   FAQ 列表：http://wiki.netbeans.org/wiki/view/NetBeansUserFAQ

                   Profiler 文档：http://www.netbeans.org/kb/55/profiler-index.html

附件

breakpoint.jpg		42691 字节
build-action.jpg		26970 字节
build-excluded-pkg.jpg		51689 字节
build_excluded_pkg_sm.PNG		27243 字节
debug-action.jpg		28263 字节
download-action.jpg		26896 字节
download-complete.jpg		39899 字节
nbproject-props.jpg		56852 字节
nbproject.zip		2654 字节
nbproject551.zip		2562 字节
open-nbproject.jpg		37795 字节
pr-property.jpg		52507 字节
pr_property.PNG		25341 字节
profile-action.jpg		27807 字节
profiler-window.jpg		45825 字节
profiler_window.PNG		31059 字节
profiling-tomcat1.jpg		111059 字节
profiling_tomcat1_sm.PNG		177333 字节
start-tomcat-output.jpg		27729 字节
start-tomcat.jpg		28479 字节
stop-debug.jpg		3899 字节
stop-tomcat.jpg		28301 字节
stop_tomcat.PNG		25486 字节
structure.jpg		34342 字节
structure1.JPG		34342 字节
tomcat-deploy-wa.jpg		108282 字节
tomcat-nbproject.jpg		17013 字节
tomcat-running.jpg		111351 字节
tomcat_deploy_wa_sm.PNG		140190 字节
tomcat_running_sm.PNG		222050 字节