这里以JForum论坛中的“最新主题”功能为例说明一个典型的JForum程序运行的过程。本文的目的是为了解JForum程序的运行过程,从而能够对JForum论坛进行一些简单的功能扩展。本文并不会对JForum论坛运行过程中的所有细节都进行详细描述。
“最新主题”的访问连接是“/recentTopics/list.page”我们查看文件“modulesMapping.properties”发现该功能模块的对应Java类是net.jforum.view.forum.RecentTopicsAction.java(在文件modulesMapping.properties中查找recentTopics关键字)。再对访问连接进行分析,得知该连接调用的是list()函数,没有传入参数。
list()函数片断如下:
Code:
<!-- Attachments -->
public void list() { int postsPerPage = SystemGlobals.getIntValue(ConfigKeys.POST_PER_PAGE); this.setTemplateName(TemplateKeys.RECENT_LIST); this.context.put("postsPerPage", new Integer(postsPerPage)); this.context.put("topics", this.topics()); this.context.put("forums", this.forums); this.context.put("pageTitle", I18n.getMessage("ForumBase.recentTopics")); TopicsCommon.topicListingBase(); this.request.setAttribute("template", null); }
list()函数调用this.setTemplateName(TemplateKeys.RECENT_LIST)设置最终展现页面的模版。TemplateKeys.RECENT_LIST的静态变量值为“recent.list”,查“templatesMapping.properties”文件得知该模版的具体文件为“recent_thread.htm”。
list()函数调用this.topics()获取最新主题,下面我们进一步分析topics()函数:
topics()函数调用TopicRepository.getRecentTopics()返回最新主题;判断主题访问权限;对主题进行预处理。
获得“最新主题”的数据后将会对页面模版进行处理并生成最终展现页面,页面模版的处理过程这里不作论述,以后有机会我们再进行详细分析。
下面对TopicRepository.getRecentTopics()进一步分析,该函数首先检查系统缓存中是否有“最新主题”的数据,如果有则直接返回,如果没有则调用 loadMostRecentTopics()获取数据并把最新数据保存到系统缓存中。
loadMostRecentTopics()调用TopicDAO.java的实现类来获取数据。JForum为了实现多数据库的支持采用了抽象类描述接口,以实现类编写具体数据库访问代码的机制。在这里TopicDAO.java的实现类是net.jforum.dao.generic.GenericTopicDAO.java。其中“selectRecentTopics()”的代码如下:
Code:
public List selectRecentTopics(int limit) { PreparedStatement p = null; try { p = JForumExecutionContext.getConnection().prepareStatement( SystemGlobals.getSql("TopicModel.selectRecentTopicsByLimit")); p.setInt(1, limit); List list = this.fillTopicsData(p); p = null; return list; } catch (SQLException e) { throw new DatabaseException(e); } finally { DbUtils.close(p); } }
通过SystemGlobals.getSql("TopicModel.selectRecentTopicsByLimit")获取具体的数据库查询语句,该SQL查询语句是定义在文件“/WEB-INF/config/database/generic/generic_queries.sql”中的。注意,对于不同的数据库这个数据SQL语句定义文件有可能不一样。
小结,如果你要实现一个类似“最新主题”的功能,你需要编写一个Action类并在配置文件“modulesMapping.properties”中定义该类的访问路径;编写一个页面模版,并在配置文件“templatesMapping.properties”中描述该模版,在“TemplateKeys.java”文件中增加相应的静态变量;编写数据访问DAO(Data access object)的抽象类与实现类,在SQL语句定义文件“/WEB-INF/config/database/generic/generic_queries.sql”中增加你的SQL查询语句定义。