First Mimic Test Case

{{ZATSEssentialsPageHeader}}

= Simple Application Under Test =

We are going to introduce some basic concepts of ZATS Mimic with a simple application. This application only has one label with no content at first and one button. It only has one function: when a user clicks the button, the label shows "Hello Mimic" as the image below.

[[File:Smalltalk-mimic-hello.png]]


'''ZUL of our simple application'''

<source lang="xml">

<zk>
	<window title="hello" border="normal" width="300px" apply="org.zkoss.zats.example.hello.HelloComposer">
		<label />
		<button label="Hello" />
	</window>
</zk>

</source>

'''Composer of our simple application'''

<source lang="java">

public class HelloComposer extends SelectorComposer {
	
	@Wire("label")
	Label label;
	
	@Listen("onClick = button")
	public void hello(){
		label.setValue("Hello Mimic");
	}
}

</source>

= Write a Test Case =
Steps to write a test case are as follows:
# Setup web application content path
# Create a client to connect to a ZUL
# Query a component
# Perform an operation on a component
# Verify result by checking a component’s property
# Tear down, stop server emulator

= Fundamental Classes =

Before diving into the source code of a test case, let me introduce some basic classes used in a test case.

; <tt> Zats</tt>
:    It contains several utility methods to initialize and clean testing environment. By default, it starts server emulator '''with predefined web.xml and zk.xml ''' bundled in ZATS Mimic's jar.
; <tt> Client</tt>
:    Acts like a client to the server emulator and we use it to connect to a ZUL.
; <tt> DesktopAgent </tt>
:    Wraps ZK Desktop object, we usually call its <tt> query() </tt> or <tt> queryAll() </tt> to retrieve ZK components with selector syntax supported in <javadoc> org.zkoss.zk.ui.select.SelectorComposer </javadoc>
:    For available selector syntax, please refer to javadoc or [[Small Talks/2011/January/Envisage ZK 6: An Annotation Based Composer For MVC]]
; <tt> ComponentAgent </tt>
:    Mimics a ZK component and determines which operation you can perform on it. We can also get ZK component property's value from it.
: It also has <tt> query() </tt> which means to find targets among its child components.
; <tt> OperationAgent (ClickAgent, TypeAgent, SelectAgent...)</tt>
:    To mimic a user operation to a ZK component.
:    We name it "Agent" as it's not really the user operation itself, it's an agent to mimic user operation to a component.


{{ZATSEssentialsPageFooter}}