ZATS ConnectAsIncluded

{{Template:UnderConstruction}}
{{ZATSEssentialsPageHeader}}
 Since 1.1.0


ZK provides the <javadoc>org.zkoss.zul.Include</javadoc> component<ref>For more details, please refer to [[ZK_Developer%27s_Reference/UI_Composing/ZUML/Include]] and [[ZK_Component_Reference/Essential_Components/Include]]</ref> and <javadoc method="createComponents(String, Component, Map)">org.zkoss.zk.ui.Execution</javadoc> method<ref>For more details, please refer to [[ZK_Developer%27s_Reference/UI_Composing/ZUML/Load_ZUML_in_Java]]</ref> to include and reuse ZUL pages or others. In ZATS Mimic, we can test ZUL pages which are included by outer pages directly; just connect to such ZUL pages through the <code>Client.connect(String)</code> method as usual. 

= Test Included ZUL Pages with Arguments =
Sometimes, we pass some arguments to included ZUL pages for flexibility, and the arguments can be retrieved from the implicit objects [[ZUML_Reference/EL_Expressions/Implicit_Objects/arg|arg]] in such ZUL pages. ZATS Mimic introduces another connecting method <code>Client.connectAsIncluded(String, Map<String, Object>)</code> for above case. Following is a typical example of connecting to a included ZUL page with specific arguments:

'''included.zul'''
<source lang="xml" highlight="2">
<zk>
	<label id="msg" value="${arg.message }" />
</zk>
</source>
* '''Line 2''': The value is retrieved from arguments.


'''Test.java'''
<source lang="java" start="10" highlight="12, 13, 15">
@Test
public void test() {
	Map<String, Object> args = new HashMap<String, Object>();
	args.put("message", "Hello world!");
	Client client = Zats.newClient();
	DesktopAgent desktop = client.connectAsIncluded("/included.zul", args);
	Label msg = desktop.query("#msg").as(Label.class);
	Assert.assertEquals("Hello world!", msg.getValue());
}
</source>
* '''Line 12-13''': Prepare arguments for included ZUL page.
* '''Line 15''': Connect to included ZUL page with arguments.


'''Notes'''
<references/>


{{ZATSEssentialsPageHeader}}
{{ZATSEssentialsPageFooter}}