Package net.ssehub.easy.instantiation.core.model.artifactModel.xml

Interface IXmlContainer

All Known Implementing Classes:

XmlElement, XmlFileArtifact, XmlRootElement

public interface IXmlContainer

Defines the operations of an XML container, i.e., an element which contains XML elements.

Author:

Holger Eichelberger

Method Summary

Modifier and Type	Method	Description
Set<XmlElement>	selectByName(java.lang.String name)	Returns a Set with all XmlElements matching name.
Set<XmlElement>	selectByPath(java.lang.String path)	Selects XML elements according to a given path.
Set<XmlElement>	selectByXPath(java.lang.String path)	Selects XML elements according to a given XPath.

Method Detail

selectByPath

Set<XmlElement> selectByPath(java.lang.String path)
                      throws VilException

Selects XML elements according to a given path. We may go for XPath expressions in future.

Parameters:

path - the path to the elements

Returns:

the matching elements (may be empty)

Throws:

VilException - in case invalid XmlElements are used.

selectByXPath

Set<XmlElement> selectByXPath(java.lang.String path)
                       throws VilException

Selects XML elements according to a given XPath.

Parameters:

path - the XPath to the elements

Returns:

the matching elements (may be empty)

Throws:

VilException - in case invalid XmlElements are used.

selectByName

Set<XmlElement> selectByName(java.lang.String name)
                      throws VilException

Returns a Set with all XmlElements matching name. Childs are processed aswell.
Uses case sensitivity by default.

Parameters:

name - The required name.

Returns:

set with matching XmlElements.

Throws:

VilException - in case that invalid Elements are used.