Package org.jboss.as.controller

Class PathAddress

java.lang.Object

org.jboss.as.controller.PathAddress

All Implemented Interfaces:

Iterable<PathElement>

public class PathAddress
extends Object
implements Iterable<PathElement>

A path address for an operation.

Author:

Brian Stansberry, David M. Lloyd

Field Summary

Fields

Modifier and Type	Field	Description
static PathAddress	EMPTY_ADDRESS	An empty address.

Method Summary

Modifier and Type	Method	Description
PathAddress	append(String key)
PathAddress	append(String key, String value)
PathAddress	append(List<PathElement> additionalElements)	Create a new path address by appending more elements to the end of this address.
PathAddress	append(PathAddress address)	Create a new path address by appending more elements to the end of this address.
PathAddress	append(PathElement... additionalElements)	Create a new path address by appending more elements to the end of this address.
boolean	equals(Object other)	Determine whether this object is equal to another.
boolean	equals(PathAddress other)	Determine whether this object is equal to another.
PathElement	getElement(int index)	Gets the element at the given index.
PathElement	getLastElement()	Gets the last element in the address.
PathAddress	getParent()
int	hashCode()
boolean	isMultiTarget()	Check whether this address applies to multiple targets.
ListIterator<PathElement>	iterator()	Iterate over the elements of this path address.
boolean	matches(PathAddress address)	Check if this path matches the address path.
static PathAddress	parseCLIStyleAddress(String address)
static PathAddress	pathAddress(String key, String value)
static PathAddress	pathAddress(List<PathElement> elements)
static PathAddress	pathAddress(PathAddress parent, PathElement... elements)
static PathAddress	pathAddress(PathElement... elements)
static PathAddress	pathAddress(org.jboss.dmr.ModelNode node)	Creates a PathAddress from the given ModelNode address.
int	size()	Get the size of this path, in elements.
PathAddress	subAddress(int start)	Get a portion of this address using segments starting at start (inclusive).
PathAddress	subAddress(int start, int end)	Get a portion of this address using segments between start (inclusive) and end (exclusive).
String	toCLIStyleString()
org.jboss.dmr.ModelNode	toModelNode()	Convert this path address to its model node representation.
String	toPathStyleString()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

EMPTY_ADDRESS

public static final PathAddress EMPTY_ADDRESS

An empty address.

Method Detail

pathAddress

public static PathAddress pathAddress(org.jboss.dmr.ModelNode node)

Creates a PathAddress from the given ModelNode address. The given node is expected to be an address node.

Parameters:

node - the node (cannot be null)

Returns:

the update identifier

pathAddress

public static PathAddress pathAddress(List<PathElement> elements)

pathAddress

public static PathAddress pathAddress(PathElement... elements)

pathAddress

public static PathAddress pathAddress(String key,
                                      String value)

pathAddress

public static PathAddress pathAddress(PathAddress parent,
                                      PathElement... elements)

parseCLIStyleAddress

public static PathAddress parseCLIStyleAddress(String address)
                                        throws IllegalArgumentException

Throws:

IllegalArgumentException

getElement

public PathElement getElement(int index)

Gets the element at the given index.

Parameters:

index - the index

Returns:

the element

Throws:

IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())

getLastElement

public PathElement getLastElement()

Gets the last element in the address.

Returns:

the element, or null if size() is zero.

subAddress

public PathAddress subAddress(int start)

Get a portion of this address using segments starting at start (inclusive).

Parameters:

start - the start index

Returns:

the partial address

subAddress

public PathAddress subAddress(int start,
                              int end)

Get a portion of this address using segments between start (inclusive) and end (exclusive).

Parameters:

start - the start index

end - the end index

Returns:

the partial address

append

public PathAddress append(List<PathElement> additionalElements)

Create a new path address by appending more elements to the end of this address.

Parameters:

additionalElements - the elements to append

Returns:

the new path address

append

public PathAddress append(PathElement... additionalElements)

Create a new path address by appending more elements to the end of this address.

Parameters:

additionalElements - the elements to append

Returns:

the new path address

append

public PathAddress append(PathAddress address)

Create a new path address by appending more elements to the end of this address.

Parameters:

address - the address to append

Returns:

the new path address

append

public PathAddress append(String key,
                          String value)

append

public PathAddress append(String key)

toModelNode

public org.jboss.dmr.ModelNode toModelNode()

Convert this path address to its model node representation.

Returns:

the model node list of properties

isMultiTarget

public boolean isMultiTarget()

Check whether this address applies to multiple targets.

Returns:

true if the address can apply to multiple targets, false otherwise

size

public int size()

Get the size of this path, in elements.

Returns:

the size

iterator

public ListIterator<PathElement> iterator()

Iterate over the elements of this path address.

Specified by:

iterator in interface Iterable<PathElement>

Returns:

the iterator

getParent

public PathAddress getParent()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object other)

Determine whether this object is equal to another.

Overrides:

equals in class Object

Parameters:

other - the other object

Returns:

true if they are equal, false otherwise

equals

public boolean equals(PathAddress other)

Determine whether this object is equal to another.

Parameters:

other - the other object

Returns:

true if they are equal, false otherwise

toString

public String toString()

Overrides:

toString in class Object

toCLIStyleString

public String toCLIStyleString()

toPathStyleString

public String toPathStyleString()

matches

public boolean matches(PathAddress address)

Check if this path matches the address path. An address matches this address if its path elements match or are valid multi targets for this path elements. Addresses that are equal are matching.

Parameters:

address - The path to check against this path. If null, this method returns false.

Returns:

true if the provided path matches, false otherwise.