oracle.cabo.ui
Class DeprecatedUINode

java.lang.Object
  |
  +--oracle.cabo.ui.DeprecatedUINode

All Implemented Interfaces:

UINode

Direct Known Subclasses:

AbstractTextNode, BaseUINode, UINodeProxy

public abstract class DeprecatedUINode

extends java.lang.Object

implements UINode

Abstract UINode class implementing bogus deprecated UINode methods. This class makes implementing support for the deprecated methods easier. As soon as we can remove the deprecated methods, this class will disappear, or at most become an empty stub.

Constructor Summary

DeprecatedUINode()

Method Summary

java.lang.Object	getAttributeValue(RenderingContext context, java.lang.String attrKey) Deprecated. The version of this function taking an AttributeKey rather than a String is more efficient, and thus preferred. Callers should be defining their AttributeKeys as constants and reusing them, rather than calling this method, and forcing the correct AttributeKey to be looked up each time.
java.util.Enumeration	getChildNames() Deprecated. The version of this function also taking a RenderingContext is preferred, as this version will return incorrect results if the presence of any of the named children are determined by the RenderingContext.
java.lang.String	getID() Returns the page-wide unique client ID of this node.
UINode	getIndexedChild(int childIndex) Deprecated. The version of this function also taking a RenderingContext is preferred, as this version will return incorrect results if the specified indexed child is determined by the RenderingContext.
int	getIndexedChildCount() Deprecated. The version of this function also taking a RenderingContext is preferred, as this version will return incorrect results if the specified named child is determined by the RenderingContext.
UINode	getNamedChild(java.lang.String childName) Deprecated. The version of this function also taking a RenderingContext is preferred, as this version will return incorrect results if the presence of any of the named children are determined by the RenderingContext.

Methods inherited from class java.lang.Object

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

Methods inherited from interface oracle.cabo.ui.UINode

getAttributeNames, getAttributeValue, getChildNames, getIndexedChild, getIndexedChildCount, getLocalName, getNamedChild, getNamespaceURI, getNodeID, getNodeRole, getRawAttributeValue, render, render

Constructor Detail

DeprecatedUINode

public DeprecatedUINode()

Method Detail

getID

public java.lang.String getID()

Returns the page-wide unique client ID of this node. The string returned must comply with the XML id specification--namely it must begin with a [a-z][A-z] and after that can contain as many of [a-z][A-Z][0-9][._-:] as desired.

This property is typically only needed when writing client-side JavaScript.

This method is only present on this interface for backwards compatibility and will be removed from this interface in a future version of UIX Components (Marlin) and moved to oracle.cabo.ui.beans.BaseWebBean

Specified by:

getID in interface UINode

getIndexedChildCount

public int getIndexedChildCount()

Deprecated. The version of this function also taking a RenderingContext is preferred, as this version will return incorrect results if the specified named child is determined by the RenderingContext.

Convenience function for returning the number of indexed children in this UINode.

Specified by:

getIndexedChildCount in interface UINode

getIndexedChild

public UINode getIndexedChild(int childIndex)

Deprecated. The version of this function also taking a RenderingContext is preferred, as this version will return incorrect results if the specified indexed child is determined by the RenderingContext.

Convenience function for returning a n indexed UINode child given its index.

Specified by:

getIndexedChild in interface UINode

getChildNames

public final java.util.Enumeration getChildNames()

Deprecated. The version of this function also taking a RenderingContext is preferred, as this version will return incorrect results if the presence of any of the named children are determined by the RenderingContext.

Convenience function for returning an Enumeration of the names of the named children.

Specified by:

getChildNames in interface UINode

getNamedChild

public final UINode getNamedChild(java.lang.String childName)

Deprecated. The version of this function also taking a RenderingContext is preferred, as this version will return incorrect results if the presence of any of the named children are determined by the RenderingContext.

Returns the child identified by childName. Named children are used to represent heterogenously treated children of UINodes.

Constants for named children used by UIX Components (Marlin)'s UINodes may be found in the UIConstants interface. The constants for the named children follow the pattern <xxx>_CHILD.

If the UINode is mutable and may be modified and read in different threads, it is the programmer's responsibility to ensure proper synchronization.

Specified by:

getNamedChild in interface UINode

See Also:

getChildNames(), UIConstants

getAttributeValue

public java.lang.Object getAttributeValue(RenderingContext context,
                                          java.lang.String attrKey)

Deprecated. The version of this function taking an AttributeKey rather than a String is more efficient, and thus preferred. Callers should be defining their AttributeKeys as constants and reusing them, rather than calling this method, and forcing the correct AttributeKey to be looked up each time.

Returns the value of the attribute with the specified name in the UINode. If no attribute with the specified name exists in this UINode, or a checked Exception occurs in retrieving the value of the attribute, null will be returned.

Note that as with indexed children and named children, the presence of of an attribute is no guarantee that the Renderer used to render this UINode will actually use the attribute. The presence of attributes should only be considered as hints to the Renderer.

If the UINode is mutable and may be modified and read in different threads, it is the programmer's responsibility to ensure proper synchronization.

Specified by:

getAttributeValue in interface UINode

See Also:

UINode.getAttributeNames(oracle.cabo.ui.RenderingContext)