getHierChildProp()

Retrieves a specified child property for the hierarchical connector configuration property.

Syntax

public CWProperty getHierChildProp(String propName);

Parameters

propName
Specifies the name of the connector configuration property to retrieve.

Return values

A CWProperty object that contains the retrieved child property. If the specified property does not exist in the current hierarchical connector property, the method returns null.

Exceptions

None.

Notes

The getHierChildProp() method retrieves the child property whose name matches propName from the hierarchical connector configuration property. The retrieved property must exist as a child of the current hierarchical property; it cannot be a grandchildren, great-grandchild, and so on. To retrieve child properties at lower levels in the hierarchy, you must first obtain the connector-property object for a property at a particular level and then use a method such as getHierChildProps() or getHierChildProp() to retrieve its children.

Note:
You can use the getHierProp() to retrieve a specified child, grandchild, and so on down the property hierarchy.

Before a call to getHierChildProp(), you can use the hasChildren() method to verify that the hierarchical connector property has child properties. To retrieve all child properties, use the getHierChildProps() method. To retrieve all child properties with a specified prefix, you can use the getChildPropsWithPrefix() method.

See also

getChildPropsWithPrefix(),, getHierChildProps(),, getHierProp(),, hasChildren(),, setValues()

Copyright IBM Corp. 1997, 2004