|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
public interface DataSource
Input document data source.
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).
| 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 for random read only access. |
String |
getCharacterEncoding()
Returns the character encoding of the data. |
int |
getLength()
Returns the length (number of bytes) of the stream. |
String |
getMimeType()
Returns the mime type of the data. |
| Method Detail |
|---|
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!
String getMimeType()
String getCharacterEncoding()
This makes only sense for character based mime types.
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||