import java.io.IOException;
import java.io.InputStream;
+import be.nikiroo.utils.streams.MarkableFileInputStream;
+
/**
* This class represents an image data.
*
}
/**
- * Create a new {@link Image} from its Base64 representation.
+ * Create a new {@link Image} from a stream.
*
- * @param base64
- * the {@link Image} in Base64 format
+ * @param in
+ * the stream
*
* @throws IOException
* in case of I/O error
*/
- public Image(String base64) throws IOException {
- this(Base64.decode(base64));
+ public Image(InputStream in) throws IOException {
+ data = getTemporaryFile();
+ IOUtils.write(in, data);
}
/**
- * Create a new {@link Image} from a stream.
+ * Generate an {@link InputStream} that you can {@link InputStream#reset()}
+ * for this {@link Image}.
+ * <p>
+ * This {@link InputStream} will (always) be a new one, and <b>you</b> are
+ * responsible for it.
+ * <p>
+ * Note: take care that the {@link InputStream} <b>must not</b> live past
+ * the {@link Image} life time!
*
- * @param in
- * the stream
+ * @return the stream
*
* @throws IOException
* in case of I/O error
*/
- public Image(InputStream in) throws IOException {
- data = getTemporaryFile();
- IOUtils.write(in, data);
+ public InputStream newInputStream() throws IOException {
+ return new MarkableFileInputStream(new FileInputStream(data));
}
/**
* <b>Read</b> the actual image data, as a byte array.
+ * <p>
+ * Note: if possible, prefer the {@link Image#newInputStream()} method, as
+ * it can be more efficient.
*
* @return the image data
*/
public byte[] getData() {
try {
- FileInputStream in = new FileInputStream(data);
+ InputStream in = newInputStream();
try {
return IOUtils.toByteArray(in);
} finally {
}
}
- /**
- * Convert the given {@link Image} object into a Base64 representation of
- * the same {@link Image} object.
- *
- * @return the Base64 representation
- */
- public String toBase64() {
- return Base64.encodeBytes(getData());
- }
-
/**
* Closing the {@link Image} will delete the associated temporary file on
* disk.