Java EE6 教程 第一部分 简介 2 使用教程中的例子

 

原文请参考：http://docs.oracle.com/javaee/6/tutorial/doc/gexaj.html

 

2.1. 如果要运行例子程序的话，以下软件是必须的：

 

• Java平台标准版
• Java EE 6软件开发套件
• Java EE 6教程组件
• NetBeans IDE
• Apache Ant

2.1.1 Java 平台标准版

 

为了构建、部署和运行例子程序，你需要一份Java平台标准版6.0开发套件（JDK6)，或者是Java平台标准版7.0开发套件(JDK7)。你可以从以下链接去下载JDK6或者JDK7：http://www.oracle.com/technetwork/java/javase/downloads/index.html

 

下载当前的JDK更新并不会包含其它的程序，比如NetBeans IDE或者是Java EE SDK.

 

 

2.1.2 Java EE 6软件开发套件

 

GlassFish 服务器开源版3.1.2作为例子程序的构建和运行环境。为了构建、部署和运行这些例子程序，你需要一份GlassFish服务器，或者可选的，NetBeans IDE。为了得到GlassFish服务器，你必须安装Java EE 6软件开发套件，你可以从以下链接进行下载： http://www.oracle.com/technetwork/java/javaee/downloads/index.html

注意要确保你下载的是Java EE 6 SDK，而不是Java EE 6 Web Profile SDK。

 

 

2.1.3 SDK安装的窍门

 

在安装SDK的过程中，进行以下设置：

 

• 允许安装程序下载和配置更新工具。如果你是通过防火墙来访问互联网的话，注意提供代理主机和端口。
• 配置GlassFish服务器管理员用户名为admin，不要设置密码。这些是缺省配置。
• 使用默认的管理端口（4848）和HTTP端口（8080）
• 不要勾选“为domain创建系统服务”

 

你可以等创建完成之后再启动domain，但这个并不是必须的。

 

这个教程中会经常提起as-install-parent，这个表示你安装GlassFish服务器的目录。比如，默认的安装目录是：C:\glassfish3，则as-install-parent为C:\glassfish3。GlassFish服务器自己安装到as-install下，即在as-install-parent下的glassfish目录。所以以刚才的例子来说，as-install则为C:\glassfish3\glassfish。

 

在你安装了GlassFish服务器之后，记得添加一下路径到环境变量PATH中：

 

as-install-parent/bin

as-install/bin

 

 

2.1.4 Java EE 6 教程组件

 

本教程的例子都在教程组件中，可以使用更新工具来获取教程组件。

 

使用更新工具来获取教程组件:

 

1. 通过以下方式来启动更新工具：

a. 从命令执行updatetoll来启动更新工具

b. 在Windows系统中，从开始菜单-所有程序，然后选择Java EE 6 SDK，然后选择 Start Update Tool。

 

2. 展开Java EE 6 SDK 节点

3. 选择可用更新

4. 从列表中勾选 Java EE 6 Tutorial

5. 点击安装

6. 确认接受license

 

在安装之后，Java EE 6 教程则会出现在已安装的组件中。该组件会被安装到as-install/docs/javaee-tutorial目录下。该目录包含两个子目录：docs和examples。其中，examples目录包含了在本教程中所讨论到的每个技术。

 

下一步

 

周期性的更新Java EE 6教程。对于如何得到这些更新的详细信息，请参考： Getting the Latest Updates to the Tutorial

 

2.1.5 NetBeans IDE

 

NetBeans是一个免费的开源的集成开发环境，用来开发Java应用程序，其中也包含企业级应用程序。NetBeans IDE支持Java EE平台。通过NetBeans IDE你可以构建、打包、部署和运行教程中的例子程序。

 

为了运行教程中的例子，你需要使用最新版本的NetBeans IDE。你可以在如下链接中下载：http://www.netbeans.org/downloads/index.html

 

2.1.5.1 安装NetBeans IDE除了GlassFish服务器

 

当你安装NetBeans IDE的时候，请不要安装NetBeans IDE自带的GlassFish版本。执行以下操作来跳过GlassFish服务器的安装：

 

1. 在NetBeans IDE安装的第一个页面，不要勾选关于GlassFish 服务器的选择框，然后点击OK。

 

2. 接受关于License协议和Junit license协议。（一些教程的例子使用到了Junit库，所以你需要安装它）

 

3. 继续安装NetBeans IDE的其它操作。

 

2.1.5.2 在NetBeans IDE中添加GlassFish服务器

 

为了在NetBeans IDE中运行教程中的例子，你必须在NetBeans IDE中安装Glass Fish服务器。执行以下操作来实现这个目标：

 

1. 打开NetBeans IDE，从菜单栏中选择“工具”-“服务器”

 

2. 在打开的配置页面中点击“添加服务器”

 

3. 在列表中选择“GlassFish Server 3+，然后点击下一步

 

4. 在安装位置的配置中，浏览到Java EE 6 SDK的安装位置，即as-install-parent，然后点击下一步

 

5. 在Domain位置的配置中，选择Register local domain

 

6. 点击完成

 

2.1.6 Apache Ant

 

Ant由Apatch软件基金会开发的基于Java技术的构建工具，它被用来构建、打包和部署教程中的例子程序。你需要使用Ant 1.7.1或者更高的版本来运行教程中的例子。如果你还没有安装Ant，你可以从更新工具中安装它。

 

如何得到Ant:

 

1. 运行更新工具

a. 从命令行执行udpatetool

b. 在Windows系统中，从开始菜单，选择所有应用程序，然后选择Java EE 6 SDK，接着选择Start Update Tool。

 

2. 展开Java EE 6 SDK 节点

 

3. 选中 可用的附加软件

 

4. 在列表中勾选Apache Ant Build Tool

 

5. 点击安装

 

6. 接受licesen协议

 

在安装结束之后，Ant会出现在已安装组件的列表中。同时，这个工具被安装到了as-install-parent/ant目录下。

 

下一步

 

为了使用ant命令，添加as-install-parent/ant/bin到你系统的path环境变量中。

 

 2.2 启动和关闭GlassFish服务器

 

如果要从命令行启动GlassFish，可在命令行输入：

 

asadmin start-domain --verbose

 

一个服务器管理着的一个或多个GlassFish实例组成的集合称为域。对于一个域来讲，有以下一些相关参数：

 

• GlassFish服务器的端口默认是8080
• GlassFish服务器管理端口默认是4848
• 管理员的默认用户名是admin，默认密码是空

你可以在你安装服务器的时候指定这些参数。在这个教程中的例子则认为你选择使用默认的端口，和默认的用户名、密码。

 

当不添加任何参数的时候，start-domain表示启动默认的域，也就是domain1。--verbose标志表示所有的日志和调试信息将会输出到控制台。同时，这些信息也会输出到服务器日志中，服务器的日志文件位于：domain-dir/logs/server.log。

 

或者，在windows系统下，从开始菜单-所有程序，选择Java EE 6 SDK, 然后选择启动应用服务器。

 

如果想停止GlassFish服务器的话，打开命令行然后执行以下命令：

 

asadmin stop-domain domain1

 

或者，在Windows系统下，从开始菜单-所有程序，选择Java EE 6 SDK，然后选择关闭应用服务器。

 

在Netbeans IDE下启动GlassFish服务器：

 

a. 点击服务tab页（在我的电脑上是在菜单栏点击“窗口”-“服务”打开的）

b. 展开服务器节点

c. 右键GlassFish Server节点，然后选择“启动”

 

在Netbeans IDE下，如果你想关闭GlassFish的话，右键GlassFish Server节点，然后选择“停止”。

 

2.3 启动管理控制台

 

为了管理GlassFish服务器和用户、资源、及Java EE的应用，你可以使用管理控制台工具。注意在启动管理控制台工具之前，GlassFish服务器必须先启动，然后可以打开浏览器输入：http://localhost:4848/来进入控制台界面。

 

或者，在Windows系统下，从开始菜单-选择所有程序，然后选择Java EE 6 SDK，然后选择管理控制台。（NF：在我的电脑上是没看到有这个东西的）

 

在NetBeans IDE下启动管理控制台：

 

1. 点击“服务”TAB页

2. 展开“服务器”节点

3. 右键GlassFish服务器实例，然后选择“查看域管理控制台”

 

2.4 开启和关闭Java DB 服务器

 

GlassFish服务器已经包含了Java DB 服务器。

 

从命令可以启动Java DB服务器，打开一个终端控制台或者命令提示行然后执行：

 

asadmin start-database

 

从命令行可以关闭Java DB服务器，打开一个终端控制台或者命令提示行然后执行：

 

asadmin stop-database

 

对于关于Java DB的更多信息，请参考：http://www.oracle.com/technetwork/java/javadb/overview/index.html

 

使用NetBeans IDE来启动数据库服务器:

 

1.点击“服务”TAB页

2. 展开“数据库”节点

3. 右键Java DB然后选择“启动”

 

下一步：

 

如果你想使用NetBeans IDE来关闭数据库的话，右键Java DB然后选择“停止”。

 

2.5 构建例子程序

 

教程例子中已经包含着一个针对NetBeans IDE和Ant的配置文件。NetBeans IDE或者是Ant都有可能被用来构建、打包、部署和运行例子程序。关于例子中的目录介绍将会在下面章节进行。

 

2.6 教程中例子的目录结构

 

为了更好的进行迭代开发、分离源文件和编译文件，教程中的例子采用Java BluePrints应用程序目录结构。

 

每个应用模块都遵从一下结构：

 

• build.xml： Ant构建文件
• src/java: 该模块的Java 源文件
• src/conf: 该模块的配置文件，web应用程序除外
• web: web页面、样式表、标签文件和图片（只有web应用才有）
• web/WEB-INF: 针对web应用的配置文件（只有web应用才有）
• nbproject: NetBeans 项目文件

 

当一个例子由多个应用模块被打包到一个EAR文件时，它的子模块目录使用如下命名约定：

 

• example-name-app-client：应用客户端
• example-name-ejb: 企业bean的jar文件
• example-name-war： web应用程序

 

例子中的Ant构建文件（build.xml）将会创建一个build子目录然后拷贝和编译一些文件到build目录中。dist子目录将会包含打包后的模块文件，还有一个client-jar目录，将会保存客户应用的JAR文件。

 

tut-install/examples/bp-project/目录包含着额外的Ant target，这些target会被build.xml中的target调用。

 

对于一些web应用，Ant target将会在浏览器中打开例子的URL。这些在windows系统下是自动处理的。如果你运行在UNIX系统，你可能需要修改 tut-install/examples/bp-project/build.properties文件，删除关于default.browser属性的注释，然后设置到特定的浏览器打开命令。当然，如果你不做任何修改，你也可以选择自己手工输入URL到浏览器来打开。

 

2.7 获得关于教程的最近的更新

 

通过使用Java EE 6 SDK包含的Update Center来检查关于教程的任何更新。

 

通过Update Center来更新教程：

 

1. 在NetBeans IDE中打开“服务”TAB页，然后展开服务器节点。

2. 右键GlassFish服务器实例，然后选择“查看域更新中心”。

3. 选中“可用更新”然后会显示出一系列可以更新的包。

4. 找到对于Java EE 6教程的更新包（javaee-tutorial）。

5. 如果有一个教程的更新版本，选中Java EE 6教程（javaee-tutorial），然后点击“安装”。

 

2.8 调试Java EE应用

 

这一节将会介绍如何确定错误是在你的应用部署上导致的，还是由程序运行导致的。

 

2.8.1 使用服务器日志

 

调试应用程序的一个方法就是查看服务器日志，该日志文件保存在：domain-dir/logs/server.log. 日志文件包含着GlassFish服务器和你的应用的输出。在Java类中记录消息，你可以通过System.out.println语句、或者Java Logging API（http://docs.oracle.com/javase/6/docs/technotes/guides/logging/index.html）、或者如果在web组件中可以调用ServletContext.log方法。

 

如果你使用NetBeans IDE, 日志输出到服务器日志的同时也会出现在输出窗口。

 

如果你启动GlassFish服务器的时候添加了--verbose参数，所有的日志和调试输出将会出现在终端窗口或者命令提示符，同时也会输出到服务器日志文件中。如果你在后台启动GlassFish服务器，调试信息只会保存在日志中。你可以通过文本编辑器或者是管理控制台的日志查看器来查看服务器日志。

 

如何使用管理控制台的日志查看器：

 

1. 选择GlassFish服务器节点。

2. 点击“查看日志文件”按钮。

 

日志查看器将会打开同时显示最近的40条记录。

 

3. 如果想显示其它的记录，请执行以下步骤：

 

a. 点击“搜索修改”按钮（NF：没发现这个按钮有用？？）

b. 输入任何关于你想查看记录的约束

c. 点击“搜索”按钮

 

 

2.8.2 使用调试器

 

GlassFish服务器支持Java平台调试架构（JPDA），通过JPDA，你可以配置GlassFish服务器来通过socket进行debug。

 

使用Debugger来debug一个应用程序：

 

1. 使用管理控制台来开启GlassFish服务器的debug功能：

 

a. 展开“Configurations”节点，然后展开“server-config”节点。

b. 选中“JVM Settings”节点。默认的debug选项被设置为：

 

 

-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=9009

 

你可以看到，默认的端口是9009。你可以修改为其它没被占用的端口。

 

c. 勾选“Debug Enabled”

d. 点击“Save”按钮

 

2. 停止GlassFish服务器然后重新启动它。