Create an XML Document from a string of XML. Calls fail if any exception is thrown. @param xml The XML to turn into a document. @return A DOM docume

Returns the partner of a given node. Returns null if the node does not exist. @param n the node to find the partner of. @return the partne

Apply DUL patch to XML document. @param doc the XML document to be patched @param patch the DUL patch @throws PatchFormatException if there is an e

Performs fast match algorithm on given DOM documents. TODO: May want to consider starting at same point in 2nd tree somehow, may lead to better mat

Determines if two NodeInfo objects are equal. Just calls equals on the underlying nodes. @param o NodeInfo to compare with @return True if nodes are

Writes given XML document to given stream. Uses UTF8 encoding, preserves spaces. Adds XML declaration with standalone set to "yes". @param doc DOM d

Get the number of nodes stored. Note that this includes both nodes and partners. @return The number of nodes stored.

Get the XPath child number. @return XPath child number of associated node.

Mark the node as being "inorder". @param n the node to mark as "inorder"

Adds a pair of nodes to the set. Sets UserData as matched. @param x first node @param y partner of first node

Tests if the given node is a text or CDATA node. @param node The node to test @return True if the type is TEXT_NODE or CDATA_SECTION_NODE

Get the DOM child number. @return DOM child number of associated node.

Get the XML Document for the EditScript. @return The EditScript as an XML document.

Gets the nodes in set1 which have matches in set2. @param set1 the first set of nodes @param set2 the set of nodes to match against @param

Remove a Node from the Fifo. This Node is always the oldest item in the array. @return the oldest item in the Fifo

Helper method for testGetXPath. Gets the XPath for the node and evaluates it, checking if the same node is returned. DocumentType nodes are ignored

Creates an Edit Script conforming to matchings that transforms doc1 into doc2. Uses algorithm in "Change Detection in Hierarchically Structured Infor

Calculates an XPath that uniquely identifies the given node. For text nodes note that the given node may only be part of the returned node due to coal

Check if nodes are the same. Does not test if data equivalent, but if same node in same doc. TODO: Handle null cases. @param x first node to check @

Get the in-order XPath child number. Only counts nodes marked in-order. @return In-order XPath child number of associated node.

Get the XPath child number. @return XPath child number of associated node.

Get the XPath child number. @return XPath child number of associated node.

Gets the local name of the node if not null, else just the node name. Avoids issues with getLocalName returning null. @param n Node to get the name

Adds a delete operation to the EditScript for the given Node. @param n The Node that is to be deleted

Check if node is marked "inorder". Note that nodes are inorder by default. @param n node to check @return false if UserData set to False, true other

Check if node is marked "matched". Made static so that I can use a instance method later if it is faster or better. @param n node to check @return t

Check if node is an empty text node. @param n The Node to test. @return True if it is a 0 sized text node

Helper method for testing nodes. @param n The node to test @param expectedDepth The expected depth of the node

Returns the character position to insert the node as. @return The character position to insert the node at

Returns the DOM number the node should have when inserted. @return the DOM number to insert the node as

Get the in-order DOM child number. Only counts nodes marked in-order. @return In-order DOM child number of associated node.

Returns the XPath number the node should have when inserted. @return The XPath number to insert the node as

Insert a node under parent node at given position. @param siblings the NodeList to insert the node into @param parent the parent to insert the node

Adds a Node to the Fifo. @param n the Node to added

Mark the node as not being "inorder". @param n the node to mark as not "inorder"

Compares the result of the xpath expression to the expected Node n. Also tests children. @param n The expected result node @param xpath The expressi

Gets the DOM index of a node, ignoring the given node. @param n The node to ignore @return The DOM index of the node, ignoring n

Gets the Longest Common Subsequence for the given Node arrays. "Matched" Nodes are considered equal. The returned nodes are from s1. TODO: Check for

Get the value associated with the operation node. Returns an empty sting if no value. @param op the operation node @throws PatchFormatException if t

Sets various features on the DOM Parser. @param parserFactory The parser to be set up

Adds an insert operation to the EditScript. @param n The node to insert @param parent The Node to be parent of n @param childno The child number of t

Returns true if the attribute is namespace declaration. Takes a node to avoid casts. @param n Attribute to check if namespace declaration @return Tr

Adds a Move operation to the EditScript. @param n The node being moved @param parent XPath to the new parent Node @param childno Child number of the

Adds the children of a node to the fifo. TODO: Check use of isBanned() @param x the node whose children are to be added

Delete the appropriate amount of text from a Node. Assumes delNode is the start of the text. @param delNode the text node to delete text from @param

Reads a file into an XML document. Note configuration of parser as in initParser. @param f The file to be read into an XML document @return The DOM

Returns the NodeList as an array of Nodes. @param nodeList The NodeList to convert @return A Node[] representing the NodeList.

Gets the XPath character position of a node, ignoring the given node. @param n The node to ignore @return The DOM index of the node, ignoring n

Returns the XPath position, ignoring the given node. @param n The node to ignore @return The XPath position of the node ignoring n

Outputs debug message for node. @param n The Node to output debug on

Creates an instance of the appropriate Diff engine. Currently only FMES, may be more in future. @return a difference engine meeting implementing the

Differences two files. Returns a patch document representing the differences. The document will have only one empty element if the documents are ide

Returns the depth value. @return The current depth value

Get value of name attribute. @param attrs attributes of operation node @return the value of the name attribute @throws PatchFormatException If the n

Get value of namespace attribute. Returns null if not existent, does not throw exception. @param attrs attributes of operation node @return the valu

Gets the node pointed to by the "node" attribute. @param doc document being patched @param opAttrs attributes of operation node @throws PatchForm

Returns the underlying node. @return The Node.

Gets the string representation of a Node and its children. Catches possible IOExceptions and rethrows as unchecked. @param n The Node to get the Stri

Inserts a given node as numbered child of a parent node. If childNum doesn't exist the node is simply appended. @param childNum the position to add

If debug mode is on, extra debug info is output. @return True if debug is on

Checks if the Fifo contains any objects. @return true if there are any objects in the Fifo

Outputs debug information.

Tests if previous node is a text node. @param siblings siblings of current node @param index index of current node @return true if previous node i

Remove a node and it's partner from the list of matchings. @param n The Node to remove

Aligns children of current node that are not in order. @param w the match of the current node. @param x the current node @param matchings the set

Sets the XPath child number and text position.

Sets the XPath child number and text position.

Compares two elements to determine whether they should be matched. xmlns attributes are ignored. TODO: This method is critical in getting good resul

Calls fmes diff on two files. @return The delta @param file1 The original file @param file2 The modified file @throws DiffException If someth

Get value of charpos attribute. Defaults to 1 if not present. @param opAttrs attributes of operation node @return the value of charpos @throws Patch

Get the DOM Child number of a node using "childno" attribute. If attribute doesn't exist, assumes childno = 1. @param opAttrs the attributes of the

Get value of length attribute. @param attrs attributes of operation node @return the value of the length attr @throws PatchFormatException If the len

Gets the node pointed to by the "parent" attribute. @param doc document being patched @param opAttrs attributes of operation node @throws PatchFo

Gets the string representation of a Node but not its children. Catches possible IOExceptions and rethrows as unchecked. @param n The Node to get the

Returns the node pointed to by a given xPath. @param doc document being patched @param xPath xPath to the node @throws PatchFormatException if ther

Determines whether XPath index should be incremented. Handles differences between DOM index and XPath index @param i The current position in sibling

Returns a list of Nodes sorted according to their depths. Does NOT include root or documentElement TreeSet is sorted in reverse order of depth accor

Appends an insert operation to the EditScript given the inserted node, XPath to parent, character position & child number. Set charpos to 1 if not ne

Gets whether external entities should be resolved. @return True if external entities are resolved.

Mark the children of a node in order. @param n the parent of the nodes to mark in order

Mark the children of a node out of order. @param n the parent of the nodes to mark out of order

Determines whether the given Nodes are all text nodes or not. @param nodes The Nodes to checks. @return true if all the given Nodes are text nodes

Output help and exit.

Outputs brief help message to standard out and exits.

Output details of other software used in diffxml and patchxml.

Outputs usage message to standard error.

Output version and exit.

Outputs the current version of diffxml to standard out.

Only report if files differ, do not output differences. @param brief Sets brief output

Sets whether the DUL output format is used. @param useDUL If true, the DUL output format is used.

Sets whether the FMES algorithm is used. @param useFMES If true, the FMES algorithm is used.

Adds inserts for attributes of a node to an EditScript. @param attrs the attributes to be added @param path the path to the nod

Calculates the DOM index of the node.

Calculates the depth of a Node. The root Node is at depth 0. @param node The Node to calculate the depth of @return The depth of the node

Calculates the "in order" DOM child number of the node.

Set the in-order XPath child number of the node. @return The DOM index of the node in its siblings

Calculate the character position of the node. @param domIndex The DOM index of the node in its siblings.

Set the XPath child number of the node. @return The DOM index of the node in its siblings

Calculate the character position of the node. @param domIndex The DOM index of the node in its siblings.

Checks if input files exist. Outputs error message if input not found. @return True only if both files are found.