JForum程序运行分析

　　转载：http://www.jeedao.net/posts/list/8.page

　　这里以JForum论坛中的“最新主题”功能为例说明一个典型的JForum程序运行的过程。本文的目的是为了解JForum程序的运行过程，从而能够对JForum论坛进行一些简单的功能扩展。本文并不会对JForum论坛运行过程中的所有细节都进行详细描述。
　　“最新主题”的访问连接是“/recentTopics/list.page”我们查看文件“modulesMapping.properties”发现该功能模块的对应Java类是net.jforum.view.forum.RecentTopicsAction.java（在文件modulesMapping.properties中查找recentTopics关键字）。再对访问连接进行分析，得知该连接调用的是list()函数，没有传入参数。
　　list()函数片断如下：
Code:

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