com.tailf.conf

Class ConfPath

Object

com.tailf.conf.InstancePath

com.tailf.conf.ConfPath

public class ConfPath
extends InstancePath

Class Representing an KeyPath path.

String representations e.g "/n:rootA/nodeB/listC{key1}/leafD" User applications usually needs to construct string representations of paths in this way. To construct a ConfPath from this representation use ConfPath(String, Object...)

Constructor Summary

Constructors

Constructor and Description
ConfPath(ConfEBinary o) Initialize a ConfPath.
ConfPath(ConfEList o) Initialize a ConfPath.
ConfPath(ConfObject[] kp) Initializes a new instance of this class from a given reverted ConfObject[] keypath where elements is either ConfTag or ConfKey.
ConfPath(String fmt, Object... arguments) Construct a ConfPath from a string path representation and of optional arguments.

Method Summary

Methods

Modifier and Type	Method and Description
ConfPath	append(String s) Appends suffix path to existing keypath
Object	clone() Clones the ConfPath
ConfPath	copyAppend(String s) CopyAppends to the keypath
String	toString() Default String representation of this path, which is the keypath string representation
String	toXPathString() Returns this path as an XPath string

Methods inherited from class com.tailf.conf.InstancePath

atoString, encode, encodeIKP, equals, getCSNode, getKP, hashCode, isKey, isRel

Methods inherited from class Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ConfPath

public ConfPath(ConfEBinary o)
         throws ConfException

Initialize a ConfPath. (This constructor is rarely used for applications; usually for internal use)

Parameters:

o - element constitute a ConfPath

Throws:

ConfException

ConfPath

public ConfPath(ConfEList o)

Initialize a ConfPath. (This constructor is rarely used for applications; usually for internal uses)

Parameters:

o - element (reversed) constitute a ConfPath

Throws:

ConfException

ConfPath

public ConfPath(ConfObject[] kp)

Initializes a new instance of this class from a given reverted ConfObject[] keypath where elements is either ConfTag or ConfKey.

Parameters:

kp - reverted keypath

ConfPath

public ConfPath(String fmt,
        Object... arguments)
         throws ConfException

Construct a ConfPath from a string path representation and of optional arguments.

The path is expressed as a format string that could contain fixed text with zero to many embedded format specifiers.

For each specifier one argument in the variable argument list is expected.

format specifiers in the Java API is:

• %d - requiring an integer parameter (type int) to be substituted.

• %s - requiring a java.lang.String parameter to be substituted.

• %x - requiring subclasses of type com.tailf.conf.ConfValue to be substituted.

Parameters:

fmt - path string representation

arguments - optional parameters for substitution in fmt

Throws:

ConfException

Method Detail

append

public ConfPath append(String s)
                throws ConfException

Appends suffix path to existing keypath

Throws:

ConfException

clone

public Object clone()

Clones the ConfPath

Overrides:

clone in class Object

copyAppend

public ConfPath copyAppend(String s)
                    throws ConfException

CopyAppends to the keypath

Throws:

ConfException

toString

public String toString()

Default String representation of this path, which is the keypath string representation

Overrides:

toString in class InstancePath

Returns:

Default string representation

toXPathString

public String toXPathString()

Returns this path as an XPath string

Overrides:

toXPathString in class InstancePath

Returns:

XPath string representation