the php.mvc tag action dispatcher
tagactiondispatcher是一个标准的actiondispatcher类的实现,它支持访问基本模板标签.tagactiondispatcher类支持相同的actionobjects集合和viewresourcesconfig属性作为默认的actiondispatcher.tagactiondispatcher类能被用在带有或没有带有模板标签系统上,尽管由于它的额外处理会造成小的性能下降.
模板标签库是php.mvc框架结构的子系统.模板标签库联合tagactiondispatcher一起工作来支持一些简单的模板标签.
下面的图表显示了php.mvc模板标签系统的总揽.左边展示的是模板标签系统的程序流程.右边是tagactiondispatcher的程序流程,还有标签模板是怎样使这些类进行交互.
1.初始化
当控制器传递控制到达tagactiondispatcher,一些初始化触发去设置actionobjects和viewresourcesconfig属性为了使用我们的模板:
从request中重新获得$form,$errors和$data对象,如果这些对象中的任意一个已经在之前被创建(比如在action类中),那么对象现在将在资源模板中不可见,否则对象将被设置为null.
重新获得viewresourcesconfig对象的参考,它包含了配置参数.
设置在viewresourcesconfig参数中指向模板源文件和编译的模板文件的路径.
2.设置标签页面
模板源文件的扩展名(可能是”.ssp”)被用来和viewresourcesconfig->tagflagstr参数相比较来决定是否这个页面需要处理,否则页面将被处理为标准(无标签)模板文件.我们能在view-resources元素中配置标签文件扩展名,就像这样:
<view-resources
…
tagflagstr = “.ssp”
tagflagcnt = “-4”
…
</view-resources>
tagflagstr指示了标签模板源文件能被预处理,比如:mypage.ssp.这个扩展名触发标签处理.属性tagflagcnt定义了文件名结尾的字符数,包括”.”(xxxyyy.ssp).据个例子,-4代表源文件名最后4个字符.默认值是.ssp和-4,因此如果我们使用一个模板文件名像mypage.ssp,我们不需要设置这些参数.
3.处理标签文件
模板标签系统决定是否运行标签处理器,要根据viewresourcesconfig->processtags属性.如果这个属性为真,模板页(及它所包含的页)将被标签处理器类所处理,否则标签处理器不会被调用.开发者只要将它在开发中将其设置为真即可,假则不处理.但要注意的是当processtags属性设置为真,修改过的标签页才会被编译(这依赖于compileall属性设置).我们能定义processtags属性在view-resources元素,就像这样:
<view-resources
…
processtags = “true”
…
</view-resources>
注意,它的默认值是假.
4.编译模板页.
如果tagactiondispatcher决定模板页将被处理,那么它会传递控制给模板标签系统.现在模板标签系统将决定是否只编译修改过的页,还是编译所有页.这种行为使用viewresourcesconfig->compileall属性来定义.我们定义compileall属性就像这样:
<view-resources
…
compileall = “true”
…
</view-resources>
这个属性默认为假.
5.只编译修改的页.
如果compileall属性设置为假(默认值),那么只会编译修改过的页.据个例子,如果被请求的页面自从上次被请求以来被修改过,此页将会被编译.
6.编译所有的页.
如果compileall属性设置为真,模板标签系统将总是编译页面(包括包含的页面)无论此页面自从上次请求以来是否修改过.开发者使用在开发中使用这个选项能够保证所有的页面都被处理.
7.处理view资源.
在处理完模板页之后,控制权回到tagactiondispatcher.被请求的view资源(模板文件)将被任何其他的正规php.mvc模板文件所处理.tagactiondispatcher重新获得被编译的页(包括包含的页面)并且将页面输出给用户的浏览器.如果模板标签系统没有被调用,tagactiondispatcher将被请求的页面作为正规的view资源来处理.比如tagactiondispatcher能被用来代替标准的actiondispatcher.