com.itextpdf.kernel.utils

Class CompareTool.ObjectPath

java.lang.Object

com.itextpdf.kernel.utils.CompareTool.ObjectPath

Enclosing class:

CompareTool

public class CompareTool.ObjectPath
extends Object

Class that helps to find two corresponding objects in the comparing documents and also keeps track of the already met in comparing process parent indirect objects.

You could say that ObjectPath instance consists of two parts: direct path and indirect path. Direct path defines path to the currently comparing objects in relation to base objects. It could be empty, which would mean that currently comparing objects are base objects themselves. Base objects are the two indirect objects from the comparing documents which are in the same position in the pdf trees. Another part, indirect path, defines which indirect objects were met during comparison process to get to the current base objects. Indirect path is needed to avoid infinite loops during comparison.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	CompareTool.ObjectPath.ArrayPathItem Direct path item (see CompareTool.ObjectPath, which describes transition to the PdfArray element which is now a currently comparing direct object.
class	CompareTool.ObjectPath.DictPathItem Direct path item (see CompareTool.ObjectPath, which describes transition to the PdfDictionary entry which value is now a currently comparing direct object.
class	CompareTool.ObjectPath.IndirectPathItem An item in the indirect path (see CompareTool.ObjectPath.
class	CompareTool.ObjectPath.LocalPathItem An abstract class for the items in the direct path (see CompareTool.ObjectPath.
class	CompareTool.ObjectPath.OffsetPathItem Direct path item (see CompareTool.ObjectPath, which describes transition to the specific position in PdfStream.

Field Summary

Fields

Modifier and Type	Field and Description
protected PdfIndirectReference	baseCmpObject
protected PdfIndirectReference	baseOutObject
protected Stack<CompareTool.ObjectPath.IndirectPathItem>	indirects
protected Stack<CompareTool.ObjectPath.LocalPathItem>	path

Constructor Summary

Constructors

Modifier	Constructor and Description
	ObjectPath() Creates empty ObjectPath.
protected	ObjectPath(PdfIndirectReference baseCmpObject, PdfIndirectReference baseOutObject) Creates ObjectPath with corresponding base objects in two documents.

Method Summary

Modifier and Type	Method and Description
protected Object	clone()
boolean	equals(Object obj)
PdfIndirectReference	getBaseCmpObject()
PdfIndirectReference	getBaseOutObject()
Stack<CompareTool.ObjectPath.IndirectPathItem>	getIndirectPath() Gets indirect path which denotes sequence of the indirect references that were passed in comparing process to get to the current base objects.
Stack<CompareTool.ObjectPath.LocalPathItem>	getLocalPath() Gets local (or direct) path that denotes sequence of the path items from base object to the comparing direct object.
int	hashCode()
boolean	isComparing(PdfIndirectReference cmpObject, PdfIndirectReference outObject) This method is used to define if given objects were already met in the path to the current base objects.
void	pop() Removes the last path item from the direct path.
void	pushArrayItemToPath(int index) Adds array item to the direct path.
void	pushDictItemToPath(PdfName key) Adds dictionary item to the direct path.
void	pushOffsetToPath(int offset) Adds offset item to the direct path.
CompareTool.ObjectPath	resetDirectPath(PdfIndirectReference baseCmpObject, PdfIndirectReference baseOutObject) Creates a new ObjectPath instance with two new given base objects, which are supposed to be nested in the base objects of the current instance of the ObjectPath.
String	toString()
Node	toXmlNode(Document document) Creates an xml node that describes a direct path stored in this ObjectPath instance.

Methods inherited from class java.lang.Object

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

Field Detail

baseCmpObject

protected PdfIndirectReference baseCmpObject

baseOutObject

protected PdfIndirectReference baseOutObject

path

protected Stack<CompareTool.ObjectPath.LocalPathItem> path

indirects

protected Stack<CompareTool.ObjectPath.IndirectPathItem> indirects

Constructor Detail

ObjectPath

public ObjectPath()

Creates empty ObjectPath.

ObjectPath

protected ObjectPath(PdfIndirectReference baseCmpObject,
                     PdfIndirectReference baseOutObject)

Creates ObjectPath with corresponding base objects in two documents.

Parameters:

baseCmpObject - base object in cmp document.

baseOutObject - base object in out document.

Method Detail

resetDirectPath

public CompareTool.ObjectPath resetDirectPath(PdfIndirectReference baseCmpObject,
                                              PdfIndirectReference baseOutObject)

Creates a new ObjectPath instance with two new given base objects, which are supposed to be nested in the base objects of the current instance of the ObjectPath. This method is used to avoid infinite loop in case of circular references in pdf documents objects structure.
Basically, this method creates copy of the current ObjectPath instance, but resets information of the direct paths, and also adds current ObjectPath instance base objects to the indirect references chain that denotes a path to the new base objects.

Parameters:

baseCmpObject - new base object in cmp document.

baseOutObject - new base object in out document.

Returns:

new ObjectPath instance, which stores chain of the indirect references which were already met to get to the new base objects.

isComparing

public boolean isComparing(PdfIndirectReference cmpObject,
                           PdfIndirectReference outObject)

This method is used to define if given objects were already met in the path to the current base objects. If this method returns true it basically means that we found a loop in the objects structure and that we already compared these objects.

Parameters:

cmpObject - cmp object to check if it was already met in base objects path.

outObject - out object to check if it was already met in base objects path.

Returns:

true if given objects are contained in the path and therefore were already compared.

pushArrayItemToPath

public void pushArrayItemToPath(int index)

Adds array item to the direct path. See CompareTool.ObjectPath.ArrayPathItem.

Parameters:

index - index in the array of the direct object to be compared.

pushDictItemToPath

public void pushDictItemToPath(PdfName key)

Adds dictionary item to the direct path. See CompareTool.ObjectPath.DictPathItem.

Parameters:

key - key in the dictionary to which corresponds direct object to be compared.

pushOffsetToPath

public void pushOffsetToPath(int offset)

Adds offset item to the direct path. See CompareTool.ObjectPath.OffsetPathItem.

Parameters:

offset - offset to the specific byte in the stream that is compared.

pop

public void pop()

Removes the last path item from the direct path.

getLocalPath

public Stack<CompareTool.ObjectPath.LocalPathItem> getLocalPath()

Gets local (or direct) path that denotes sequence of the path items from base object to the comparing direct object.

Returns:

direct path to the comparing object.

getIndirectPath

public Stack<CompareTool.ObjectPath.IndirectPathItem> getIndirectPath()

Gets indirect path which denotes sequence of the indirect references that were passed in comparing process to get to the current base objects.

Returns:

indirect path to the current base objects.

getBaseCmpObject

public PdfIndirectReference getBaseCmpObject()

Returns:

current base object in the cmp document.

getBaseOutObject

public PdfIndirectReference getBaseOutObject()

Returns:

current base object in the out document.

toXmlNode

public Node toXmlNode(Document document)

Creates an xml node that describes a direct path stored in this ObjectPath instance.

Parameters:

document - xml document, to which this xml node will be added.

Returns:

an xml node describing direct path.

toString

public String toString()

Overrides:

toString in class Object

Returns:

string representation of the direct path stored in this ObjectPath instance.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

clone

protected Object clone()

Overrides:

clone in class Object