@NotifyChange

From Documentation
Revision as of 07:36, 8 July 2022 by Hawk (talk | contribs) ((via JWB))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Stop.png This article is out of date, please refer to zk-mvvm-book/8.0/syntax/viewmodel/notifychange for more up to date information.


Syntax

@NotifyChange("anotherProperty") 

@NotifyChange({"secondProperty","thirdProperty"}) 

@NotifyChange("*")

@NotifyChange(".")

Description

Target: method (setter or command method)

Purpose: To notify binder one or more properties change.

By default, a property set by binder through setter method will notify this property changed without this annotation. You could use this annotation on setter method to override default notification target. You could also add this annotation on a command method to notify properties that are changed after command execution. To avoid the default notification, use @NotifyChangeDisabled on setter method solely. Giving "*" in annotation element means notify all properties in a ViewModel.

Use "." to enforce reloading the instance of the class in where the annotation locates, not an instance's property.

Example

public class OrderVM {

	//other code...

	@NotifyChange({"selected","messages"})
	public void setSelected(Order selected) {
		this.selected = selected;
	}

	//action command
	@NotifyChange({"selected","orders","messages"})
	@Command
	public void newOrder(){
		Order order = new Order();
		getOrders().add(order); //add new order to order list
		selected = order;//select the new one
	}
}



Version History

Version Date Content
6.0.0 February 2012 The MVVM was introduced.




Last Update : 2022/07/08

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