iText kernel.jar Source Code
kernel.jar is a component in iText Java library to provide low-level functionalities.
iText Java library allows you to generate and manage PDF documents.
The Source Code files are provided together with the JAR file in the binary packge like iText7-Core-7.1.4.zip. You can download it at iText 7 Core Download site.
You can compile it to generate your JAR file, using kernel.pom as the build configuration file.
The source code of kernel-7.1.4.jar is provided below:
✍: FYIcenter.com
⏎ com/itextpdf/kernel/pdf/PdfStream.java
/*
This file is part of the iText (R) project.
Copyright (c) 1998-2018 iText Group NV
Authors: Bruno Lowagie, Paulo Soares, et al.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License version 3
as published by the Free Software Foundation with the addition of the
following permission added to Section 15 as permitted in Section 7(a):
FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
ITEXT GROUP. ITEXT GROUP DISCLAIMS THE WARRANTY OF NON INFRINGEMENT
OF THIRD PARTY RIGHTS
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program; if not, see http://www.gnu.org/licenses or write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA, 02110-1301 USA, or download the license from the following URL:
http://itextpdf.com/terms-of-use/
The interactive user interfaces in modified source and object code versions
of this program must display Appropriate Legal Notices, as required under
Section 5 of the GNU Affero General Public License.
In accordance with Section 7(b) of the GNU Affero General Public License,
a covered work must retain the producer line in every PDF that is created
or manipulated using iText.
You can be released from the requirements of the license by purchasing
a commercial license. Buying such a license is mandatory as soon as you
develop commercial activities involving the iText software without
disclosing the source code of your own applications.
These activities include: offering paid services to customers as an ASP,
serving PDFs on the fly in a web application, shipping iText with a closed
source product.
For more information, please contact iText Software Corp. at this
address: sales@itextpdf.com
*/
package com.itextpdf.kernel.pdf;
import com.itextpdf.io.LogMessageConstant;
import com.itextpdf.io.source.ByteArrayOutputStream;
import com.itextpdf.kernel.PdfException;
import org.slf4j.LoggerFactory;
import java.io.IOException;
import java.io.InputStream;
import java.io.ObjectOutputStream;
import java.io.Serializable;
/**
* Representation of a stream as described in the PDF Specification.
*/
public class PdfStream extends PdfDictionary {
private static final long serialVersionUID = -8259929152054328141L;
protected int compressionLevel;
// Output stream associated with PDF stream.
protected PdfOutputStream outputStream;
private InputStream inputStream;
private long offset;
private int length = -1;
/**
* Constructs a {@code PdfStream}-object.
*
* @param bytes initial content of {@link PdfOutputStream}.
* @param compressionLevel the compression level (0 = best speed, 9 = best compression, -1 is default)
*/
public PdfStream(byte[] bytes, int compressionLevel) {
super();
setState(MUST_BE_INDIRECT);
this.compressionLevel = compressionLevel;
if (bytes != null && bytes.length > 0) {
this.outputStream = new PdfOutputStream(new ByteArrayOutputStream(bytes.length));
this.outputStream.writeBytes(bytes);
} else {
this.outputStream = new PdfOutputStream(new ByteArrayOutputStream());
}
}
/**
* Creates a PdfStream instance.
*
* @param bytes bytes to write to the PdfStream
*/
public PdfStream(byte[] bytes) {
this(bytes, CompressionConstants.UNDEFINED_COMPRESSION);
}
/**
* Creates an efficient stream. No temporary array is ever created. The {@code InputStream}
* is totally consumed but is not closed. The general usage is:
* <br>
* <pre>
* PdfDocument document = ?;
* InputStream in = ?;
* PdfStream stream = new PdfStream(document, in, PdfOutputStream.DEFAULT_COMPRESSION);
* ?
* stream.flush();
* in.close();
* </pre>
*
* @param inputStream the data to write to this stream
* @param compressionLevel the compression level (0 = best speed, 9 = best compression, -1 is default)
*/
public PdfStream(PdfDocument doc, InputStream inputStream, int compressionLevel) {
super();
if (doc == null) {
throw new PdfException(PdfException.CannotCreatePdfStreamByInputStreamWithoutPdfDocument);
}
makeIndirect(doc);
if (inputStream == null) {
throw new IllegalArgumentException("The input stream in PdfStream constructor can not be null.");
}
this.inputStream = inputStream;
this.compressionLevel = compressionLevel;
put(PdfName.Length, new PdfNumber(-1).makeIndirect(doc));
}
/**
* Creates an efficient stream. No temporary array is ever created. The {@code InputStream}
* is totally consumed but is not closed. The general usage is:
* <br>
* <pre>
* PdfDocument document = ?;
* InputStream in = ?;
* PdfStream stream = new PdfStream(document, in);
* stream.flush();
* in.close();
* </pre>
*
* @param inputStream the data to write to this stream
*/
public PdfStream(PdfDocument doc, InputStream inputStream) {
this(doc, inputStream, CompressionConstants.UNDEFINED_COMPRESSION);
}
/**
* Constructs a {@code PdfStream}-object.
*
* @param compressionLevel the compression level (0 = best speed, 9 = best compression, -1 is default)
*/
public PdfStream(int compressionLevel) {
this(null, compressionLevel);
}
/**
* Creates an empty PdfStream instance.
*/
public PdfStream() {
this((byte[]) null);
}
protected PdfStream(java.io.OutputStream outputStream) {
this.outputStream = new PdfOutputStream(outputStream);
this.compressionLevel = CompressionConstants.UNDEFINED_COMPRESSION;
setState(MUST_BE_INDIRECT);
}
//NOTE This constructor only for PdfReader.
PdfStream(long offset, PdfDictionary keys) {
super();
this.compressionLevel = CompressionConstants.UNDEFINED_COMPRESSION;
this.offset = offset;
putAll(keys);
PdfNumber length = getAsNumber(PdfName.Length);
if (length == null) {
this.length = 0;
} else {
this.length = length.intValue();
}
}
/**
* Gets output stream.
*
* @return output stream
*/
public PdfOutputStream getOutputStream() {
return outputStream;
}
/**
* Gets compression level of this PdfStream.
* For more details @see {@link java.util.zip.Deflater}.
*
* @return compression level.
*/
public int getCompressionLevel() {
return compressionLevel;
}
/**
* Sets compression level of this PdfStream.
* For more details @see {@link java.util.zip.Deflater}.
*
* @param compressionLevel the compression level (0 = best speed, 9 = best compression, -1 is default)
*/
public void setCompressionLevel(int compressionLevel) {
this.compressionLevel = compressionLevel;
}
@Override
public byte getType() {
return STREAM;
}
public int getLength() {
return length;
}
/**
* Gets decoded stream bytes.
*
* @return byte[]
*/
public byte[] getBytes() {
return getBytes(true);
}
/**
* Gets stream bytes.
*
* @param decoded true if to get decoded stream bytes, otherwise false.
* @return byte content of the {@code PdfStream}. Byte content will be {@code null},
* if the {@code PdfStream} was created by {@code InputStream}.
*/
public byte[] getBytes(boolean decoded) {
if (isFlushed()) {
throw new PdfException(PdfException.CannotOperateWithFlushedPdfStream);
}
if (inputStream != null) {
LoggerFactory.getLogger(PdfStream.class).warn("PdfStream was created by InputStream." +
"getBytes() always returns null in this case");
return null;
}
byte[] bytes = null;
if (outputStream != null && outputStream.getOutputStream() != null) {
assert outputStream.getOutputStream() instanceof ByteArrayOutputStream
: "Invalid OutputStream: ByteArrayByteArrayOutputStream expected";
try {
outputStream.getOutputStream().flush();
bytes = ((ByteArrayOutputStream) outputStream.getOutputStream()).toByteArray();
if (decoded && containsKey(PdfName.Filter)) {
bytes = PdfReader.decodeBytes(bytes, this);
}
} catch (IOException ioe) {
throw new PdfException(PdfException.CannotGetPdfStreamBytes, ioe, this);
}
} else if (getIndirectReference() != null) {
// This logic makes sense only for the case when PdfStream was created by reader and in this
// case PdfStream instance always has indirect reference and is never in the MustBeIndirect state
PdfReader reader = getIndirectReference().getReader();
if (reader != null) {
try {
bytes = reader.readStreamBytes(this, decoded);
} catch (IOException ioe) {
throw new PdfException(PdfException.CannotGetPdfStreamBytes, ioe, this);
}
}
}
return bytes;
}
/**
* Sets <code>bytes</code> as stream's content.
* Could not be used with streams which were created by <code>InputStream</code>.
*
* @param bytes new content for stream; if <code>null</code> then stream's content will be discarded
*/
public void setData(byte[] bytes) {
setData(bytes, false);
}
/**
* Sets or appends <code>bytes</code> to stream content.
* Could not be used with streams which were created by <code>InputStream</code>.
*
* @param bytes New content for stream. These bytes are considered to be a raw data (i.e. not encoded/compressed/encrypted)
* and if it's not true, the corresponding filters shall be set to the PdfStream object manually.
* Data compression generally should be configured via {@link PdfStream#setCompressionLevel} and
* is handled on stream writing to the output document.
* If <code>null</code> and <code>append</code> is false then stream's content will be discarded.
* @param append If set to true then <code>bytes</code> will be appended to the end,
* rather then replace original content. The original content will be decoded if needed.
*/
public void setData(byte[] bytes, boolean append) {
if (isFlushed()) {
throw new PdfException(PdfException.CannotOperateWithFlushedPdfStream);
}
if (inputStream != null) {
throw new PdfException(PdfException.CannotSetDataToPdfStreamWhichWasCreatedByInputStream);
}
boolean outputStreamIsUninitialized = outputStream == null;
if (outputStreamIsUninitialized) {
outputStream = new PdfOutputStream(new ByteArrayOutputStream());
}
if (append) {
if (outputStreamIsUninitialized && getIndirectReference() != null && getIndirectReference().getReader() != null
|| !outputStreamIsUninitialized && containsKey(PdfName.Filter)) {
// here is the same as in the getBytes() method: this logic makes sense only when stream is created
// by reader and in this case indirect reference won't be null and stream is not in the MustBeIndirect state.
byte[] oldBytes;
try {
oldBytes = getBytes();
} catch (PdfException ex) {
throw new PdfException(PdfException.CannotReadAStreamInOrderToAppendNewBytes, ex);
}
outputStream.assignBytes(oldBytes, oldBytes.length);
}
if (bytes != null) {
outputStream.writeBytes(bytes);
}
} else {
if (bytes != null) {
outputStream.assignBytes(bytes, bytes.length);
} else {
outputStream.reset();
}
}
offset = 0;
// Bytes that are set shall be not encoded, and moreover the existing bytes in cases of the appending are decoded,
// therefore all filters shall be removed. Compression will be handled on stream flushing.
remove(PdfName.Filter);
remove(PdfName.DecodeParms);
}
@Override
protected PdfObject newInstance() {
return new PdfStream();
}
protected long getOffset() {
return offset;
}
/**
* Update length manually in case its correction.
* @see com.itextpdf.kernel.pdf.PdfReader#checkPdfStreamLength(PdfStream)
*/
protected void updateLength(int length) {
this.length = length;
}
@Override
protected void copyContent(PdfObject from, PdfDocument document) {
super.copyContent(from, document);
PdfStream stream = (PdfStream) from;
assert inputStream == null : "Try to copy the PdfStream that has been just created.";
byte[] bytes = stream.getBytes(false);
try {
outputStream.write(bytes);
} catch (IOException ioe) {
throw new PdfException(PdfException.CannotCopyObjectContent, ioe, stream);
}
}
protected void initOutputStream(java.io.OutputStream stream) {
if (getOutputStream() == null && inputStream == null)
outputStream = new PdfOutputStream(stream != null ? stream : new ByteArrayOutputStream());
}
/**
* Release content of PdfStream.
*/
protected void releaseContent() {
super.releaseContent();
try {
if (outputStream != null) {
outputStream.close();
outputStream = null;
}
} catch (IOException e) {
throw new PdfException(PdfException.IoException, e);
}
}
protected InputStream getInputStream() {
return inputStream;
}
private void writeObject(ObjectOutputStream out) throws IOException {
if (inputStream == null || inputStream instanceof Serializable) {
out.defaultWriteObject();
} else {
InputStream backup = inputStream;
inputStream = null;
LoggerFactory.getLogger(getClass()).warn(LogMessageConstant.INPUT_STREAM_CONTENT_IS_LOST_ON_PDFSTREAM_SERIALIZATION);
inputStream = backup;
}
}
}
⏎ com/itextpdf/kernel/pdf/PdfStream.java
Or download all of them as a single archive file:
File name: kernel-7.1.4-sources.jar File size: 1201221 bytes Release date: 2018-10-09 Download
⇐ Download and Install iText7-Core-7.1.4.zip
2010-02-18, 85608👍, 0💬
