at.gv.egiz.pdfas.framework.input
Interface DataSource

All Known Subinterfaces:
PdfDataSource, TextDataSource
All Known Implementing Classes:
ByteArrayPdfDataSourceImpl, CompoundPdfDataSourceImpl, DelimitedPdfDataSource, FileBasedPdfDataSourceImpl, FileBasedTextDataSourceImpl, PdfDataSourceAdapter, TextDataSourceImpl

public interface DataSource

The input document data source.

Usually this is a PdfDataSource, but it may be a TextDataSource as well.

Author:
wprinz

Method Summary
 InputStream createInputStream()
          Creates a new InputStream that allows to read out the document's binary data from the beginning.
 byte[] getAsByteArray()
          Returns the data of this DataSource as a byte array.
 int getLength()
          Returns the length (number of bytes) of the stream.
 

Method Detail

createInputStream

public InputStream createInputStream()
Creates a new InputStream that allows to read out the document's binary data from the beginning.

Returns:
Returns the InputStream with the binary data.

getLength

public int getLength()
Returns the length (number of bytes) of the stream.

Returns:
Returns the length (number of bytes) of the stream.

getAsByteArray

public byte[] getAsByteArray()
Returns the data of this DataSource as a byte array.

Calling this method indicates that you need a byte array for random read access. The DataSource implementation should of course cache this byte array to avoid too much memory usage.

Performance analysis has shown that the libraries internally convert the streams to byte arrays and that file system access is very slow.

Returns:


Copyright © 2006-2010. All Rights Reserved.