openfans快速配置指南

应牛牛和 lucky 的要求，写一份 openfans 的快速配置指南，也就是介绍如何在你的机器上把下载下来的 openfans 跑起来。首先使用 maven ，需要下载 maven ， www.openfans.net 里可以输入 maven 进行搜索，有它的介绍和主页，还有我写的一篇简单的 maven 上手文章。

如果使用 eclipse ，在项目根目录，也就是 pom.xml 所在目录，运行 mvn eclipse:eclipse( 如初次使用，会花较长时间到网上下载 plugin 和 jar ，建议去喝杯咖啡 ) 。 mvn eclipse:eclipse 会生成 .class 和 .project 文件，可以进入项目的 build path 查看，会自动将 output 路径设为 target/classes 。默认数据库使用 mysql ，如果希望马上运行，则创建一个新数据库，可以命名为 openfans ，如果 mysql 采用默认安装，则用户名 root ，密码为空，可以无需更改 jdbc 配置文件。要更改也很简单，在 main/src 下面有一个 jdbc.properties 文件，可以在这里更改数据库类型和用户名密码。这里有一句 hibernate.hbm2ddl.auto=update ，表示 hibernate 会自动更新建表语句，也就是新运行或更新了 hbm 文件再运行， hibernate 都会自动帮你完成数据表的重建工作，这样你可以不用再考虑数据库建表脚本了。

如果想在 tomcat 里直接运行，则可以执行 mvn package ，会运行所有 test case 。目前的 test case 通过继承 AbstractTransactionalDataSourceSpringContextTests ，能够方便的实现数据库回滚，在 BaseTest 类下有一句 this.setDefaultRollback(false) ，如果希望通过程序填充数据，就 uncomment 它。这里有一个地方要注意一下，就是 web/WEB-INF/urlrewrite.xml ，这是 urlrewrite 的配置文件， urlrewrite 的描述在 openfans 网站里有，可以通过搜索 urlrewrite 快速的找到。因为我把文档根设为“ / ”，所以有 <to type="redirect">/view$1.html\?id=$2</to> ，如果文档根是 openfans 则需在 /view 前加上 /openfans ，然后再运行 mvn package 。测试全部通过，就会在 target 目录下生成 openfans-o.1.war ，将这个 war 放到 tomcat 的 webapps 下，启动 tomcat ，应该就能通过 http://localhost:8080/openfans 访问了（假定你采用默认端口 8080 ）。

如果进行开发，可以安装 eclipse-tomcat 插件，插件也可以在 openfans 网站输入 tomcat 进行搜索。可以在 tomcat 的 conf/Catalina/localhost 下创建一个 openfans.xml ，内容如下：

<?xml version="1.0" encoding="UTF-8"?>

<Context path="/openfans" reloadable="true" docBase="D:/javaproject/openfans/web">

</Context>

docBase 改成你的 openfans 所在的路径。
   这里因为pom文件定义的默认输出位置为target，需改为web-inf/classes，这时会有一个src冲突，需把src/web/里的web-inf/classes exclude掉就可以了。
然后在 eclipse 启动 tomcat ，同样可以通过 http://localhost:8080/openfans 访问了。用这种方式启动 tomcat 可以进行调试。

<!----> <o:p> </o:p>