org.apache.tapestry5.ajax

Class MultiZoneUpdate

java.lang.Object

org.apache.tapestry5.ajax.MultiZoneUpdate

Deprecated.

Deprecated in 5.3; use the AjaxResponseRenderer service instead of returning an instance of MultiZoneUpdate

public class MultiZoneUpdate
extends Object

A mapping from client-side zone ids to objects that can render the content for that zone on the client. An event handler method may instantiate an instance and chain together a series of calls to add(String, Object) , and return the final result. Remember that client-side element ids may not match server-side component ids, especially once Ajax is added to the mix. Because of this, it is highly recommended that the client-side logic gather the actual component ids and include those in the Ajax request, to ensure that the server generates updates that the client can process. Better yet, use the Zone's id parameter to lock down the zone's id to a known, predictable value.

Since:

5.1.0.1

Constructor Summary

Constructors

Constructor and Description
MultiZoneUpdate(ClientBodyElement zone) Deprecated. Alternate constructor that takes a ClientBodyElement (typically, a Zone).
MultiZoneUpdate(String zoneId, Object renderer) Deprecated.

Method Summary

Modifier and Type	Method and Description
MultiZoneUpdate	add(ClientBodyElement zone) Deprecated. Adds the zone (represented by the ClientBodyElement) to the update.
MultiZoneUpdate	add(String zoneId, Object renderer) Deprecated. Returns a new MultiZoneUpdate reflecting the mapping from the indicated zone to an object that will render the content for that zone.
Map<String,Object>	getZoneToRenderMap() Deprecated. Returns a mapping from client zone id to renderer object for that zone.
String	toString() Deprecated.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MultiZoneUpdate

public MultiZoneUpdate(String zoneId,
                       Object renderer)

Deprecated.

MultiZoneUpdate

public MultiZoneUpdate(ClientBodyElement zone)

Deprecated.

Alternate constructor that takes a ClientBodyElement (typically, a Zone).

Method Detail

add

public MultiZoneUpdate add(ClientBodyElement zone)

Deprecated.

Adds the zone (represented by the ClientBodyElement) to the update.

Since:

5.2.3

add

public MultiZoneUpdate add(String zoneId,
                           Object renderer)

Deprecated.

Returns a new MultiZoneUpdate reflecting the mapping from the indicated zone to an object that will render the content for that zone.

Parameters:

zoneId - client id of zone to update

renderer - object that can provide the content for the zone

Returns:

new MultiZoneUpdate

getZoneToRenderMap

public Map<String,Object> getZoneToRenderMap()

Deprecated.

Returns a mapping from client zone id to renderer object for that zone.

Returns:

string to renderer map

toString

public String toString()

Deprecated.

Overrides:

toString in class Object