com.itextpdf.kernel.pdf

Class PdfIndirectReference

java.lang.Object

com.itextpdf.kernel.pdf.PdfObject

com.itextpdf.kernel.pdf.PdfIndirectReference

All Implemented Interfaces:

Serializable, Comparable<PdfIndirectReference>

public class PdfIndirectReference
extends PdfObject
implements Comparable<PdfIndirectReference>

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected int	genNr Object generation.
protected int	objectStreamNumber Indirect reference number of object stream containing refersTo object.
protected int	objNr Object number.
protected long	offsetOrIndex Offset in a document of the refersTo object.
protected PdfDocument	pdfDocument PdfDocument object belongs to.
protected PdfObject	refersTo PdfObject that current PdfIndirectReference instance refers to.

Fields inherited from class com.itextpdf.kernel.pdf.PdfObject

ARRAY, BOOLEAN, DICTIONARY, FLUSHED, FORBID_RELEASE, FREE, INDIRECT_REFERENCE, indirectReference, LITERAL, MODIFIED, MUST_BE_FLUSHED, MUST_BE_INDIRECT, NAME, NULL, NUMBER, ORIGINAL_OBJECT_STREAM, READ_ONLY, READING, STREAM, STRING, UNENCRYPTED

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PdfIndirectReference(PdfDocument doc, int objNr)
protected	PdfIndirectReference(PdfDocument doc, int objNr, int genNr)
protected	PdfIndirectReference(PdfDocument doc, int objNr, int genNr, long offset)

Method Summary

Modifier and Type	Method and Description
int	compareTo(PdfIndirectReference o)
protected void	copyContent(PdfObject from, PdfDocument document) Copies object content from object 'from'.
boolean	equals(Object o)
PdfDocument	getDocument()
int	getGenNumber()
int	getIndex() Gets refersTo object index in the object stream.
int	getObjNumber()
int	getObjStreamNumber()
long	getOffset() Gets refersTo object offset in a document.
protected PdfReader	getReader() Gets a PdfReader associated with the document object belongs to.
PdfObject	getRefersTo()
PdfObject	getRefersTo(boolean recursively) Gets direct object and try to resolve indirects chain.
byte	getType() Gets object type.
protected PdfWriter	getWriter() Gets a PdfWriter associated with the document object belongs to.
int	hashCode()
protected boolean	isFree()
protected PdfObject	newInstance() Creates new instance of object.
void	setFree() Releases indirect reference from the document.
protected void	setRefersTo(PdfObject refersTo)
protected PdfIndirectReference	setState(short state) Sets special states of current object.
String	toString()

Methods inherited from class com.itextpdf.kernel.pdf.PdfObject

checkState, clearState, clone, copyTo, copyTo, flush, flush, getIndirectReference, isArray, isBoolean, isDictionary, isFlushed, isIndirect, isIndirectReference, isLiteral, isModified, isName, isNull, isNumber, isStream, isString, makeIndirect, makeIndirect, release, setIndirectReference, setModified

Methods inherited from class java.lang.Object

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

Field Detail

objNr

protected final int objNr

Object number.

genNr

protected int genNr

Object generation.

refersTo

protected PdfObject refersTo

PdfObject that current PdfIndirectReference instance refers to.

objectStreamNumber

protected int objectStreamNumber

Indirect reference number of object stream containing refersTo object. If refersTo is not placed into object stream - objectStreamNumber = 0.

offsetOrIndex

protected long offsetOrIndex

Offset in a document of the refersTo object. If the object placed into object stream then it is an object index inside object stream.

pdfDocument

protected PdfDocument pdfDocument

PdfDocument object belongs to. For direct objects it is null.

Constructor Detail

PdfIndirectReference

protected PdfIndirectReference(PdfDocument doc,
                               int objNr)

PdfIndirectReference

protected PdfIndirectReference(PdfDocument doc,
                               int objNr,
                               int genNr)

PdfIndirectReference

protected PdfIndirectReference(PdfDocument doc,
                               int objNr,
                               int genNr,
                               long offset)

Method Detail

getObjNumber

public int getObjNumber()

getGenNumber

public int getGenNumber()

getRefersTo

public PdfObject getRefersTo()

getRefersTo

public PdfObject getRefersTo(boolean recursively)

Gets direct object and try to resolve indirects chain.

Note: If chain of references has length of more than 32, this method return 31st reference in chain.

setRefersTo

protected void setRefersTo(PdfObject refersTo)

getObjStreamNumber

public int getObjStreamNumber()

getOffset

public long getOffset()

Gets refersTo object offset in a document.

Returns:

object offset in a document. If refersTo object is in object stream then -1.

getIndex

public int getIndex()

Gets refersTo object index in the object stream.

Returns:

object index in a document. If refersTo object is not in object stream then -1.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

compareTo

public int compareTo(PdfIndirectReference o)

Specified by:

compareTo in interface Comparable<PdfIndirectReference>

getType

public byte getType()

Description copied from class: PdfObject

Gets object type.

Specified by:

getType in class PdfObject

Returns:

object type.

getDocument

public PdfDocument getDocument()

setFree

public void setFree()

Releases indirect reference from the document. Remove link to the referenced indirect object.

Note: Be careful when using this method. Do not use this method for wrapper objects, it can be cause of errors. Free indirect reference could be reused for a new indirect object.

toString

public String toString()

Overrides:

toString in class Object

getWriter

protected PdfWriter getWriter()

Gets a PdfWriter associated with the document object belongs to.

Returns:

PdfWriter.

getReader

protected PdfReader getReader()

Gets a PdfReader associated with the document object belongs to.

Returns:

PdfReader.

isFree

protected boolean isFree()

newInstance

protected PdfObject newInstance()

Description copied from class: PdfObject

Creates new instance of object.

Specified by:

newInstance in class PdfObject

Returns:

new instance of object.

copyContent

protected void copyContent(PdfObject from,
                           PdfDocument document)

Description copied from class: PdfObject

Copies object content from object 'from'.

Overrides:

copyContent in class PdfObject

Parameters:

from - object to copy content from.

document - document to copy object to.

setState

protected PdfIndirectReference setState(short state)

Sets special states of current object.

Overrides:

setState in class PdfObject

Parameters:

state - special flag of current object