IIOMetadata
object from a tree of XML DOM Node
s whose syntax is defined by the given metadata format. The previous state is altered only as necessary to accommodate the nodes that are present in the given tree. If the tree structure or contents are invalid, an IIOInvalidTreeException
will be thrown. As the semantics of how a tree or subtree may be merged with another tree are completely format-specific, plug-in authors may implement this method in whatever manner is most appropriate for the format, including simply replacing all existing state with the contents of the given tree.
@param formatName the desired metadata format.
@param root an XML DOM Node
object forming theroot of a tree.
@exception IllegalStateException if this object is read-only.
@exception IllegalArgumentException if formatName
is null
or is not one of the names returned by getMetadataFormatNames
.
@exception IllegalArgumentException if root
isnull
.
@exception IIOInvalidTreeException if the tree cannot be parsedsuccessfully using the rules of the given format.
@see #getMetadataFormatNames
@see #getAsTree
@see #setFromTree
|
|
|
|
|
|
|
|