X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=src%2Fbe%2Fnikiroo%2Futils%2FImage.java;h=58b1f5aeac05f71370365ac9c3a562f70f722797;hb=7194ac50b29064a013f177fc9cfc5aaa131a8ec4;hp=58c0e1019204ea2e3a35647754164b57653e7684;hpb=805005449dacb1e7b825db63836bf100e472ddd0;p=nikiroo-utils.git diff --git a/src/be/nikiroo/utils/Image.java b/src/be/nikiroo/utils/Image.java index 58c0e10..58b1f5a 100644 --- a/src/be/nikiroo/utils/Image.java +++ b/src/be/nikiroo/utils/Image.java @@ -1,15 +1,25 @@ package be.nikiroo.utils; +import java.io.ByteArrayInputStream; +import java.io.Closeable; +import java.io.File; import java.io.IOException; import java.io.InputStream; +import be.nikiroo.utils.streams.MarkableFileInputStream; + /** * This class represents an image data. * * @author niki */ -public class Image { - private byte[] data; +public class Image implements Closeable { + static private File tempRoot; + static private TempFiles tmpRepository; + static private long count = 0; + static private Object lock = new Object(); + + private File data; /** * Do not use -- for serialisation purposes only. @@ -25,54 +35,141 @@ public class Image { * the data */ public Image(byte[] data) { - this.data = data; + ByteArrayInputStream in = new ByteArrayInputStream(data); + try { + this.data = getTemporaryFile(); + IOUtils.write(in, this.data); + } catch (IOException e) { + throw new RuntimeException(e); + } finally { + try { + in.close(); + } catch (IOException e) { + throw new RuntimeException(e); + } + } } /** - * 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}. + *

+ * This {@link InputStream} will (always) be a new one, and you are + * responsible for it. + *

+ * Note: take care that the {@link InputStream} must not 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 { - this.data = IOUtils.toByteArray(in); + public InputStream newInputStream() throws IOException { + return new MarkableFileInputStream(data); } /** - * The actual image data. + * Read the actual image data, as a byte array. *

- * This is the actual data, not a copy, so any change made here will be - * reflected into the {@link Image} and vice-versa. + * Note: if possible, prefer the {@link Image#newInputStream()} method, as + * it can be more efficient. * * @return the image data */ public byte[] getData() { - return data; + try { + InputStream in = newInputStream(); + try { + return IOUtils.toByteArray(in); + } finally { + in.close(); + } + } catch (IOException e) { + throw new RuntimeException(e); + } } /** - * Convert the given {@link Image} object into a Base64 representation of - * the same {@link Image} object. + * Closing the {@link Image} will delete the associated temporary file on + * disk. + *

+ * Note that even if you don't, the program will still try to delete + * all the temporary files at JVM termination. + */ + @Override + public void close() throws IOException { + data.delete(); + synchronized (lock) { + count--; + if (count <= 0) { + count = 0; + tmpRepository.close(); + tmpRepository = null; + } + } + } + + @Override + protected void finalize() throws Throwable { + try { + close(); + } finally { + super.finalize(); + } + } + + /** + * Return a newly created temporary file to work on. + * + * @return the file + * + * @throws IOException + * in case of I/O error + */ + private File getTemporaryFile() throws IOException { + synchronized (lock) { + if (tmpRepository == null) { + tmpRepository = new TempFiles(tempRoot, "images"); + count = 0; + } + + count++; + + return tmpRepository.createTempFile("image"); + } + } + + /** + * Change the temporary root directory used by the program. + *

+ * Caution: the directory will be owned by the system, all its files + * now belong to us (and will most probably be deleted). + *

+ * Note: it may take some time until the new temporary root is used, we + * first need to make sure the previous one is not used anymore (i.e., we + * must reach a point where no unclosed {@link Image} remains in memory) to + * switch the temporary root. * - * @return the Base64 representation + * @param root + * the new temporary root, which will be owned by the + * system */ - public String toBase64() { - return new String(Base64.encodeBytes(getData())); + public static void setTemporaryFilesRoot(File root) { + tempRoot = root; } }