Integrate ZK Spreadsheet with Spring

From Documentation
Revision as of 03:10, 23 November 2010 by Henrichen (talk | contribs) (→‎Purpose)

Integrate ZK Spreadsheet with Spring

ZK Spreadsheet can resolve the name expressions in cells to bind the data from the Spring-managed beans automatically.


Data binding spreadsheet cells to Spring-managed beans.

Template Excel File with Proper Name Expressions

Construct an Excel template file with proper name expressions in cells.


You will see #NAME? in cells because Excel does not know such names. However, they will be interpreted when import into ZK Spreadsheet component.

Integrate ZK Spreadsheet with Spring

As we have mentioned in How ZK Spreadsheet Resolve my Java Beans, ZK Spreadsheet follows ZK's EL expression variable resolving mechanism. When trying to resolve a variable, it will finally ask variable resolvers declared in the ZUML page to retrieve the bean of the named variable. So simply declare the variable-resolver with org.zkoss.zkplus.spring.DelegatingVariableResolver on top of your ZUML page, you are now data-binding your ZK Spreadsheet with your Spring-managed beans directly. Following we demonstrate the example that use the same bsheet.xls template file as in Template Excel File with Proper Name Expressions but data-binding to Spring-managed bean.


In ZUML page, we declare the variable resolver for retrieving Spring-Managed beans so ZK Spreadsheet can find them and show the evaluated value in the spreadsheet's cells.

<?variable-resolver class="org.zkoss.zkplus.spring.DelegatingVariableResolver"?>
<spreadsheet id="bsheet"

Spring Configuration File

Define bean definitions in applicationContext.xml file, and put it into your WEB-INF directory.

<?xml version="1.0" encoding="UTF-8"?>
  <bean id="dataBean" class="org.zkoss.zssessentials.bean.spring.DataBeanImpl"/>

Spring-managed Bean

Define DataBean interface and its implementation. Mainly getters and setters for various attributes for a balance sheet.

package org.zkoss.zssessentials.bean.spring;
public interface DataBean {
	public double getLiquidAssets();

	public void setLiquidAssets(double liquidAssets);

	//...other getters and setters

package org.zkoss.zssessentials.bean.spring;
public class DataBeanImpl implements DataBean {
	private double liquidAssets;
	private double fundInvestment;
	private double fixedAssets;
	private double intangibleAsset; 
	private double otherAssets;
	private double currentLiabilities;
	private double longTermLiabilities;
	private double otherLiabilities;
	private double capitalStock;
	private double capitalSurplus;
	private double retainedEarnings;
	private double otherEquity;
	private double treasuryStock;
	public double getLiquidAssets() {
		return liquidAssets;

	public void setLiquidAssets(double liquidAssets) {
		this.liquidAssets = liquidAssets;

	//...other getters and setters implementation

Version History

Last Update : 2010/11/23

Version Date Content

All source code listed in this book is at Github.

Last Update : 2010/11/23

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