JForum程序运行分析

       这里以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查询语句定义。