NextApp Echo2
v2.1.1

nextapp.echo2.webcontainer.syncpeer
Class WindowPeer

java.lang.Object
  extended by nextapp.echo2.webcontainer.syncpeer.WindowPeer
All Implemented Interfaces:
ComponentSynchronizePeer, RootSynchronizePeer

public class WindowPeer
extends java.lang.Object
implements RootSynchronizePeer

Synchronization peer for nextapp.echo2.app.Window components.

This class should not be extended or used by classes outside of the Echo framework.


Constructor Summary
WindowPeer()
          Default constructor.
 
Method Summary
 java.lang.String getContainerId(nextapp.echo2.app.Component child)
          Returns the id of the HTML element in which the specified component should be rendered.
 void renderAdd(RenderContext rc, nextapp.echo2.app.update.ServerComponentUpdate update, java.lang.String targetId, nextapp.echo2.app.Component component)
          Renders a client update which adds an HTML representation of the provided component to the client DOM as a child of the HTML element identified by targetId.
 void renderDispose(RenderContext rc, nextapp.echo2.app.update.ServerComponentUpdate update, nextapp.echo2.app.Component component)
          Renders a client update to dispose of resources/listeners created for the specified component on the client.
 void renderRefresh(RenderContext rc, nextapp.echo2.app.update.ServerComponentUpdate update, nextapp.echo2.app.Component component)
          Renders a complete refresh of the client state.
 boolean renderUpdate(RenderContext rc, nextapp.echo2.app.update.ServerComponentUpdate update, java.lang.String targetId)
          Renders the specified ServerComponentUpdate by adding and removing children and updating properties of the specified component.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

WindowPeer

public WindowPeer()
Default constructor.

Method Detail

renderAdd

public void renderAdd(RenderContext rc,
                      nextapp.echo2.app.update.ServerComponentUpdate update,
                      java.lang.String targetId,
                      nextapp.echo2.app.Component component)
Description copied from interface: ComponentSynchronizePeer
Renders a client update which adds an HTML representation of the provided component to the client DOM as a child of the HTML element identified by targetId.

Specified by:
renderAdd in interface ComponentSynchronizePeer
Parameters:
rc - the relevant RenderContext
update - the ServerComponentUpdate for which this operation is being performed
targetId - the id of the HTML element in which the component's HTML output should be rendered
component - the component to be rendered (this component must be of a type supported by this synchronization peer).
See Also:
ComponentSynchronizePeer.renderAdd(nextapp.echo2.webcontainer.RenderContext, nextapp.echo2.app.update.ServerComponentUpdate, java.lang.String, nextapp.echo2.app.Component)

getContainerId

public java.lang.String getContainerId(nextapp.echo2.app.Component child)
Description copied from interface: ComponentSynchronizePeer
Returns the id of the HTML element in which the specified component should be rendered. The specified component must be an immediate child of an instance of the class of component that this peer supports. A child component's renderer may invoke this method to determine where it should place its rendered content.

Specified by:
getContainerId in interface ComponentSynchronizePeer
Parameters:
child - a Component whose parent is of the type synchronized by this peer object.
Returns:
the id of the element which should contain the child component's rendered HTML.
See Also:
ComponentSynchronizePeer.getContainerId(nextapp.echo2.app.Component)

renderDispose

public void renderDispose(RenderContext rc,
                          nextapp.echo2.app.update.ServerComponentUpdate update,
                          nextapp.echo2.app.Component component)
Description copied from interface: ComponentSynchronizePeer
Renders a client update to dispose of resources/listeners created for the specified component on the client. Operations such as removing event listeners on the client should be performed by the implementation. In cases where no such clean-up work is required, an empty implementation is sufficient. Note that the actual removal of HTML code will be performed by an ancestor component's renderUpdate() method being invoked, and thus implementations SHOULD NOT redundantly attempt to remove the HTML in this method. Implementations must handle the condition where the component to be disposed is not present in the client DOM, as this method may be invoked under such a condition.

Specified by:
renderDispose in interface ComponentSynchronizePeer
Parameters:
rc - the relevant RenderContext
update - the ServerComponentUpdate for which this operation is being performed
See Also:
ComponentSynchronizePeer.renderDispose(nextapp.echo2.webcontainer.RenderContext, nextapp.echo2.app.update.ServerComponentUpdate, nextapp.echo2.app.Component)

renderRefresh

public void renderRefresh(RenderContext rc,
                          nextapp.echo2.app.update.ServerComponentUpdate update,
                          nextapp.echo2.app.Component component)
Description copied from interface: RootSynchronizePeer
Renders a complete refresh of the client state.

Specified by:
renderRefresh in interface RootSynchronizePeer
Parameters:
rc - the relevant RenderContext
update - the full refresh ServerComponentUpdate
component - the root component
See Also:
RootSynchronizePeer.renderRefresh(nextapp.echo2.webcontainer.RenderContext, nextapp.echo2.app.update.ServerComponentUpdate, nextapp.echo2.app.Component)

renderUpdate

public boolean renderUpdate(RenderContext rc,
                            nextapp.echo2.app.update.ServerComponentUpdate update,
                            java.lang.String targetId)
Description copied from interface: ComponentSynchronizePeer
Renders the specified ServerComponentUpdate by adding and removing children and updating properties of the specified component.

If the component is not a container, the implementation only needs to analyze the updated properties of the component. If the component is a container, the implementation should additionally query update for information about added children, removed children, and children with updated LayoutData states.

The implementation is responsible for rendering added children by obtaining their ComponentSynchronizePeers and invoking their renderAdd() methods. Alternatively, if a child's ComponentSynchronizePeer implements the DomUpdateSupport interface, the implementation may invoke the child peer's renderHtml() method instead.

This method should return true if, in the course of its rendering operation, it has re-rendered the entire component hierarchy beneath the parent component of the update. Returning true will ensure that updates to descendants are NOT rendered. The method should return false in all cases if the component is not a container.

Specified by:
renderUpdate in interface ComponentSynchronizePeer
Parameters:
rc - the relevant RenderContext
update - the ServerComponentUpdate for which this operation is being performed
targetId - the id of the HTML element inside of which the components HTML code should be rendered.
Returns:
true if updates to descendants should NOT be performed
See Also:
ComponentSynchronizePeer.renderUpdate(nextapp.echo2.webcontainer.RenderContext, nextapp.echo2.app.update.ServerComponentUpdate, java.lang.String)

NextApp Echo2
v2.1.1