jeecms加载首页的过程

刚开始研究jeecms的时候很纳闷，找不到首页的加载页面。。经过一番仔细研究，发现这个加载还是经过了很多曲折的过程的。整个程序的架构师ssh+freemarker模板构成的，所以先要熟悉freemarker模板技术。

先看web.xml文件，其中欢迎页面有：

<welcome-file-list>
    <welcome-file>index.jspa</welcome-file>
    <welcome-file>index.do</welcome-file>
    <welcome-file>index.html</welcome-file>
</welcome-file-list>

<welcome-file-list>
	<welcome-file>index.jspa</welcome-file>
	<welcome-file>index.do</welcome-file>
	<welcome-file>index.html</welcome-file>
</welcome-file-list>

 

接着再看jeecms/core/struts-front.xml配置文件，发现有个action的通用配置：

<action name="**" class="core.dynamicSystemAct">
            <result type="chain">
                <param name="namespace">${namespace}</param>
                <param name="actionName">${actionName}</param>
            </result>
            <interceptor-ref name="exception"/>
            <interceptor-ref name="domain"/>
            <interceptor-ref name="cookieIdentity"/>
            <interceptor-ref name="url"/>
        </action>

<action name="**" class="core.dynamicSystemAct">
			<result type="chain">
				<param name="namespace">${namespace}</param>
				<param name="actionName">${actionName}</param>
			</result>
			<interceptor-ref name="exception"/>
			<interceptor-ref name="domain"/>
			<interceptor-ref name="cookieIdentity"/>
			<interceptor-ref name="url"/>
		</action>		

 

struts收到请求以后，将请求转发到core.dynamicSystemAct这个对象，注意这个这个class并不是真正的类，是类的别名，由spring通过标注@Controller进行绑定，web应用上下文可以通过classpath自动扫描到这个类。

@Controller("core.dynamicSystemAct")
public class DynamicSystemAct

@Controller("core.dynamicSystemAct")
public class DynamicSystemAct 

 

在这个action执行之前，先要执行好几个拦截器。其他struts和webwork自带的拦截器不必说，主要说一下在程序里面自定义的几个比较重要的拦截器（定义在jeecms/src/struts-default.xml文件中）。

DomainNameInterceptor

UrlInterceptor

CookieIdentityInterceptor

然后执行action自己的execute方法，产生2个参数：

namespace = "/jeedynamic/" + sys;

actionName = "Page";

这2个参数决定了程序的走向，组成转发路径：/jeedynamic/jeecms/Page.do，然后通过查找下面的配置信息

<package name="cms.front.page" namespace="/jeedynamic/jeecms" extends="empty-default">
    <action name="Page" class="cms.cmsPageAct">
        <result>${tplPath}</result>
        <result name="pageCache" type="pageCache">${tplPath}</result>
        <interceptor-ref name="exception"/>
        <interceptor-ref name="chain"/>
    </action>
</package>

	<package name="cms.front.page" namespace="/jeedynamic/jeecms" extends="empty-default">		
		<action name="Page" class="cms.cmsPageAct">
			<result>${tplPath}</result>
			<result name="pageCache" type="pageCache">${tplPath}</result>
			<interceptor-ref name="exception"/>
			<interceptor-ref name="chain"/>
		</action>
	</package>

 

 

注：其他的请求过程类似，先找到命名空间，然后找到对应的acting进行处理。

将请求转发给cms.cmsPageAct对象，同上的道理，对应到控制器：com.jeecms.cms.action.front.CmsPageAct。拦截器处理完毕后，执行自己的execute方法，判断若是首页，则执行sysIndex（）方法，返回一个模板路径tplPath：/WEB-INF/user_base/jeecms_com_www/template/article/default/index.html，找到这个文件，是文章对应的首页模板，里面有自定义的freemarker标签@cms，定义在配置文件freemarker.properties中:

auto_import="/WEB-INF/ftl_lib/ponyjava.com/index.ftl" as p, "/WEB-INF/ftl_lib/jeecms/index.ftl" as cms 

@cms标签所用的ftl模板文件为index.ftl。 打开index.ftl文件，includes了多个ftl，其中有action_cms.ftl，该文件用标签#macro，自定义许多directive：ChnlList和CommentList等。里面使用struts2标签@s.action来请求数据，整个的index.html页面就是这么加载出来的。通过freemarker引擎来解析数据模型，最后显示到前台，展现给客户。

评论

1 楼 zhaihq 2010-06-13