jforum二次开发相关笔记——页面请求机制
2016-08-18 17:39
375 查看
原文章地址:http://my.oschina.net/thau/blog/483897
1. 引言
jforum是Rafael Steil开发的一个基于JAVA的开源论坛,采用BSD开源协议,可以最大限度的进行任何修改和扩展,包括商业用途。它提供了诸如SSO之类的抽象接口,具有完全的权限控制、支持包括中文在内的十几种语言、可自定义的用户接口、安全、多数据库支持等特性。JForum 采用 FreeMarker作为页面模板引擎。jforum的介绍这里不再敷述,因项目需要,需要对jforum进行修改、实现从CS平台登录以后单点登录到jforum,因为jforum只支持唯一用户名标识,所以还需对jforum进行二次开发。(注:本文的jforum版本为2.1.9。)
2. jforum的页面请求机制
将jforum导入到eclipse可以参考《搭建开源论坛之JForum安装+简易二次修改》。以最简单的在一个登陆用户进入个人资料页为例:
2.1 处理url
用户点击个人资料,页面请求的url为/user/edit/session中获取的用户Id如header.htm源码所示:
/jforum/WebContent/templates/default/header.htm
JForum中的JForumContext.encodeURL方法(注:实现在/jforum/src/net/jforum/context/JForumContext.java下)根据请求的url中的user和edit在modulesMapping.properties中查询user对应的配置项:
/jforum/WebContent/WEB-INF/config/modulesMapping.properties
2.2 查询action
根据请求的url中的edit在相应的UserAction中找到edit方法:
/jforum/src/net/jforum/view/forum/UserAction.java
edit()函数调用this.setTemplateName(TemplateKeys.USER_EDIT)设置最终展现页面的模版。TemplateKeys.USER_EDIT的静态变量值为“user.edit”,查“templatesMapping.properties”文件得知该模版的具体文件为“user_form.htm”。
2.3 查询dao层
根据action中的um.selectById(userId)请求UserDAO文件中的selectById方法:
/jforum/src/net/jforum/dao/UserDAO.java
UserDAO只是一个抽象的DAO接口,GenericUserDAO具体实现了UserDAO中定义的方法:
/jforum/src/net/jforum/dao/generic/GenericUserDAO.java
2.4 查询sql
根据GenericUserDAO文件中的UserModel.selectById查询sql文件中相应的sql:
/jforum/WebContent/WEB-INF/config/database/generic/generic_queries.sql
2.5 返回结果到页面
根据templatesMapping中的配置找到user.edit对应的页面/jforum/WebContent/WEB-INF/config/templatesMapping.properties
2.6 打印页面
在页面中填入查询到的值:
/jforum/WebContent/templates/default/user_form.htm
用户的实体类在/jforum/src/net/jforum/entities/User.java下。个人资料页如下图所示:
1. 引言
jforum是Rafael Steil开发的一个基于JAVA的开源论坛,采用BSD开源协议,可以最大限度的进行任何修改和扩展,包括商业用途。它提供了诸如SSO之类的抽象接口,具有完全的权限控制、支持包括中文在内的十几种语言、可自定义的用户接口、安全、多数据库支持等特性。JForum 采用 FreeMarker作为页面模板引擎。jforum的介绍这里不再敷述,因项目需要,需要对jforum进行修改、实现从CS平台登录以后单点登录到jforum,因为jforum只支持唯一用户名标识,所以还需对jforum进行二次开发。(注:本文的jforum版本为2.1.9。)
2. jforum的页面请求机制
将jforum导入到eclipse可以参考《搭建开源论坛之JForum安装+简易二次修改》。以最简单的在一个登陆用户进入个人资料页为例:
2.1 处理url
用户点击个人资料,页面请求的url为/user/edit/session中获取的用户Id如header.htm源码所示:
/jforum/WebContent/templates/default/header.htm
<a id="myprofile" class="mainmenu" href="${JForumContext.encodeURL("/user/edit/${session.userId}")}"> <img src="${contextPath}/templates/${templateName}/images/icon_mini_profile.gif" border="0" alt="[Profile]" /> ${I18n.getMessage("ForumBase.profile")} </a> <code class="lang-html hljs xml"><span class="xml"><span class="xml"> </span></span></code>
JForum中的JForumContext.encodeURL方法(注:实现在/jforum/src/net/jforum/context/JForumContext.java下)根据请求的url中的user和edit在modulesMapping.properties中查询user对应的配置项:
/jforum/WebContent/WEB-INF/config/modulesMapping.properties
user=net.jforum.view.forum.UserAction
2.2 查询action
根据请求的url中的edit在相应的UserAction中找到edit方法:
/jforum/src/net/jforum/view/forum/UserAction.java
public void edit() { if (this.canEdit()) { int userId = this.request.getIntParameter("user_id"); UserDAO um = DataAccessDriver.getInstance().newUserDAO(); User u = um.selectById(userId); this.context.put("u", u); this.context.put("action", "editSave"); this.context.put( "pageTitle", I18n.getMessage("UserProfile.profileFor") + " " +u.getUsername()); this.context.put("avatarAllowExternalUrl", SystemGlobals.getBoolValue(ConfigKeys.AVATAR_ALLOW_EXTERNAL_URL)); this.setTemplateName(TemplateKeys.USER_EDIT); } }
edit()函数调用this.setTemplateName(TemplateKeys.USER_EDIT)设置最终展现页面的模版。TemplateKeys.USER_EDIT的静态变量值为“user.edit”,查“templatesMapping.properties”文件得知该模版的具体文件为“user_form.htm”。
2.3 查询dao层
根据action中的um.selectById(userId)请求UserDAO文件中的selectById方法:
/jforum/src/net/jforum/dao/UserDAO.java
/** * Gets a specific <code>User</code>. * * @param userId The User ID to search * @return <code>User</code>object containing all the information * @see #selectAll */ public User selectById(int userId) ;
UserDAO只是一个抽象的DAO接口,GenericUserDAO具体实现了UserDAO中定义的方法:
/jforum/src/net/jforum/dao/generic/GenericUserDAO.java
/** * @see net.jforum.dao.UserDAO#selectById(int) */ public User selectById(int userId) { String q = SystemGlobals.getSql("UserModel.selectById"); PreparedStatement p = null; ResultSet rs = null; try { p = JForumExecutionContext.getConnection().prepareStatement(q); p.setInt(1, userId); rs = p.executeQuery(); User u = new User(); if (rs.next()) { this.fillUserFromResultSet(u, rs); u.setPrivateMessagesCount(rs.getInt("private_messages")); rs.close(); p.close(); // User groups p = JForumExecutionContext.getConnection().prepareStatement(SystemGlobals.getSql("UserModel.selectGroups")); p.setInt(1, userId); rs = p.executeQuery(); while (rs.next()) { Group g = new Group(); g.setName(rs.getString("group_name")); g.setId(rs.getInt("group_id")); u.getGroupsList().add(g); } } return u; } catch (SQLException e) { throw new DatabaseException(e); } finally { DbUtils.close(rs, p); } }
2.4 查询sql
根据GenericUserDAO文件中的UserModel.selectById查询sql文件中相应的sql:
/jforum/WebContent/WEB-INF/config/database/generic/generic_queries.sql
UserModel.selectById = SELECT COUNT(pm.privmsgs_to_userid) AS private_messages, u.* \ FROM jforum_users u \ LEFT JOIN jforum_privmsgs pm ON pm.privmsgs_type = 1 AND pm.privmsgs_to_userid = u.user_id \ WHERE u.user_id = ? \ GROUP BY pm.privmsgs_to_userid
2.5 返回结果到页面
根据templatesMapping中的配置找到user.edit对应的页面/jforum/WebContent/WEB-INF/config/templatesMapping.properties
user.edit = user_form.htm
2.6 打印页面
在页面中填入查询到的值:
/jforum/WebContent/templates/default/user_form.htm
<span class="gen"> <#if admin?default(false)> <input class="post" type="text" name="username" value="${u.username?html}" /> <#else> ${u.username?html} </#if> </span>
用户的实体类在/jforum/src/net/jforum/entities/User.java下。个人资料页如下图所示:
相关文章推荐
- jforum二次开发相关笔记——(一)页面请求机制
- jforum二次开发相关笔记——(一)页面请求机制
- 《Spring 3.x 企业应用开发实战》学习笔记 第三章 IoC容器概述 3.2 相关Java基础知识 类装载器 反射机制
- 微信小程序基本的开发框架抽取,包括网络请求的二次封装,页面状态管理,常见页面模板封装
- [Win8]Windows8开发笔记(七):页面样式的相关介绍
- WIN7下.Net开发遇到的又一问题:HTTP 错误 500.19 - Internal Server Error,无法访问请求的页面,因为该页的相关配置数据无效。
- WIN7下.Net开发遇到的又一问题:HTTP 错误 500.19 - Internal Server Error,无法访问请求的页面,因为该页的相关配置数据无效。
- 金蝶ERP二次开发笔记(二)----ID相关处理
- [Win8]Windows8开发笔记(七):页面样式的相关介绍
- 《Spring 3.x 企业应用开发实战》学习笔记 第三章 IoC容器概述 3.2 相关Java基础知识 类装载器 反射机制
- Asp.net 2.0 自定义控件开发专题[详细探讨页面状态(视图状态和控件状态)机制及其使用场景](示例代码下载)
- Asp.net 2.0 自定义控件开发专题[详细探讨页面状态(视图状态和控件状态)机制及其使用场景](示例代码下载)
- Asp.net 2.0 自定义控件开发专题[详细探讨页面状态(视图状态和控件状态)机制及其使用场景](示例代码下载)
- Asp.net 2.0 自定义控件开发专题[详细探讨页面状态(视图状态和控件状态)机制及其使用场景](示例代码下载)
- Asp.net 2.0 自定义控件开发专题[详细探讨页面状态(视图状态和控件状态)机制及其使用场景](示例代码下载)
- Asp.net 2.0 自定义控件开发专题[详细探讨页面状态(视图状态和控件状态)机制及其使用场景](示例代码下载)
- Asp.net 2.0 自定义控件开发专题[详细探讨页面状态(视图状态和控件状态)机制及其使用场景](示例代码下载)
- Asp.net 2.0 自定义控件开发专题[详细探讨页面状态(视图状态和控件状态)机制及其使用场景](示例代码下载)
- Asp.net 2.0 自定义控件开发专题[详细探讨页面状态(视图状态和控件状态)机制及其使用场景](示例代码下载)
- Asp.net 2.0 自定义控件开发专题[详细探讨页面状态(视图状态和控件状态)机制及其使用场景](示例代码下载)