jforum学习资源
论坛系统
JForum mvnforum
mvnForum没有用任何的web框架，仅用servlet/jsp就实现了强大的论坛功能
JForum展示层介绍
JForum论坛没有使用主流的MVC框架，而是自己实现了一套简单的MVC框架。
JForum的MVC框架和现在流行的Struts2一样，使用了与web容器松耦合的设计，并没有直接为用户暴露HttpServletRequest和HttpServletResponse接口，而是提供了net.jforum.context.RequestContext和net.jforum.context.ResponseContext这两个接口，与Struts2不同的是JForum的action还是需要继承net.jforum.Command这个对象，并非一个简单的POJO。
JForum页面显示并没有使用JSP，而是使用freemarker的模板，框架本身与freemarker耦合在了一起，并非像Struts2可以灵活的替换显示方式。
基本开发流程
开发JForum的Action非常简单，首先我们要从几个方面入手。
1.建立action
新建一个类继承与net.jforum.Command
2.注册action
到JForum的WEB-INF/config目录找到modulesMapping.properties，在里面配置一个模块名称和对应的类
如：test=net.jforum.view.test.TestAction
3.注册模板
到JForum的WEB-INF/config目录找到templatesMapping.properties
在里面配置一个模板名称对应一个具体的显示页面(页面默认都要放在templates/default目录下)
如：test.show= test_show.htm
修改net.jforum.util.preferences.TemplateKeys类
在里面配置常量
如：
public static final String TEST_SHOW = "test.show";
4.新建方法
Java代码
private void show()
{
//选择显示模板
this.setTemplateName(TemplateKeys.TEST_SHOW);
//组装模板变量
this.context.put("title", request.getParameter("title"););
this.context.put("description", request.getParameter("description"););
}
5.配置参数映射
到JForum的WEB-INF/config目录找到urlPattern.properties
在里面配置参数
如：test.show.2 = title, description
模块名称.方法名称.方法参数个数=参数1名称，参数2名称...
6.运行
完成以上操作后访问
http://localhost:8080/test/show/arg1/arg2.page
这里说一下JForum的url的解析方式，这里举个例子:
http://localhost:8080/test/show/arg1/arg2.page
这个Url的实际含义是:
http://localhost:8080/jforum/模块名称/方法名称/参数1/参数2.page
modulesMapping.properties中的配置：
test=net.jforum.view.test.TestAction
这里的test就是模块名称
urlPattern.properties中的配置：
test.show.2 = title, description
这里的title和description就是参数1和参数
之后在action中通过
request.getParameter("description");
request.getParameter("title");
可以取得它们的值
小结：
在JForum中建立一个action应该说还是比较容易的，在这里它选用freemarker做为显示方式想必也是为了方便美工编辑和美化模板，毕竟对于美工来讲htm编辑起来绝对是比jsp来的方便的。
--------------------------------------------------------------------
jforum 配置
文章分类:Web前端
jforum-2.1.8 详细配置
关键字: jforum
本文介绍JForum的安装。
JForum的运行环境：
开始本文之前，我们确认一下JForum的运行环境。
- Java动态运行环境（JRE）
参考：环境篇 - 构造Java开发环境
该文介绍了怎么在Windows以及Linux下安装Java环境
- 支持J2EE Servlet标准的任何一款Web服务器 ：Tomcat，JBoss，Weblogic等
参考：
篇一：Windows 环境下 Web服务器Tomcat的安装与使用入门
篇二：Linux 环境下 Web服务器Tomcat的安装与使用入门
- 下列任意一款关系数据库 ：Generic，HsqlDB，MySql，Oracle，PostgreSQL。
确认了已经准备好了JForum的运行环境之后，让我们开始JForum的安装之旅吧。
本文的测试环境：
- JForum 2.1.8
- J2SE6.0
- Tomcat5.5.17
- MySQL5.0.6
JForum的安装步骤
1，JForum的下载。
到JForum的官方网站上下载JForum的最新版本。目前（2008年3月）的最新版本是2.1.8。
2，准备数据库（本文使用MySQL）
2.1 创建jforum数据库，设置为utf-8编码。 utf-8编码可以在安装时默认设置为utf-8编码，或者单独设置。
C:\> cd mysql
C:\mysql\bin\>mysql -u root -p
Enter password:
mysql> CREATE DATABASE jforum DEFAULT CHARACTER SET utf8;
mysql> exit
Bye
C:\mysql\bin\>
2.2 创建数据库用户分配给其足够的权限
C:\mysql\bin\>mysql -u root -p
Enter password:
GRANT ALL PRIVILEGES ON *.* TO jforum_user@localhost IDENTIFIED BY 'my_password' WITH GRANT OPTION;
GRANT ALL PRIVILEGES ON *.* TO jforum_user@"%" IDENTIFIED BY 'my_password' WITH GRANT OPTION;
mysql> flush privileges;
mysql> exit
Bye
C:\mysql\bin\>
用户名/密码根据自己的情况设置。
2.3 执行JForum数据库创建脚本 （/WEB-INF/config/database/mysql/mysql_db_struct.sql）
C:\mysql\bin\>mysql jforum -u root -p <password> < 路径\mysql_db_struct.sql
<password>为用户密码
2.4 执行JForum初始化数据脚本 （/WEB-INF/config/database/mysql/mysql_data_dump.sql）
执行方法同上。
至此，数据库的准备工作完成。
3，修改全局配置文件SystemGlobals.properties
打开WEB-INF/config/SystemGlobals.properties文件，做以下修改：
3.1 查找database字样，确认[DATABASE SETTINGS]数据库设置正确。默认设置为mysql，若使用其他数据库，则需要修改。
3.2 修改forum.link，homepage.link等配置。
根据JForum版本的不同，可能是WEB-INF/config/jforum-custom.conf。请根据实际情况修改。
4，修改数据库配置文件mysql.properties
打开/WEB-INF/config/database/mysql/mysql.properties文件，根据刚才数据库的设置情况加以修改。
5，deploy jforum.war
将jforum.war或者解压缩之后的文件夹jforum拷贝到TOMCAT_HOME/webapps/目录
解压缩后的jforum目录具有以下阶层：
jforum
\images
\templates
\upgrade
\WEB-INF
...
index.htm
...
（可以将上面的jforum文件夹下的文件（不包含jforum目录本身）打包为一个jforum.zip，然后重新命名为jforum.war也可）
（JBoss服务器的情况，可以将jforum.war拷贝到 JBOSS_HOME/server/default/deploy目录下）
6，启动TOMCAT服务器
执行$TOMCAT_HOME/bin/startup.bat
7，打开浏览器，访问：
http://localhost:8080/jforum/
进入jforum的数据库初始化页面，进行初始化。
默认显示语言选择Chinese Simplifed (zh_CN)，数据库选择utf-8编码。
完成设置。
至此，JForum论坛安装完成。
JForum mvnforum
mvnForum没有用任何的web框架，仅用servlet/jsp就实现了强大的论坛功能
JForum展示层介绍
JForum论坛没有使用主流的MVC框架，而是自己实现了一套简单的MVC框架。
JForum的MVC框架和现在流行的Struts2一样，使用了与web容器松耦合的设计，并没有直接为用户暴露HttpServletRequest和HttpServletResponse接口，而是提供了net.jforum.context.RequestContext和net.jforum.context.ResponseContext这两个接口，与Struts2不同的是JForum的action还是需要继承net.jforum.Command这个对象，并非一个简单的POJO。
JForum页面显示并没有使用JSP，而是使用freemarker的模板，框架本身与freemarker耦合在了一起，并非像Struts2可以灵活的替换显示方式。
基本开发流程
开发JForum的Action非常简单，首先我们要从几个方面入手。
1.建立action
新建一个类继承与net.jforum.Command
2.注册action
到JForum的WEB-INF/config目录找到modulesMapping.properties，在里面配置一个模块名称和对应的类
如：test=net.jforum.view.test.TestAction
3.注册模板
到JForum的WEB-INF/config目录找到templatesMapping.properties
在里面配置一个模板名称对应一个具体的显示页面(页面默认都要放在templates/default目录下)
如：test.show= test_show.htm
修改net.jforum.util.preferences.TemplateKeys类
在里面配置常量
如：
public static final String TEST_SHOW = "test.show";
4.新建方法
Java代码
private void show()
{
//选择显示模板
this.setTemplateName(TemplateKeys.TEST_SHOW);
//组装模板变量
this.context.put("title", request.getParameter("title"););
this.context.put("description", request.getParameter("description"););
}
5.配置参数映射
到JForum的WEB-INF/config目录找到urlPattern.properties
在里面配置参数
如：test.show.2 = title, description
模块名称.方法名称.方法参数个数=参数1名称，参数2名称...
6.运行
完成以上操作后访问
http://localhost:8080/test/show/arg1/arg2.page
这里说一下JForum的url的解析方式，这里举个例子:
http://localhost:8080/test/show/arg1/arg2.page
这个Url的实际含义是:
http://localhost:8080/jforum/模块名称/方法名称/参数1/参数2.page
modulesMapping.properties中的配置：
test=net.jforum.view.test.TestAction
这里的test就是模块名称
urlPattern.properties中的配置：
test.show.2 = title, description
这里的title和description就是参数1和参数
之后在action中通过
request.getParameter("description");
request.getParameter("title");
可以取得它们的值
小结：
在JForum中建立一个action应该说还是比较容易的，在这里它选用freemarker做为显示方式想必也是为了方便美工编辑和美化模板，毕竟对于美工来讲htm编辑起来绝对是比jsp来的方便的。
--------------------------------------------------------------------
jforum 配置
文章分类:Web前端
jforum-2.1.8 详细配置
关键字: jforum
本文介绍JForum的安装。
JForum的运行环境：
开始本文之前，我们确认一下JForum的运行环境。
- Java动态运行环境（JRE）
参考：环境篇 - 构造Java开发环境
该文介绍了怎么在Windows以及Linux下安装Java环境
- 支持J2EE Servlet标准的任何一款Web服务器 ：Tomcat，JBoss，Weblogic等
参考：
篇一：Windows 环境下 Web服务器Tomcat的安装与使用入门
篇二：Linux 环境下 Web服务器Tomcat的安装与使用入门
- 下列任意一款关系数据库 ：Generic，HsqlDB，MySql，Oracle，PostgreSQL。
确认了已经准备好了JForum的运行环境之后，让我们开始JForum的安装之旅吧。
本文的测试环境：
- JForum 2.1.8
- J2SE6.0
- Tomcat5.5.17
- MySQL5.0.6
JForum的安装步骤
1，JForum的下载。
到JForum的官方网站上下载JForum的最新版本。目前（2008年3月）的最新版本是2.1.8。
2，准备数据库（本文使用MySQL）
2.1 创建jforum数据库，设置为utf-8编码。 utf-8编码可以在安装时默认设置为utf-8编码，或者单独设置。
C:\> cd mysql
C:\mysql\bin\>mysql -u root -p
Enter password:
mysql> CREATE DATABASE jforum DEFAULT CHARACTER SET utf8;
mysql> exit
Bye
C:\mysql\bin\>
2.2 创建数据库用户分配给其足够的权限
C:\mysql\bin\>mysql -u root -p
Enter password:
GRANT ALL PRIVILEGES ON *.* TO jforum_user@localhost IDENTIFIED BY 'my_password' WITH GRANT OPTION;
GRANT ALL PRIVILEGES ON *.* TO jforum_user@"%" IDENTIFIED BY 'my_password' WITH GRANT OPTION;
mysql> flush privileges;
mysql> exit
Bye
C:\mysql\bin\>
用户名/密码根据自己的情况设置。
2.3 执行JForum数据库创建脚本 （/WEB-INF/config/database/mysql/mysql_db_struct.sql）
C:\mysql\bin\>mysql jforum -u root -p <password> < 路径\mysql_db_struct.sql
<password>为用户密码
2.4 执行JForum初始化数据脚本 （/WEB-INF/config/database/mysql/mysql_data_dump.sql）
执行方法同上。
至此，数据库的准备工作完成。
3，修改全局配置文件SystemGlobals.properties
打开WEB-INF/config/SystemGlobals.properties文件，做以下修改：
3.1 查找database字样，确认[DATABASE SETTINGS]数据库设置正确。默认设置为mysql，若使用其他数据库，则需要修改。
3.2 修改forum.link，homepage.link等配置。
根据JForum版本的不同，可能是WEB-INF/config/jforum-custom.conf。请根据实际情况修改。
4，修改数据库配置文件mysql.properties
打开/WEB-INF/config/database/mysql/mysql.properties文件，根据刚才数据库的设置情况加以修改。
5，deploy jforum.war
将jforum.war或者解压缩之后的文件夹jforum拷贝到TOMCAT_HOME/webapps/目录
解压缩后的jforum目录具有以下阶层：
jforum
\images
\templates
\upgrade
\WEB-INF
...
index.htm
...
（可以将上面的jforum文件夹下的文件（不包含jforum目录本身）打包为一个jforum.zip，然后重新命名为jforum.war也可）
（JBoss服务器的情况，可以将jforum.war拷贝到 JBOSS_HOME/server/default/deploy目录下）
6，启动TOMCAT服务器
执行$TOMCAT_HOME/bin/startup.bat
7，打开浏览器，访问：
http://localhost:8080/jforum/
进入jforum的数据库初始化页面，进行初始化。
默认显示语言选择Chinese Simplifed (zh_CN)，数据库选择utf-8编码。
完成设置。
至此，JForum论坛安装完成。