文/For A

怎么才算好的源碼分析呢？當(dāng)然我這個肯定不算。我想大概分為幾個層面吧，寫寫注釋那算最基本的了，寫寫要點思路和難點，算是還不錯拉，再難的就是跳出源碼舉一反三，形成自己的一套思路吧。

這次針對的是jforum2.1.8,大概jforum團隊已經(jīng)沒心情理這個版本了，都沖著jforum3去了。選擇這個版本，主要是因為jforum在java論壇類應(yīng)用中算是佼佼者了，很多人都拿這個來做二次開發(fā)，而jforum3使用的是另外一套架構(gòu)了，而且還沒完全release，所以斟酌一下，還是選擇這個經(jīng)典的版本。

關(guān)于jforum的介紹網(wǎng)上已經(jīng)很多了，這里也簡單抄錄一段：JForum 是一個功能強大 ，易于管理的論壇。它的設(shè)計完全遵從MVC設(shè)計模式，能夠在任何Servlet容器與EJB服務(wù)器上運行。而且可以輕松的定制與擴展JForum論壇。

上面這段簡述還是中肯的。另外，jforum是模仿phpbb寫的，使用的是classic-blue風(fēng)格，但不能自己選擇風(fēng)格，要的話只能自己修改了。

再說幾句，說jforum比較優(yōu)秀是因為java開源的論壇系列精品少，而且jforum的bug也真的不少，不信試試就知道了。不過作為一個成型的組件，功能強大并且適合二次開發(fā)，還是應(yīng)該列入考慮范圍的。

不管怎樣，jforum是個不錯的學(xué)習(xí)范本，至少讓你覺得寫個山寨框架不是什么難事，而事實也的確是這樣的。重要的一點是，不要輕易拿出來害人就是了：)這里先列舉出可能一些分析點：

web.xml

初始化流程

處理請求流程(mvc)

文件監(jiān)控

緩存實現(xiàn)

數(shù)據(jù)庫訪問實現(xiàn)

權(quán)限控制

首先了解一個web應(yīng)用，首要的就是知道處理流程。首先來看看入口web.xml，里邊的內(nèi)容還是挺清晰的，可以看到里邊有個監(jiān)聽器ForumSessionlistener，*.page的過濾器ClickstreamFilter，還有2個*.page的處理器，其中InstallServlet是安裝相關(guān)的，JForum則是前端處理器。基本上整個流程就是client request -> ForumSessionlistener -> ClickstreamFilter -> JForum -> server response.

ForumSessionlistener實現(xiàn)了HttpSessionlistener接口，但是只是對session destory做了處理，在這個過程中，保存session的歷史記錄到DB，并清除用戶信息和相關(guān)的security信息。

ClickstreamFilter實現(xiàn)了Filter接口，主要的任務(wù)就交給BotChecker了，是用來檢測client是不是一個robot來的。

主要的工作還是在JForum上面，不過先來看看jforum是怎么檢測robot的？

BotChecker只有一個靜態(tài)工具方法isBot，首先是檢測是否請求robot.txt(這是標準的robot協(xié)議文件),接下去判斷User－Agent頭部，最后是判斷remotehost。而已知的robot都是寫在文件clickstream-jforum.xml里邊的(包括agent和host)，并通過ConfigLoader加載進來的(SAX方式)。

可以看到JForum和InstallServlet都繼承了JForumBaseServlet這個HttpServlet，而JForumBaseServlet包括2個重要的方法init和startApplication。眾所周知，init是servlet初始化時調(diào)用的方法，JForumBaseServlet里邊的init方法的流程是：

調(diào)用父類的init(正常情況這是必須調(diào)用的) -> 配置log4j -> startSystemglobals(加載全局參數(shù)配置SystemGlobals.properties -> 加載數(shù)據(jù)庫配置database.driver.config(如MySQL就是WEB-INF/config/database/mysql/mysql.properties) -> 加載自定義配置(默認的是jforum-custom.conf)) -> 配置緩存引擎 -> 配置freemarker模板引擎 -> 加載模塊配置modulesMapping.properties -> 加載url映射配置urlPattern.properties -> 加載I18n配置(languages/*) -> 加載頁面映射配置(templatesMapping.properties) -> 加載BBcode配置bb_config.xml -> 結(jié)束

jforum實現(xiàn)了自己的mvc，整個mvc的脈絡(luò)就是client request -> 解析url(urlPattern.properties),獲取module/action/param -> 通過module獲取相應(yīng)的module class，并通過action識別并調(diào)用相應(yīng)的方法(modulesMapping.properties) -> 使用dao完成業(yè)務(wù)邏輯 -> 調(diào)用template進行渲染(templatesMapping.properties)，其實整個mvc和struts沒什么兩樣的，具體的流程以后再提。

JForumBaseServlet里邊的startApplication方法的流程是：

加載通用sql文件sql.queries.driver(就是/database/generic/generic_queries.sql) -> 加載特定sql文件(如mysql就是/database/mysql/mysql.sql) -> 加載Quartz定時任務(wù)配置 -> 加載登錄驗證器(驗證方式) -> 加載Dao實現(xiàn)方式 -> 加載文件修改監(jiān)聽器 -> 加載查詢索引管理器 -> 加載定時統(tǒng)計任務(wù)

jforum實現(xiàn)了自己的orm，當(dāng)然不是hibernate那種，是類似ibatis的那種sql mapping，并提供了多套的sql文件來實現(xiàn)數(shù)據(jù)庫無關(guān)的特性，整個流程也是比較清晰的,加載數(shù)據(jù)庫配置 -> 加載sql mapping file -> 設(shè)置DAO實現(xiàn) -> 通過named sql找到對應(yīng)的sql(在*.sql里邊對應(yīng)著) -> 運行出數(shù)據(jù)

繼續(xù)重點。JForum的init流程如下：

JForumBaseServlet.init -> JForumBaseServlet.startApplication -> 啟動數(shù)據(jù)庫 -> 預(yù)加載一些數(shù)據(jù)到緩存中(ForumRepository[Categories,Forums,同時在線最大人數(shù)，最后登錄用戶，注冊用戶數(shù)等等],用戶等級,表情數(shù)據(jù)，屏蔽列表) -> 結(jié)束

上面簡單提到了Jforum處理請求的過程，現(xiàn)在在來看看這個過程，就是service方法，這次采用代碼概要的方式展示：

// 初始化JForumExecutionContext

JForumExecutionContext ex = JForumExecutionContext.get();

// 包裝request和response

request = new WebRequestContext(req);

response = new WebResponseContext(res);

// 檢查數(shù)據(jù)庫狀態(tài)

this.checkDatabaseStatus();

// 創(chuàng)建JForumContext并設(shè)置到JForumExecutionContext中去

.......

JForumExecutionContext.set(ex);

// 刷新session

utils.refreshSession();

// 加載用戶權(quán)限

SecurityRepository.load(SessionFacade.getUserSession().getUserId());

// 預(yù)加載模板需要的上下文

utils.prepareTemplateContext(context, forumContext);

// 從request中解析module name

String module = request.getModule();

// module name -> module class

String moduleClass = module != null ? ModulesRepository.getModuleClass(module) : null;

// 判斷是否在ban list里邊

......

boolean shouldBan = this.shouldBan(request.getremoteAddr());

// 主角出場

out = this.processCommand(out, request, response, encoding, context, moduleClass);

// 掃尾工作,例如db的rollback

this.handleFinally(out, forumContext, response);

processCommand會調(diào)用Command的process方法：

// 獲取一個module實例(繼承了Command)

Command c = this.retrieveCommand(moduleClass);

// 進入process

Template template = c.process(request, response, context);

// 這里開始是process方法

//獲取action

String action = this.request.getAction();

//如果不是ignore的，就調(diào)用這個action

if (!this.ignoreAction) {this.getClass().getMethod(action, NO_ARGS_CLASS).invoke(this, NO_ARGS_OBJECT);}

//如果是轉(zhuǎn)發(fā)的，就把TemplateName清空

if (JForumExecutionContext.getredirectTo() != null) {this.setTemplateName(TemplateKeys.EMPTY);}

//不是轉(zhuǎn)發(fā)且attribute里邊存在template，則設(shè)置為templateName

else if (request.getAttribute("template") != null) {this.setTemplateName((String)request.getAttribute("template"));}

//是否coustomContent？例如下載，驗證碼子類的不需要頁面的操作

if (JForumExecutionContext.isCustomContent()) {return null;}

//返回一個template

return JForumExecutionContext.templateConfig().getTemplate(

new StringBuffer(SystemGlobals.getValue(ConfigKeys.TEMPLATE_DIR)).

append('/').append(this.templateName).toString());

}

// 從process出來，回到processCommand

// 設(shè)置content type

response.setContentType(contentType);

//生成頁面并flush

if (!JForumExecutionContext.isCustomContent()) {

out = new BufferedWriter(new OutputStreamWriter(response.getOutputStream(), encoding));

template.process(JForumExecutionContext.getTemplateContext(), out);

out.flush();

}

}

這是一般的流程，就像上面提到的customContent，就是要自己處理了，可以參考CaptchaAction.generate().