JForum程序运行分析

时间:2021-10-30 19:50:23

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