ZATS ConnectAsIncluded"

From Documentation
m (correct highlight (via JWB))
 
(16 intermediate revisions by one other user not shown)
Line 1: Line 1:
 +
{{Template:UnderConstruction}}
 
{{ZATSEssentialsPageHeader}}
 
{{ZATSEssentialsPageHeader}}
__TOC__
 
 
  Since 1.1.0
 
  Since 1.1.0
  
= Connect as Included =
+
 
 +
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}}
 
{{ZATSEssentialsPageHeader}}
 
{{ZATSEssentialsPageFooter}}
 
{{ZATSEssentialsPageFooter}}

Latest revision as of 02:58, 20 January 2022

WarningTriangle-32x32.png This page is under construction, so we cannot guarantee the accuracy of the content!

aowang



Since 1.1.0


ZK provides the Include component[1] and Execution.createComponents(String, Component, Map) method[2] 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 Client.connect(String) 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 arg in such ZUL pages. ZATS Mimic introduces another connecting method Client.connectAsIncluded(String, Map<String, Object>) for above case. Following is a typical example of connecting to a included ZUL page with specific arguments:

included.zul

<zk>
	<label id="msg" value="${arg.message }" />
</zk>
  • Line 2: The value is retrieved from arguments.


Test.java

@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());
}
  • Line 12-13: Prepare arguments for included ZUL page.
  • Line 15: Connect to included ZUL page with arguments.


Notes


aowang




Last Update : 2022/01/20

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.