读书人

懂得include组件

发布时间: 2012-09-19 13:43:54 作者: rapoo

了解include组件

了解include组件

?

预备知识:

?

?加载页面的活动周期:初始阶段,组件创建阶段,事件处理阶段,响应阶段或显示阶段或渲染显示阶段

?

include的组件是zk的一个包含组件,其他类似动态技术(jsp,freemarker等)都有相关功能

?

include 的src属性指定的页面可以是zhtml,zul或者其他的servlet生成的页面(jsp,html,jsf 等等等)

?

include另外一个重要属性是mode,即include加载模式,三个值auto(默认)、instant,defer,

?????????? 当然你可以覆盖mode的值

?

1,include组件指定mode的值,

2,修改org.zkoss.zul.include.mode的值

?? Library.setProperty("org.zkoss.zul.include.mode","instant")

?? 或者修改zk.xml配置文件里的

<library-property>

?? ? <name>org.zkoss.zul.include.mode</name> <value>auto</value>

</library-property>

?

下面讲解这三种模式instant,defer,auto

?

instant:

?

即时,立即,组件创建阶段,在include组件创建完毕后,会自动调用include对应类

org.zkoss.zul.Include ( 标准组件在org.zkoss.zul.*下都有对应的类) 的afterCompose方法,立即加载src页面

?

    </div>

    这里其实等于将b.zul的内容拷贝到<div>里

    instant模式就像jsp中的<%include%>静态指令的行为,将<%include%>指定的页面

    直接插入当前页面,而不是<jsp:include/>动态的行为,

    ?

    另外,现在有一个问题,如果src的值是b.html呢?

    解决这个问题之前,要先了解createComponents,

    该方法要求uri或者content的内容必须符合ZUML语法

    因此上面的问题的答案是否定的,html不符合zuml语法

    ?

    ?

    defer:

    ?

    懒加载,懒到什么程度呢?在组件显示阶段或响应阶段才会加载src指定的页面

    ?

    显示阶段会自动调用renderProperties方法

    ?

    ?

      </window>

      ?

      RequestDispatcher.include会发送一个http请求,请求src指定的目标页获取解析结果,即普通的html页面

      并将html页面写入response的out流中

      因为defer模式中,对src的获取是基于http请求的,所以src可以是任何servlet,不仅仅是zhtml,zul

      ?

      ?

      auto模式:自动选择模式

      ?

      private void fixModeOnly() { //called by afterCompose

      if ("auto".equals(_mode)) {

      if (_src != null && !_progressing && !_localized) {

      _instantMode = _src.endsWith(".zul") || _src.endsWith(".zhtml");

      } else

      _instantMode = false;

      } else

      _instantMode = "instant".equals(_mode);

      }

      从上面的代码中,auto模式时,如果src的后缀是zul,zhtml结尾则使用instant模式,反之使用defer模式

      ?

      ?

      ?

      ?

      传递参数:

      ?

      ?

      ?

      a.zul include b.zul

      ?

      ??1,在请求a.zul页面的时候,给b.zul传递参数

      ?? 1)Executions.getCurrent().setAttribute()

      ? ?2)a.zul url地址后追加参数,a.zul?name=333或者b.zul?name=323

      ?? ? 或者

      ?? 3)include组件定义动态参数 <include name="333/>

      ?

      2,已经响应完毕的时候,现在修改include的src,?重新加载src指定的页面

      ??1)Executions.getCurrent().setAttribute()

      ??2)Executions.getCurrent().pushArg(arg)

      ??3)iclude.setDynamicProperty(name, value)

      ??4)b.zul?name=323

      ??5)当然可以设置组件作用域对象,include.setAttribute,但生命周期太长

      ?

读书人网 >Web前端

热点推荐