com.helger.commons.xml.xpath

Class MapBasedXPathVariableResolverQName

java.lang.Object

com.helger.commons.xml.xpath.MapBasedXPathVariableResolverQName

All Implemented Interfaces:

ICloneable<MapBasedXPathVariableResolverQName>, XPathVariableResolver

@NotThreadSafe
public class MapBasedXPathVariableResolverQName
extends Object
implements XPathVariableResolver, ICloneable<MapBasedXPathVariableResolverQName>

Class is used in conjunction with XPathExpression to resolve variable values used in XPath queries at runtime. The whole QName is used as the key in the map. The namespace is not-ignored in this class.

Author:

Philip Helger

See Also:

MapBasedXPathVariableResolver

Constructor Summary

Constructors

Constructor and Description
MapBasedXPathVariableResolverQName() Default ctor.
MapBasedXPathVariableResolverQName(Map<QName,?> aVars) Ctor taking another map.
MapBasedXPathVariableResolverQName(MapBasedXPathVariableResolverQName aOther) Copy constructor

Method Summary

Methods

Modifier and Type	Method and Description
EChange	addAllFrom(MapBasedXPathVariableResolver aOther, boolean bOverwrite) Add all variables from the other variable resolver into this resolver.
EChange	addAllFrom(MapBasedXPathVariableResolverQName aOther, boolean bOverwrite) Add all variables from the other variable resolver into this resolver.
EChange	addUniqueVariable(QName aName, Object aValue) Add a new variable.
EChange	clear() Remove all variables at once.
boolean	equals(Object o)
Map<QName,?>	getAllVariables()
MapBasedXPathVariableResolverQName	getClone()
int	getVariableCount()
int	hashCode()
EChange	removeVariable(QName aName) Remove the variable with the specified name.
EChange	removeVariables(Iterable<QName> aNames) Remove multiple variables at once.
Object	resolveVariable(QName aVariableName)
void	setAllVariables(Map<QName,?> aVars) Set multiple variables at once.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

MapBasedXPathVariableResolverQName

public MapBasedXPathVariableResolverQName()

Default ctor.

MapBasedXPathVariableResolverQName

public MapBasedXPathVariableResolverQName(@Nullable
                                  Map<QName,?> aVars)

Ctor taking another map.

Parameters:

aVars - Variables to re-use. May be null.

MapBasedXPathVariableResolverQName

public MapBasedXPathVariableResolverQName(@Nonnull
                                  MapBasedXPathVariableResolverQName aOther)

Copy constructor

Parameters:

aOther - Object to copy data from

Method Detail

addUniqueVariable

@Nonnull
public EChange addUniqueVariable(@Nonnull
                                QName aName,
                                @Nonnull
                                Object aValue)

Add a new variable.

Parameters:

aName - The qualified name of the variable

aValue - The value to be used.

Returns:

EChange

addAllFrom

@Nonnull
public EChange addAllFrom(@Nonnull
                         MapBasedXPathVariableResolverQName aOther,
                         boolean bOverwrite)

Add all variables from the other variable resolver into this resolver.

Parameters:

aOther - The variable resolver to import the variable from. May not be null.

bOverwrite - if true existing variables will be overwritten with the new variables, otherwise the old variables are kept.

Returns:

EChange

addAllFrom

@Nonnull
public EChange addAllFrom(@Nonnull
                         MapBasedXPathVariableResolver aOther,
                         boolean bOverwrite)

Add all variables from the other variable resolver into this resolver. This methods creates a QName with an empty namespace URI.

Parameters:

aOther - The variable resolver to import the variable from. May not be null.

bOverwrite - if true existing variables will be overwritten with the new variables, otherwise the old variables are kept.

Returns:

EChange

removeVariable

@Nonnull
public EChange removeVariable(@Nullable
                             QName aName)

Remove the variable with the specified name.

Parameters:

aName - The name to be removed. May be null.

Returns:

EChange

removeVariables

@Nonnull
public EChange removeVariables(@Nullable
                              Iterable<QName> aNames)

Remove multiple variables at once.

Parameters:

aNames - The names to be removed. May be null.

Returns:

EChange.CHANGED if at least one variable was removed.

getAllVariables

@Nonnull
@ReturnsMutableCopy
public Map<QName,?> getAllVariables()

Returns:

A mutable copy of all contained variables. Never null but maybe empty.

getVariableCount

@Nonnegative
public int getVariableCount()

Returns:

The number of contained variables. Always ≥ 0.

clear

@Nonnull
public EChange clear()

Remove all variables at once.

Returns:

EChange.CHANGED if at least one variable was removed.

setAllVariables

public void setAllVariables(@Nullable
                   Map<QName,?> aVars)

Set multiple variables at once.

Parameters:

aVars - The variables to be set. May be null.

resolveVariable

@Nullable
public Object resolveVariable(@Nonnull
                              QName aVariableName)

Specified by:

resolveVariable in interface XPathVariableResolver

getClone

@Nonnull
@ReturnsMutableCopy
public MapBasedXPathVariableResolverQName getClone()

Specified by:

getClone in interface ICloneable<MapBasedXPathVariableResolverQName>

Returns:

A 100% deep-copy of the implementing class.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object