`
sun4love
  • 浏览: 234577 次
  • 性别: Icon_minigender_1
  • 来自: 上海
社区版块
存档分类
最新评论

了解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页面

 

//AfterCompose//
	public void afterCompose() {
		_afterComposed = true;
		fixModeOnly();
		if (_instantMode) {
			final Execution exec = getExecution();
			final Map old = setupDynams(exec);
			final String attrRenderedKey = ATTR_RENDERED+'$'+getUuid(); 
			final String oldSrc  = (String) exec.getAttribute(attrRenderedKey);
			if (!Objects.equals(oldSrc, _src)) {
				try {
					getChildren().clear();
					final int j = _src.indexOf('?');
					exec.createComponents(j >= 0 ? _src.substring(0, j) : _src,
							this, _dynams);
					// TODO: convert query string to arg
					exec.setAttribute(attrRenderedKey, _src);
				} finally {
					restoreDynams(exec, old);
				}
			}
		} else {
			// just in case
			getChildren().clear();
		}
	}

 

在上面的方法中我们看到内部其实是使用的createComponents方法创建的,

createComponents方法创建【父组件的子组件】即include组件的子组件,当然也是include组件父组件的子组件,

注意:不会创建src页面对应的Page对象,desktop.getPage("src指定页面page指令id的名称")获取的是null。

举例理解instant:

<div>

   <include mode="instant" src="b.zul"/>

</div>

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

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

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

 

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

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

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

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

 

 

defer:

 

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

 

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

 

 

protected void renderProperties(org.zkoss.zk.ui.sys.ContentRenderer renderer)
	throws java.io.IOException {
		super.renderProperties(renderer);

		setChildPage(null);
		render(renderer, "comment", _comment);

		if (_instantMode &&_afterComposed)
			return; //instant mode (done by redrawChildren())

		final UiEngine ueng =
			((WebAppCtrl)getDesktop().getWebApp()).getUiEngine();
		Component old = ueng.setOwner(this);
		try {
			if (_progressStatus == 1) {
				_progressStatus = 2;
			} else if (_src != null && _src.length() > 0) {
				final StringWriter sw = new StringWriter();
				include(sw);

				//Don't output sw directly if getChildPage() is not null
				//Otherwise, script of the included zul page will be evaluated
				//first (since it is part of rc.temp)

				boolean done = false;
				if (getChildPage() == null) { //only able to handle non-ZUL page
					final HtmlPageRenders.RenderContext rc =
						HtmlPageRenders.getRenderContext(null);
					if (rc != null && !rc.included) { //Use z$ea only if not included
						final Writer cwout = rc.temp;
						cwout.write("<div id=\"");
						cwout.write(getUuid());
						cwout.write("\" style=\"display:none\">");
						if (_comment)
							cwout.write("\n<!--\n");
						Files.write(cwout, sw.getBuffer());
						if (_comment)
							cwout.write("\n-->\n");
						cwout.write("</div>");

						renderer.render("z$ea", "content");
						done = true;
					}
				}
				if (!done) {
					renderer.render("content", sw.toString());
					if (_renderResult != null && _renderResult.length() > 0)
						renderer.renderDirectly("_childjs", "function(){" + _renderResult + '}');
				}
			}
		} finally {
			_renderResult = null;
			ueng.setOwner(old);
		}
	}

 

在该方法中,关键代码

final StringWriter sw = new StringWriter();

include(sw);

include内部调用了Servlet相关方法RequestDispatcher.include,与<jsp:include/>行为一样,这里就不介绍内部代码了,

如果你了解Servlet相关api,那么应该清楚RequestDispatcher.include的行为,该方法会发送一个http请求,

请求src指定的页面,web容器拦截这个请求,处理请求,响应结果

 

举例理解defer:

<window>

   <include mode="defer" src="b.zul"/>

</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,但生命周期太长

 

 

分享到:
评论

相关推荐

    vue中keep-alive,include的缓存问题

    首先,让我们来了解一下`keep-alive`组件的基本用法。在Vue中,你可以将`keep-alive`包裹在`router-view`组件周围,以此来缓存路由切换时的组件实例。 ```html ``` 如果你希望只缓存特定的组件,你可以使用`...

    组件技术com组件

    通过上述步骤,我们不仅可以了解到如何使用ATL和MFC创建COM组件,还能够深入理解COM组件的设计原理和技术细节。无论是对于想要深入研究Windows编程的开发者,还是对于那些希望利用现有组件技术加速应用开发的团队来...

    esp32 components 添加自定组件

    这里,`src/my_custom_component.c`是你组件的主要源文件,`include`目录通常包含头文件。 3. 更新主CMakeLists:在项目根目录的`CMakeLists.txt`中,告诉CMake关于新组件的存在。添加以下行: ```cmake add_...

    几个主流PHP软件的include结构

    4. **Symfony**:Symfony是一个组件化的PHP框架,它的`include`结构强调组件的解耦和复用。`vendor`目录包含所有第三方库,`src`目录是自定义代码的存放地。`config`目录下的文件用于配置应用程序,`Kernel.php`是...

    无组件上传带进度条asp版

    【描述】"无组件上传带进度条"表明我们要实现的是一个基于ASP的文件上传系统,该系统不仅能够处理文件上传,还能在上传过程中显示进度条,让用户了解文件上传的状态。在ASP中实现进度条显示通常需要JavaScript或者...

    Include_Form_DLL

    标题“Include_Form_DLL”指的是一个专门探讨如何在DLL(动态链接库)中包含窗体(Form)的编程实践。在Windows应用程序开发中,DLL是一种重要的技术,它允许多个应用程序共享同一段代码或数据,从而节省内存和提高...

    ros环境下qt导入rviz组件

    本教程将深入探讨如何在QT应用中集成和使用RVIZ组件,帮助开发者构建功能丰富的机器人控制系统。 首先,我们要了解的是ROS与QT的结合。ROS提供了qtbindings库,使得我们可以使用QT创建ROS节点,并且能够方便地处理...

    COM组件基础知识

    同时,了解如何使用`#import`和`#include`指令来处理类型库也是COM编程的重要环节,它们有助于在编译时处理接口信息,提高效率和代码的可读性。 总的来说,COM组件基础知识是C++开发者进行跨平台、跨语言集成开发的...

    Android中Include的使用

    通过以上介绍,我们了解了`&lt;include&gt;`标签在Android开发中的重要性,学会了如何使用它来提高代码的复用性和可维护性。在实际开发中,结合`&lt;merge&gt;`标签和数据绑定,我们可以构建更加高效、灵活的布局结构。

    opencv3.1_VC2013_64bit 库dll include安装文件

    在本压缩包“opencv3.1_VC2013_64bit 库dll include安装文件”中,提供了针对Visual Studio 2013(VC2013)编译器的64位版本的OpenCV 3.1的安装组件,主要包括库文件、DLL动态链接库和头文件等关键部分。 首先,...

    Ext2.0.2经典的一个JS组件带EXT中文手册.rar

    - `CHANGES.txt`:记录了ExtJS从上一版本到2.0.2版本之间的改动和更新,这对于了解新特性、修复的bug以及可能的兼容性问题非常有用。 - `LICENSE.txt`:包含了ExtJS的许可协议,定义了你可以如何使用和分发这个库...

    6配置VxWorks组件的实验[定义].pdf

    本实验的主要目标是掌握VxWorks中配置组件的方法,通过实验步骤,学生可以了解如何在VxWorks内核中添加ping客户端组件,并观察其执行结果。 一、实验原理 在VxWorks中,内核可以根据不同的硬件和软件功能进行配置...

    ios的屏幕小组件学习文档

    - 不勾选 `Include Live Activity` 和 `Include Configuration App Intent`,因为这些选项与本次教程无关。 - 完成后点击 `Finish`。 2. **查看生成的文件结构**: - 成功创建小组件后,Xcode会在项目中新增一个...

    Zend Framework入门教程之Zend_Config组件用法详解

    在本教程中,我们将深入了解Zend Framework框架中的Zend_Config组件,这是一款专门用于处理应用配置信息的工具。通过实例讲解,我们将会掌握Zend_Config组件的基本用法,并学习如何操作不同类型配置文件的方法。 ...

    php adodb组件及说明手册(中文)

    `php教程-php广州站.url`可能是指向一个PHP学习资源的链接,可以帮助进一步了解PHP开发。而`adodb`可能包含ADODB库的源代码或配置文件,供开发者研究和定制。 总的来说,ADODB组件是PHP开发中不可或缺的工具,它...

    【UML】用例图+活动图+include与extend的区别

    通过阅读提供的文档和课件,你将能够深入了解这些概念,并学会如何有效地使用它们来分析和建模软件需求。学习UML的这些工具和关系,可以帮助你更清晰地沟通系统的需求,减少误解,并提高软件开发的效率和质量。

    android 基本组件 画廊 按钮 布局

    最后,了解如何在代码中动态地添加和管理这些组件也是很重要的。例如,你可以使用LayoutInflater类来从XML布局文件中加载组件,然后使用addView方法将其添加到父布局中。同时,通过findViewById方法可以获取已定义的...

    jsp中include指令静态导入和动态导入的区别详解

    在JavaServer Pages(JSP)技术中,页面之间的内容包含是常见需求,这可以通过include指令实现。JSP中的include指令有两种方式:静态导入和动态导入。了解它们之间的区别,对于开发高效且易于维护的Web应用至关重要...

    ESP32添加自己的component_esp32

    首先,了解ESP-IDF的基本结构至关重要。ESP-IDF采用模块化设计,其中component是项目的核心部分,每个component代表一个独立的功能模块或库。添加新的component可以使项目结构更清晰,代码更易于维护。 1. **创建新...

    Qt组件编程小结

    在深入探讨Qt组件编程的知识点之前,我们首先要了解Qt本身是一个跨平台的C++图形用户界面应用程序框架。它适用于桌面、嵌入式和移动应用程序开发。Qt提供了一套丰富的API,以及一个名为Qt Creator的集成开发环境...

Global site tag (gtag.js) - Google Analytics