org.karora.cooee.webcontainer.syncpeer
Class ActiveTextFieldPeer

java.lang.Object
  org.karora.cooee.webcontainer.syncpeer.ActiveTextFieldPeer

All Implemented Interfaces:

ActionProcessor, ComponentSynchronizePeer, FocusSupport, ImageRenderSupport, PropertyUpdateProcessor

Direct Known Subclasses:

IntegerTextFieldPeer, NumericTextFieldPeer, RegExTextFieldPeer

public abstract class ActiveTextFieldPeer
extends java.lang.Object
implements ActionProcessor, ComponentSynchronizePeer, FocusSupport, ImageRenderSupport, PropertyUpdateProcessor

Abstract base synchronization peer for the built-in org.karora.cooee.informagen.app.ActiveTextField

Field Summary

protected static Alignment	DEFAULT_ICON_POSITION
protected static Alignment	DEFAULT_MSG_POSITION

Fields inherited from interface org.karora.cooee.webcontainer.ActionProcessor

ACTION_NAME, ACTION_VALUE

Fields inherited from interface org.karora.cooee.webcontainer.PropertyUpdateProcessor

PROPERTY_NAME, PROPERTY_VALUE

Constructor Summary

ActiveTextFieldPeer(java.lang.String messageProcessor)
Default constructor.

Method Summary

protected CssStyle	createBaseCssStyle(RenderContext rc, TextComponent textComponent) Creates a base CssStyle for properties common to text components.
java.lang.String	getContainerId(Component child) Returns the id of the HTML element in which the specified component should be rendered.
ImageReference	getImage(Component component, java.lang.String imageId) Retrieves the image identified by the given imageId value for the given Component.
void	processAction(ContainerInstance ci, Component component, org.w3c.dom.Element actionElement) Notifies the ComponentSynchronizePeer that a client action has occurred.
void	processPropertyUpdate(ContainerInstance ci, Component component, org.w3c.dom.Element propertyElement) Notifies the ComponentSynchronizePeer that a client property update has occurred.
void	renderAdd(RenderContext rc, ServerComponentUpdate update, java.lang.String targetId, 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, ServerComponentUpdate update, Component component) Renders a client update to dispose of resources/listeners created for the specified component on the client.
protected void	renderDisposeDirective(RenderContext rc, Component component)
void	renderHtml(RenderContext rc, ServerComponentUpdate addUpdate, org.w3c.dom.Node parentNode, Component component)
protected org.w3c.dom.Element	renderInitDirective(RenderContext rc, ActiveTextField activeTextField) Renders a directive to the outgoing ServerMessage to initialize the state of a text component, performing tasks such as registering event listeners on the client.
void	renderSetFocus(RenderContext rc, Component component) Renders a directive to set the client input focus to the specified component.
boolean	renderUpdate(RenderContext rc, 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

Field Detail

DEFAULT_MSG_POSITION

protected static final Alignment DEFAULT_MSG_POSITION

DEFAULT_ICON_POSITION

protected static final Alignment DEFAULT_ICON_POSITION

Constructor Detail

ActiveTextFieldPeer

public ActiveTextFieldPeer(java.lang.String messageProcessor)

Default constructor.

Method Detail

getImage

public ImageReference getImage(Component component,
                               java.lang.String imageId)

Description copied from interface: ImageRenderSupport

Retrieves the image identified by the given imageId value for the given Component.

Note: A reference to any images to be rendered must be maintained throughout the rendering process, due to the fact that the image rendering subsystem creates a weak-keyed cache of images to be rendered. This method therefore may not simply return a new, otherwise-unreferenced image. In the event that this presents a problem, the recommended workaround is to simply store such otherwise unreferenced ImageReferences using a RenderState object.

Specified by:

getImage in interface ImageRenderSupport

Parameters:

component - the component

imageId - the id of the image

Returns:

the target image

See Also:

ImageRenderSupport.getImage(org.karora.cooee.app.Component, java.lang.String)

processAction

public void processAction(ContainerInstance ci,
                          Component component,
                          org.w3c.dom.Element actionElement)

Description copied from interface: ActionProcessor

Notifies the ComponentSynchronizePeer that a client action has occurred.

Specified by:

processAction in interface ActionProcessor

Parameters:

ci - the relevant ContainerInstance

component - the target Component

actionElement - the XML element describing the action (the name and value of the action may be obtained by querying the ACTION_NAME and ACTION_VALUE attribute values.

See Also:

ActionProcessor.processAction(org.karora.cooee.webcontainer.ContainerInstance, org.karora.cooee.app.Component, org.w3c.dom.Element)

processPropertyUpdate

public void processPropertyUpdate(ContainerInstance ci,
                                  Component component,
                                  org.w3c.dom.Element propertyElement)

Description copied from interface: PropertyUpdateProcessor

Notifies the ComponentSynchronizePeer that a client property update has occurred.

Specified by:

processPropertyUpdate in interface PropertyUpdateProcessor

Parameters:

ci - the relevant ContainerInstance

component - the target Component

propertyElement - the XML element describing the property update (the name and value of the changed property may be obtained by querying the PROPERTY_NAME and PROPERTY_VALUE attribute values.

See Also:

PropertyUpdateProcessor.processPropertyUpdate( org.karora.cooee.webcontainer.ContainerInstance, org.karora.cooee.app.Component, org.w3c.dom.Element)

renderSetFocus

public void renderSetFocus(RenderContext rc,
                           Component component)

Description copied from interface: FocusSupport

Renders a directive to set the client input focus to the specified component.

Specified by:

renderSetFocus in interface FocusSupport

Parameters:

rc - the relevant RenderContext

component - the Component to be focused.

See Also:

FocusSupport.renderSetFocus(org.karora.cooee.webcontainer.RenderContext, org.karora.cooee.app.Component)

getContainerId

public java.lang.String getContainerId(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(org.karora.cooee.app.Component)

renderAdd

public void renderAdd(RenderContext rc,
                      ServerComponentUpdate update,
                      java.lang.String targetId,
                      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(org.karora.cooee.webcontainer.RenderContext, org.karora.cooee.app.update.ServerComponentUpdate, java.lang.String, org.karora.cooee.app.Component)

renderDispose

public void renderDispose(RenderContext rc,
                          ServerComponentUpdate update,
                          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

renderDisposeDirective

protected void renderDisposeDirective(RenderContext rc,
                                      Component component)

renderInitDirective

protected org.w3c.dom.Element renderInitDirective(RenderContext rc,
                                                  ActiveTextField activeTextField)

Renders a directive to the outgoing ServerMessage to initialize the state of a text component, performing tasks such as registering event listeners on the client.

Parameters:

rc - the relevant RenderContext

integerTextField - the LiveTextField

renderUpdate

public boolean renderUpdate(RenderContext rc,
                            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(org.karora.cooee.webcontainer.RenderContext, org.karora.cooee.app.update.ServerComponentUpdate, java.lang.String)

renderHtml

public void renderHtml(RenderContext rc,
                       ServerComponentUpdate addUpdate,
                       org.w3c.dom.Node parentNode,
                       Component component)

createBaseCssStyle

protected CssStyle createBaseCssStyle(RenderContext rc,
                                      TextComponent textComponent)

Creates a base CssStyle for properties common to text components.

Parameters:

rc - the relevant RenderContext

textComponent - the text component

Returns:

the style