com.itextpdf.kernel.pdf

Class PdfWriter

java.lang.Object

java.io.OutputStream

com.itextpdf.io.source.OutputStream<PdfOutputStream>

com.itextpdf.kernel.pdf.PdfOutputStream

com.itextpdf.kernel.pdf.PdfWriter

All Implemented Interfaces:

Closeable, Flushable, Serializable, AutoCloseable

public class PdfWriter
extends PdfOutputStream
implements Serializable

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<Integer,PdfIndirectReference>	copiedObjects Is used to avoid duplications on object copying.
protected boolean	isUserWarnedAboutAcroFormCopying
protected WriterProperties	properties

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

crypto, document

Fields inherited from class com.itextpdf.io.source.OutputStream

closeStream, currentPos, outputStream

Constructor Summary

Constructors

Constructor and Description
PdfWriter(OutputStream os)
PdfWriter(OutputStream os, WriterProperties properties)
PdfWriter(String filename)
PdfWriter(String filename, WriterProperties properties)

Method Summary

Modifier and Type	Method and Description
protected static int	calculateIndRefKey(PdfIndirectReference indRef) Calculates hash code for the indirect reference taking into account the document it belongs to.
void	close()
protected PdfObject	copyObject(PdfObject obj, PdfDocument document, boolean allowDuplicating)
protected void	flushModifiedWaitingObjects() Flushes all modified objects which have not been flushed yet.
protected void	flushObject(PdfObject pdfObject, boolean canBeInObjStm) Flushes the object.
protected void	flushWaitingObjects() Flushes all objects which have not been flushed yet.
int	getCompressionLevel() Gets default compression level for @see PdfStream.
protected int	getCopyObjectKey(PdfObject obj) Deprecated. Functionality will be removed.
boolean	isFullCompression() Indicates if to use full compression mode.
PdfWriter	setCompressionLevel(int compressionLevel) Sets default compression level for @see PdfStream.
PdfWriter	setSmartMode(boolean smartMode) Sets the smart mode.
void	write(byte[] b)
void	write(byte[] b, int off, int len)
void	write(int b)
protected void	writeHeader() Writes PDF header.
protected void	writeToBody(PdfObject pdfObj) Writes object to body of PDF document.

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

checkEncryption, containsFlateFilter, decodeFlateBytes, updateCompressionFilter, write

Methods inherited from class com.itextpdf.io.source.OutputStream

assignBytes, flush, getCurrentPos, getHighPrecision, getOutputStream, isCloseStream, reset, setCloseStream, setHighPrecision, writeByte, writeByte, writeBytes, writeBytes, writeDouble, writeDouble, writeFloat, writeFloat, writeFloats, writeInteger, writeLong, writeNewLine, writeSpace, writeString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

properties

protected WriterProperties properties

copiedObjects

protected Map<Integer,PdfIndirectReference> copiedObjects

Is used to avoid duplications on object copying. It stores hashes of the indirect reference from the source document and the corresponding indirect references of the copied objects from the new document.

isUserWarnedAboutAcroFormCopying

protected boolean isUserWarnedAboutAcroFormCopying

Constructor Detail

PdfWriter

public PdfWriter(OutputStream os)

PdfWriter

public PdfWriter(OutputStream os,
                 WriterProperties properties)

PdfWriter

public PdfWriter(String filename)
          throws FileNotFoundException

Throws:

FileNotFoundException

PdfWriter

public PdfWriter(String filename,
                 WriterProperties properties)
          throws FileNotFoundException

Throws:

FileNotFoundException

Method Detail

isFullCompression

public boolean isFullCompression()

Indicates if to use full compression mode.

Returns:

true if to use full compression, false otherwise.

getCompressionLevel

public int getCompressionLevel()

Gets default compression level for @see PdfStream. For more details @see Deflater.

Returns:

compression level.

setCompressionLevel

public PdfWriter setCompressionLevel(int compressionLevel)

Sets default compression level for @see PdfStream. For more details @see Deflater.

Parameters:

compressionLevel - compression level.

setSmartMode

public PdfWriter setSmartMode(boolean smartMode)

Sets the smart mode.

In smart mode when resources (such as fonts, images,...) are encountered, a reference to these resources is saved in a cache, so that they can be reused. This requires more memory, but reduces the file size of the resulting PDF document.

write

public void write(int b)
           throws IOException

Overrides:

write in class OutputStream<PdfOutputStream>

Throws:

IOException

write

public void write(byte[] b)
           throws IOException

Overrides:

write in class OutputStream<PdfOutputStream>

Throws:

IOException

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException

Overrides:

write in class OutputStream<PdfOutputStream>

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class OutputStream<PdfOutputStream>

Throws:

IOException

flushObject

protected void flushObject(PdfObject pdfObject,
                           boolean canBeInObjStm)
                    throws IOException

Flushes the object. Override this method if you want to define custom behaviour for object flushing.

Parameters:

pdfObject - object to flush.

canBeInObjStm - indicates whether object can be placed into object stream.

Throws:

IOException - on error.

copyObject

protected PdfObject copyObject(PdfObject obj,
                               PdfDocument document,
                               boolean allowDuplicating)

writeToBody

protected void writeToBody(PdfObject pdfObj)
                    throws IOException

Writes object to body of PDF document.

Parameters:

pdfObj - object to write.

Throws:

IOException

writeHeader

protected void writeHeader()

Writes PDF header.

flushWaitingObjects

protected void flushWaitingObjects()

Flushes all objects which have not been flushed yet.

flushModifiedWaitingObjects

protected void flushModifiedWaitingObjects()

Flushes all modified objects which have not been flushed yet. Used in case incremental updates.

calculateIndRefKey

protected static int calculateIndRefKey(PdfIndirectReference indRef)

Calculates hash code for the indirect reference taking into account the document it belongs to.

Parameters:

indRef - object to be hashed.

Returns:

calculated hash code.

getCopyObjectKey

@Deprecated
protected int getCopyObjectKey(PdfObject obj)

Deprecated. Functionality will be removed.

Calculates hash code for object to be copied. The hash code and the copied object is the stored in @{link copiedObjects} hash map to avoid duplications.

Parameters:

obj - object to be copied.

Returns:

calculated hash code.