ZK Binding Tracker - A Chrome Extension"

From Documentation
Line 23: Line 23:
 
= Install & Configuration =
 
= Install & Configuration =
  
The steps to use this tool are quite simple:
 
  
 
1. [Download ZK Binding Tracker] and extract the downloaded file (zkbind-debugger-bin-0.8.0.zip)
 
1. [Download ZK Binding Tracker] and extract the downloaded file (zkbind-debugger-bin-0.8.0.zip)
 +
 
2. Copy debugger jar (<tt>/dist/lib/zkbind-debugger.jar</tt> in the zip file) to your <tt>WEB-INF/lib</tt> folder
 
2. Copy debugger jar (<tt>/dist/lib/zkbind-debugger.jar</tt> in the zip file) to your <tt>WEB-INF/lib</tt> folder
 +
 
3. add following configurations to your web application's <tt>zk.xml</tt>
 
3. add following configurations to your web application's <tt>zk.xml</tt>
 
<source lang='xml'>
 
<source lang='xml'>
    <library-property>
+
<library-property>
      <name>org.zkoss.bind.DebuggerFactory.enable</name>
+
<name>org.zkoss.bind.DebuggerFactory.enable</name>
      <value>true</value>
+
<value>true</value>
    </library-property>
+
</library-property>
    <library-property>
+
<library-property>
      <name>org.zkoss.bind.DebuggerFactory.class</name>
+
<name>org.zkoss.bind.DebuggerFactory.class</name>
      <value>org.zkoss.bind.addon.sys.debugger.ChromeExtensionDebuggerFactory</value>
+
<value>org.zkoss.bind.addon.sys.debugger.ChromeExtensionDebuggerFactory</value>
    </library-property>    
+
</library-property>
 
</source>
 
</source>
 
4. Install Chrome extension. In Chrome's menu [[File:Chrome_menu_icon.png]], select '''Tools''' > '''Extensions'''. Drag the extension file (<tt>/zkbind-tracker/chrome-extension.crx</tt> in the zip) to Chrome extension tab to install.  
 
4. Install Chrome extension. In Chrome's menu [[File:Chrome_menu_icon.png]], select '''Tools''' > '''Extensions'''. Drag the extension file (<tt>/zkbind-tracker/chrome-extension.crx</tt> in the zip) to Chrome extension tab to install.  
5. After installation  
+
 
 +
5. After installation, you can see the tracker's icon aside to Chrome's menu. [[File:Extension_icon.png]]
  
 
Usage:
 
Usage:
 
# start your application.
 
# start your application.
 
# use Chrome to visit a page with ZK MVVM binding.
 
# use Chrome to visit a page with ZK MVVM binding.
# Click the Bining Tracker Icon to open the extension.
+
# Click the ZK Binding Tracker Icon to open the extension and it will open a new Chrome window.
  
  

Revision as of 09:33, 10 June 2013

DocumentationSmall Talks2013JuneZK Binding Tracker - A Chrome Extension
ZK Binding Tracker - A Chrome Extension

Author
Hawk Chen, Engineer, Potix Corporation
Date
Released: , 2013
Version
ZK Binding Tracker 0.8.0



Introduction

When you interact with a ZUL page built in MVVM approach, ZK does lots of things behind the scenes according to binding expressions. If you want to know what it does in detail, you can turn on debugging information printing described in ZK_Developer's_Reference/MVVM/Configuration. But this configuration will print messages on the server's console, and it is system-wide, which means debugging information of all pages will be printed and it will be hard to read.

Therefore, we present you a tool: ZK BindingTracker. It's a Chrome extension that can be installed on your Chrome browser. It can display the debugging information for the current ZUL page in rich format.


Binding tracker introduction.png


Features

Install & Configuration

1. [Download ZK Binding Tracker] and extract the downloaded file (zkbind-debugger-bin-0.8.0.zip)

2. Copy debugger jar (/dist/lib/zkbind-debugger.jar in the zip file) to your WEB-INF/lib folder

3. add following configurations to your web application's zk.xml

<library-property>
	<name>org.zkoss.bind.DebuggerFactory.enable</name>
	<value>true</value>
</library-property>
<library-property>
	<name>org.zkoss.bind.DebuggerFactory.class</name>
	<value>org.zkoss.bind.addon.sys.debugger.ChromeExtensionDebuggerFactory</value>
</library-property>

4. Install Chrome extension. In Chrome's menu Chrome menu icon.png, select Tools > Extensions. Drag the extension file (/zkbind-tracker/chrome-extension.crx in the zip) to Chrome extension tab to install.

5. After installation, you can see the tracker's icon aside to Chrome's menu. Extension icon.png

Usage:

  1. start your application.
  2. use Chrome to visit a page with ZK MVVM binding.
  3. Click the ZK Binding Tracker Icon to open the extension and it will open a new Chrome window.

Comments



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