Introduction

这篇文章介绍如何快速安装openfans。

svn下载代码

使用svn下载源码后，进入项目根目录，使用mvn eclipse:eclipse.(如初次使用，会花较长时间到网上下载plugin和jar，如果出错，不必担心，可以再次mvn eclipse:eclipse，已经下载成功的不会再下)。mvn eclipse:eclipse会生成.class和.project文件，可以进入项目的build path查看，会自动将output路径设为target/classes。

配置mysql

默认数据库使用mysql，如果希望马上运行，则创建一个新数据库，可以命名为openfans，如果mysql采用默认安装，则用户名root，密码为空，可以无需更改jdbc配置文件。要更改也很简单，在main/src下面有一个jdbc.properties文件，可以在这里更改数据库类型和用户名密码。这里有一句hibernate.hbm2ddl.auto=update，表示hibernate会自动更新建表语句，也就是新运行或更新了hbm文件再运行，hibernate都会自动帮你完成数据表的重建工作，这样你可以不用再考虑数据库建表脚本了。

直接在eclipse中运行

使用mvn eclipse:eclipse后，可以使用mvn -Declipse.downloadSources=true eclipse:eclipse，这样会自动下载source，并将其attach到eclipse中，有source的就可以直接查看源码了。如果是初次使用maven，需要在eclipse中window->preference->java->build path->classpath variables中增加M2_REPO指向maven repository的目录。在eclipse中，可以直接运行test/src/org.openfans.bin/RunJetty.java，启动jetty。端口在jetty-config.xml中配置的是80（可以自行修改），可以直接使用http://localhost 访问。

也可以使用merve插件进行调试或运行。这个插件内置了一个tomcat5.5的运行环境，能直接在eclipse中运行。updatesite：http://merve.sourceforge.net/updates/eclipse-3.2/ 插件安装后，使用mvn eclipse:eclipse生成项目，然后点击menu 的run新建一个merve tomcat plugin配置一些运行参数，就可以运行了，它做的很人性化，自动填好了很多参数，基本不用配置。点击debug就能进行调试了。

在tomcat中运行

如果想在tomcat里直接运行，则可以执行mvn package -Dtest，因为testCase有些数据依赖，所以使用-Dtest避免运行test。这里有一个地方要注意一下，就是web/WEB-INF/urlrewrite.xml，这是urlrewrite的配置文件，urlrewrite的描述在openfans网站里有，可以通过搜索urlrewrite快速的找到。因为我把文档根设为“/”，所以有比如<to type="redirect">/view$1.html\?id=$2</to>，如果文档根是openfans则需在/view前加上/openfans，成为<to type="redirect">/openfans/view$1.html\?id=$2</to>，然后再运行mvn package -Dtest,就会在target目录下生成openfans-o.1.war。将这个war更名为openfans.war，放到tomcat的webapps下，启动tomcat，应该就能通过http://localhost:8080/openfans 访问了。（假定你采用默认端口8080）。