- java.lang.Object
-
- com.itextpdf.text.pdf.PdfObject
-
- Direct Known Subclasses:
PdfArray,PdfBoolean,PdfDictionary,PdfIndirectReference,PdfLiteral,PdfName,PdfNull,PdfNumber,PdfString
public abstract class PdfObject extends java.lang.ObjectPdfObjectis the abstract superclass of all PDF objects.PDF supports seven basic types of objects: Booleans, numbers, strings, names, arrays, dictionaries and streams. In addition, PDF provides a null object. Objects may be labeled so that they can be referred to by other objects.
All these basic PDF objects are described in the 'Portable Document Format Reference Manual version 1.3' Chapter 4 (pages 37-54).- See Also:
PdfNull,PdfBoolean,PdfNumber,PdfString,PdfName,PdfArray,PdfDictionary,PdfStream,PdfIndirectReference
-
-
Field Summary
Fields Modifier and Type Field Description static intARRAYA possible type ofPdfObjectstatic intBOOLEANA possible type ofPdfObjectprotected byte[]bytesThe content of thisPdfObjectstatic intDICTIONARYA possible type ofPdfObjectstatic intINDIRECTA possible type ofPdfObjectprotected PRIndirectReferenceindRefHolds the indirect reference.static intNAMEA possible type ofPdfObjectstatic java.lang.StringNOTHINGAn empty string used for thePdfNull-object and for an emptyPdfString-object.static intNULLA possible type ofPdfObjectstatic intNUMBERA possible type ofPdfObjectstatic intSTREAMA possible type ofPdfObjectstatic intSTRINGA possible type ofPdfObjectstatic java.lang.StringTEXT_PDFDOCENCODINGThis is the default encoding to be used for converting Strings into bytes and vice versa.static java.lang.StringTEXT_UNICODEThis is the encoding to be used to output text in Unicode.protected inttypeThe type of thisPdfObject
-
Constructor Summary
Constructors Modifier Constructor Description protectedPdfObject(int type)Constructs aPdfObjectof a certain type without any content.protectedPdfObject(int type, byte[] bytes)Constructs aPdfObjectof a certain type with a certain content.protectedPdfObject(int type, java.lang.String content)Constructs aPdfObjectof a certain type with a certain content.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description booleancanBeInObjStm()Whether this object can be contained in an object stream.byte[]getBytes()Gets the presentation of this object in a byte arrayPRIndirectReferencegetIndRef()Get the indirect referencebooleanisArray()Checks if thisPdfObjectis of the typePdfArray.booleanisBoolean()Checks if thisPdfObjectis of the typePdfBoolean.booleanisDictionary()Checks if thisPdfObjectis of the typePdfDictionary.booleanisIndirect()Checks if thisPdfObjectis of the typePdfIndirectObject.booleanisName()Checks if thisPdfObjectis of the typePdfName.booleanisNull()Checks if thisPdfObjectis of the typePdfNull.booleanisNumber()Checks if thisPdfObjectis of the typePdfNumber.booleanisStream()Checks if thisPdfObjectis of the typePdfStream.booleanisString()Checks if thisPdfObjectis of the typePdfString.intlength()Returns the length of the actual content of thePdfObject.protected voidsetContent(java.lang.String content)Changes the content of thisPdfObject.voidsetIndRef(PRIndirectReference indRef)Set the indirect referencevoidtoPdf(PdfWriter writer, java.io.OutputStream os)Writes the PDF representation of thisPdfObjectas an array ofbytes to the writer.java.lang.StringtoString()Returns theString-representation of thisPdfObject.inttype()Returns the type of thisPdfObject.
-
-
-
Field Detail
-
BOOLEAN
public static final int BOOLEAN
A possible type ofPdfObject- See Also:
- Constant Field Values
-
NUMBER
public static final int NUMBER
A possible type ofPdfObject- See Also:
- Constant Field Values
-
STRING
public static final int STRING
A possible type ofPdfObject- See Also:
- Constant Field Values
-
NAME
public static final int NAME
A possible type ofPdfObject- See Also:
- Constant Field Values
-
ARRAY
public static final int ARRAY
A possible type ofPdfObject- See Also:
- Constant Field Values
-
DICTIONARY
public static final int DICTIONARY
A possible type ofPdfObject- See Also:
- Constant Field Values
-
STREAM
public static final int STREAM
A possible type ofPdfObject- See Also:
- Constant Field Values
-
NULL
public static final int NULL
A possible type ofPdfObject- See Also:
- Constant Field Values
-
INDIRECT
public static final int INDIRECT
A possible type ofPdfObject- See Also:
- Constant Field Values
-
NOTHING
public static final java.lang.String NOTHING
An empty string used for thePdfNull-object and for an emptyPdfString-object.- See Also:
- Constant Field Values
-
TEXT_PDFDOCENCODING
public static final java.lang.String TEXT_PDFDOCENCODING
This is the default encoding to be used for converting Strings into bytes and vice versa. The default encoding is PdfDocEncoding.- See Also:
- Constant Field Values
-
TEXT_UNICODE
public static final java.lang.String TEXT_UNICODE
This is the encoding to be used to output text in Unicode.- See Also:
- Constant Field Values
-
bytes
protected byte[] bytes
The content of thisPdfObject
-
type
protected int type
The type of thisPdfObject
-
indRef
protected PRIndirectReference indRef
Holds the indirect reference.
-
-
Constructor Detail
-
PdfObject
protected PdfObject(int type)
Constructs aPdfObjectof a certain type without any content.- Parameters:
type- type of the newPdfObject
-
PdfObject
protected PdfObject(int type, java.lang.String content)Constructs aPdfObjectof a certain type with a certain content.- Parameters:
type- type of the newPdfObjectcontent- content of the newPdfObjectas aString.
-
PdfObject
protected PdfObject(int type, byte[] bytes)Constructs aPdfObjectof a certain type with a certain content.- Parameters:
type- type of the newPdfObjectbytes- content of the newPdfObjectas an array ofbyte.
-
-
Method Detail
-
toPdf
public void toPdf(PdfWriter writer, java.io.OutputStream os) throws java.io.IOException
Writes the PDF representation of thisPdfObjectas an array ofbytes to the writer.- Parameters:
writer- for backwards compatibilityos- TheOutputStreamto write the bytes to.- Throws:
java.io.IOException
-
toString
public java.lang.String toString()
Returns theString-representation of thisPdfObject.- Overrides:
toStringin classjava.lang.Object- Returns:
- a
String
-
getBytes
public byte[] getBytes()
Gets the presentation of this object in a byte array- Returns:
- a byte array
-
canBeInObjStm
public boolean canBeInObjStm()
Whether this object can be contained in an object stream. PdfObjects of type STREAM OR INDIRECT can not be contained in an object stream.- Returns:
trueif this object can be in an object stream. Otherwisefalse
-
length
public int length()
Returns the length of the actual content of thePdfObject.In some cases, namely for
PdfStringandPdfStream, this method differs from the methodpdfLengthbecausepdfLengthreturns the length of the PDF representation of the object, not of the actual content as does the methodlength.Remark: the actual content of an object is in some cases identical to its representation. The following statement is always true: length() >= pdfLength().
- Returns:
- The length as
int
-
setContent
protected void setContent(java.lang.String content)
Changes the content of thisPdfObject.- Parameters:
content- the new content of thisPdfObject
-
type
public int type()
Returns the type of thisPdfObject. May be either of: - NULL: APdfNull- BOOLEAN: APdfBoolean- NUMBER: APdfNumber- STRING: APdfString- NAME: APdfName- ARRAY: APdfArray- DICTIONARY: APdfDictionary- STREAM: APdfStream- INDIRECT: >PdfIndirectObject- Returns:
- The type
-
isNull
public boolean isNull()
Checks if thisPdfObjectis of the typePdfNull.- Returns:
trueorfalse
-
isBoolean
public boolean isBoolean()
Checks if thisPdfObjectis of the typePdfBoolean.- Returns:
trueorfalse
-
isNumber
public boolean isNumber()
Checks if thisPdfObjectis of the typePdfNumber.- Returns:
trueorfalse
-
isString
public boolean isString()
Checks if thisPdfObjectis of the typePdfString.- Returns:
trueorfalse
-
isName
public boolean isName()
Checks if thisPdfObjectis of the typePdfName.- Returns:
trueorfalse
-
isArray
public boolean isArray()
Checks if thisPdfObjectis of the typePdfArray.- Returns:
trueorfalse
-
isDictionary
public boolean isDictionary()
Checks if thisPdfObjectis of the typePdfDictionary.- Returns:
trueorfalse
-
isStream
public boolean isStream()
Checks if thisPdfObjectis of the typePdfStream.- Returns:
trueorfalse
-
isIndirect
public boolean isIndirect()
Checks if thisPdfObjectis of the typePdfIndirectObject.- Returns:
trueif this is an indirect object, otherwisefalse
-
getIndRef
public PRIndirectReference getIndRef()
Get the indirect reference- Returns:
- A
PdfIndirectReference
-
setIndRef
public void setIndRef(PRIndirectReference indRef)
Set the indirect reference- Parameters:
indRef- New value as aPdfIndirectReference
-
-