@Deprecated
public interface DataSource
This allows the holder of the data to decide how the data is to be stored (e.g. in a File or in a byte array).
Modifier and Type | Method and Description |
---|---|
java.io.InputStream |
createInputStream()
Deprecated.
Creates a new InputStream that allows to read out the document's binary
data from the beginning.
|
byte[] |
getAsByteArray()
Deprecated.
Returns the data of this DataSource as a byte array for random read only access.
|
java.lang.String |
getCharacterEncoding()
Deprecated.
Returns the character encoding of the data.
|
int |
getLength()
Deprecated.
Returns the length (number of bytes) of the stream.
|
java.lang.String |
getMimeType()
Deprecated.
Returns the mime type of the data.
|
java.io.InputStream createInputStream()
int getLength()
byte[] getAsByteArray()
Calling this method indicates that you need a byte array for random read only 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.
Never write to this byte array!
java.lang.String getMimeType()
java.lang.String getCharacterEncoding()
This makes only sense for character based mime types.