体验日程追踪系统(TimeTracker Tour)

翻译者：Jason S.H.Chen
（英文地址：http://www.andromda.org/index.php?option=com_content&view=article&id=112:timetracker-tour&catid=42:getting-started-java&Itemid=89）

在我们开始开发日志跟踪系统之前，我们先一起来体验一下日志跟踪系统最终系统的效果。这将让你对你将着手开发的系统有一个更直观的认识，了解开发的终极目标。不仅如此，你还将获得亲手使用各种相关开发工具的经验，比如MySQL管理工具，JBoss应用服务器等。但你正式开始开发日志跟踪系统时，这些对你非常有用。
按照下面的步骤构建运行日志跟踪系统。
1. 下载日志跟踪系统的源代码文件timetracker-completed,在c盘解压文件。你将得到C:\timetracker-completed这个目录。（注意：如果你决定在其他目录下解压文件，请确保你的目录路径中没有空白符；否则maven在构建的时候会出问题）。
2. 如果你下载的MySQL的驱动程序的版本不是5.0.4，则你必须修改C:\timetracker-completed\pom.xml这个文件。在此文件中找到2处MySQL驱动程序版本号5.0.4的地方，将版本号改成你所下载的MySQL的驱动程序的版本号即可。
3. 开启一个dos窗口，将当前目录改变到C:\timetracker-completed目录。
4. 执行mvn install 命令开始构建应用系统。此步将从远程Maven库中下载构建日志跟踪系统所需要的所有库文件。这些所需要的库文件由日志跟踪系统源文件目录树下的所有pom.xml文件所指定。因为有相当数量的库文件要下载，所以此步将需要比较长的时间。但是，当你下次在构建系统的时候将要快得多，因为所有依赖的库文件都已经下载到本地Mavne库中。（注意：有时会因为网络问题或服务器负载过大的问题而不能下载完系统所依赖的所有库文件，如果你遇到此问题请重新执行此命令直到此命令最终成功执行。译者在执行这个命令时，也遇到这样的问题，某个库文件只下载了部分而出现问题；当你再此执行此命令时，maven不会再下载上次没下载完毕的库文件，这样的结果是最后你编译的时候，可能会提示某个库文件中的某些类不存在，如果你遇到这个问题的话，请你到maven本地库中去找到这个库文件，将他删除并重新执行此命令。）
5. 让刚才开启的dos窗口保持开启状态，我们继续后面的步骤。
6. 创建日志跟踪系统存储数据的数据库。我们将创建一个名为timetracker的数据库，一个名为timetracker的用户，且timetracker拥有完全控制timetracker数据库的权限。
a) 开启MySQL管理工具，以root用户登录。
b) 在导航条（Navigation Bar）点击目录（Catalogs）。
c) 右击下面左面板（也叫 Schemata），并选择新建数据库（Create New Schema）。
d) 数据库（schema）的名字输入timetracker,点击确定。
e) 点击左边导航条的【用户管理】（User Administrator）。
f) 点击【创建用户】（New User），创建一个用户名为timetracker的用户，密码也设置为timetracker.
g) 选择数据库权限选项卡（Schema Privileges），并选中数据库timetracker。
h) 点击【<<】按钮将对timetracker数据库的所有权限授予给用户timetracker，并点击【应用】（Apply Changes）按钮。
i) 关闭MySQL管理工具。
7. 现在我们来创建日志跟踪系统运行所需要的数据库。在先前开启的dos窗口中输入下面的命令即可（运行此命令前，请确保步骤4中的mvn install已经成功执行）：
mvn -f core/pom.xml andromdapp:schema -Dtasks=create
8. 现在数据库表结构已经建好，我们现在将演示用到的数据导入数据表中。按照下面的步骤执行即可：
a) 运行MySQL查询浏览器（MYSQL Query Broser），以timetracker登录。
b) 依次选择 【文件】（File）>【打开脚本】（OpenScript），并选择C:\timetracker-completed\app\src\main\sql\static-data-insert.sql文件，然后点选【执行】（Execute）按钮，执行该文件中的SQL脚本，将演示需要的用户和任务数据导入数据库中。
c) 依照步骤b)的方法执行同目录下test-data-insert.sql文件中的脚本插入测试用到的考勤数据和时间分配数据。
d) 关闭MySQL查询浏览器。
9. 让我们先启动JBoss应用服务器吧，只有这样我们才可以将日志跟踪系统部署到JBoss应用服务器上。打开另外一个dos窗口，并将窗口的当前目录切换到JBoss应用服务器安装目录下的bin目录，比如（C:\jboss-4.0.5\bin）；执行命令: run. JBoss应用服务器开始启动，直到屏幕出现如下提示启动成功的消息：19:50:01,285 INFO [Server] JBoss (MX MicroKernel) [4.0.5.GA (build: CVSTag=JBoss_4_0_4_GA date=200605151000)] Started in 39s:517ms.
10. 现在我们已经准备好将应用部署到JBoss应用服务器上。到先前你运行过mvn install这个命令的dos窗口，执行下面的命令： mvn -f app/pom.xml –Ddeploy  你会发现TimeTracker EAR将被拷贝到JBoss应用服务器的部署目录下（C:\jboss-4.0.5\server\default\deploy）并且JBoss的控制台会显示日志跟踪系统正在部署的信息。直到JBoss控制台的屏幕上出现如下部署成功的提示信息：19:59:53,767 INFO [EARDeployer] Started J2EE application: file:/D:/jboss-4.0.5/server/default/deploy/timetracker-1.0-SNAPSHOT.ear.
11. 现在我们已经部署好日志跟踪系统，那我们去看看系统吧。打开浏览器，在地址栏输入：http://localhost:8080/timetracker（如果你修改过JBoss应用服务器的http端口，则要把8080端口修改成对应的端口） 回车。浏览器将显示系统的登录界面。
12. 以用户“nbhatia”登录系统，该用户的密码是“cooldude”。登录系统后，你在系统主界面上可以看到对应的功能选项。
13. 你可以仔细运行系统的每个功能，充分熟悉系统中的所有功能。当你对所有功能都熟悉后，你可删除应用。在JBoss控制台中输入 Control+C关闭JBoss应用服务器。
14. 我们需要先删除数据库中的所有数据表，一边我们从头开始构建系统。在运行mvn install的dos窗口中运行下面的命令即可：mvn -f core/pom.xml andromdapp:schema -Dtasks=drop
好，你已经对日志跟踪系统中所有的功能都非常熟悉了，你准备好了从头开始构建这个系统了吗？如果你很肯定的回答准备好了，那下节我们就开始吧。