ZK Developer's Reference/Clustering/Programming Tips

Objects Referenced by UI Must Serializable

Objects that are referenced by an UI object, such as component and page, have to be serializable. Otherwise, they might have no value after de-serialized, or causes an exception (depending how it is used).

Attributes of UI Objects

If the value of an attribute is not serializable, it will be ignored. Thus, it will become null after de-serialized. Thus, it is better to make them all serializable (such as implementing java.io.Serializable), or handle the serialization manually (refer to the Clustering Listeners section below) .

zscript

It is OK, though not recommended, to use zscript in a clustering environment, but there are some limitations.

• BeanShell's function is not serializable. For example, the following won't work:

void foo() {
}

• The values of variables must be serializable

Notice that it is not recommended to use zscript in the clustering environment. After all, the performance of BeanShell is not good.

Event Listeners

Event listeners have to be serializable. Otherwise, it will be ignored after serialization.

Data Models

The data model, such as ListModel and ChartModel, have to be serializable. Otherwise, the UI object (such as grid) won't behave correctly. The implementations provided by ZK are serializable. However, the items to be stored in the data models have to be serializable too.

Composers

If you extend from GenericForwardComposer or GenericAutowireComposer, you have to make sure all of its members are serializable (or transient), since the implementation will keep a reference in the applied component.

If you implement from Composer directly, the composer could be non-serializable if you don't keep a reference in any UI object. In other words, the composer will be dropped after Composer.doAfterCompose(Component)

Clustering Listeners

If there are non-serializable objects, you could implement one of clustering listeners to handle them manually as described below. Basically, there are two kinds of clustering listeners for different purpose:

• Serialization Listeners: they are called when an object is about to be serialized, and after it has been de-serialized. Example: ComponentSerializationListener and PageSerializationListener
• Activation Listeners: they are called when a session is about to be passivated, and after it has been activated. Examples: ComponentActivationListener and PageActivationListener.

To register a listener is straightforward: implements the corresponding listener interface. For example, you could implement ComponentActivationListener if an object is stored in a component and wants to called on activation and passivation.

Passivation Flow

When a session is about to be passivated (such as moving to anther machine), the activation listeners will be called first to notify the passivation, and then the serialization listeners will be called before the object is serialized.

Sequence	Description
1	Invokes SessionActivationListener.willPassivate(Session) for each object referenced by the Session that will be passivated
2	Invokes DesktopActivationListener.willPassivate(Desktop) for each object referenced by each Desktop that will be passivated
3	Invokes PageActivationListener.willPassivate(Page) for each object referenced by each Page that will be passivated
4	Invokes ComponentActivationListener.willPassivate(Component) for each object referenced by each Component that will be passivated
5	Invokes SessionSerializationListener.willSerialize(Session) for each object referenced by the Session that will be passivated
6	Serializes the session
7	Invokes DesktopSerializationListener.willSerialize(Desktop) for each object referenced by each Desktop that will be passivated
8	Serializes desktops of the session
9	Invokes PageSerializationListener.willSerialize(Page) for each object referenced by each Page that will be passivated
10	Serializes pages of each desktop
11	Invokes ComponentSerializationListener.willSerialize(Component) for each object referenced by each Component that will be passivated
12	Serializes components of each page

Activation Flow

When a session is about to be activated (such as moved from another machine), the serialization listener is called after the object has been deserialized. After all objects are deserialized, the activation listener will be called to notify a session has been activated.

Sequence	Description
1	Deserializes the session, and desktops, pages and components of the session.
2	Invokes SessionSerializationListener.didDeserialize(Session) for each object referenced by the Session that will be passivated
3	Invokes DesktopSerializationListener.didDeserialize(Desktop) for each object referenced by each Desktop that will be passivated
4	Invokes PageSerializationListener.didDeserialize(Page) for each object referenced by each Page that will be passivated
5	Invokes ComponentSerializationListener.didDeserialize(Component) for each object referenced by each Component that will be passivated
6	Invokes SessionActivationListener.didActivate(Session) for each object referenced by the Session that will be passivated

Version History

Version	Date	Content