package org.andengine.util; import java.io.BufferedReader; import java.io.ByteArrayOutputStream; import java.io.Closeable; import java.io.IOException; import java.io.InputStream; import java.io.InputStreamReader; import java.io.OutputStream; import java.io.Reader; import java.io.StringWriter; import java.io.Writer; import java.nio.ByteBuffer; /** * (c) 2010 Nicolas Gramlich * (c) 2011 Zynga Inc. * * @author Nicolas Gramlich * @since 15:48:56 - 03.09.2009 */ public final class StreamUtils { // =========================================================== // Constants // =========================================================== public static final int IO_BUFFER_SIZE = 8 * 1024; private static final int END_OF_STREAM = -1; // =========================================================== // Fields // =========================================================== // =========================================================== // Constructors // =========================================================== // =========================================================== // Getter & Setter // =========================================================== // =========================================================== // Methods from SuperClass/Interfaces // =========================================================== // =========================================================== // Methods // =========================================================== public static final String readFully(final InputStream pInputStream) throws IOException { final StringWriter writer = new StringWriter(); final char[] buf = new char[StreamUtils.IO_BUFFER_SIZE]; try { final Reader reader = new BufferedReader(new InputStreamReader(pInputStream, "UTF-8")); int read; while((read = reader.read(buf)) != StreamUtils.END_OF_STREAM) { writer.write(buf, 0, read); } } finally { StreamUtils.close(pInputStream); } return writer.toString(); } public static final byte[] streamToBytes(final InputStream pInputStream) throws IOException { return StreamUtils.streamToBytes(pInputStream, StreamUtils.END_OF_STREAM); } public static final byte[] streamToBytes(final InputStream pInputStream, final int pReadLimit) throws IOException { final ByteArrayOutputStream os = new ByteArrayOutputStream((pReadLimit == StreamUtils.END_OF_STREAM) ? StreamUtils.IO_BUFFER_SIZE : pReadLimit); StreamUtils.copy(pInputStream, os, pReadLimit); return os.toByteArray(); } /** * @see {@link StreamUtils#streamToBytes(InputStream, int, byte[], int)} */ public static final void streamToBytes(final InputStream pInputStream, final int pByteLimit, final byte[] pData) throws IOException { StreamUtils.streamToBytes(pInputStream, pByteLimit, pData, 0); } /** * @param pInputStream the sources of the bytes. * @param pByteLimit the amount of bytes to read. * @param pData the array to place the read bytes in. * @param pOffset the offset within pData. * @throws IOException */ public static final void streamToBytes(final InputStream pInputStream, final int pByteLimit, final byte[] pData, final int pOffset) throws IOException { if(pByteLimit > pData.length - pOffset) { throw new IOException("pData is not big enough."); } int pBytesLeftToRead = pByteLimit; int readTotal = 0; int read; while((read = pInputStream.read(pData, pOffset + readTotal, pBytesLeftToRead)) != StreamUtils.END_OF_STREAM) { readTotal += read; if(pBytesLeftToRead > read) { pBytesLeftToRead -= read; } else { break; } } if(readTotal != pByteLimit) { throw new IOException("ReadLimit: '" + pByteLimit + "', Read: '" + readTotal + "'."); } } public static final void copy(final InputStream pInputStream, final OutputStream pOutputStream) throws IOException { StreamUtils.copy(pInputStream, pOutputStream, StreamUtils.END_OF_STREAM); } public static final void copy(final InputStream pInputStream, final byte[] pData) throws IOException { int dataOffset = 0; final byte[] buf = new byte[StreamUtils.IO_BUFFER_SIZE]; int read; while((read = pInputStream.read(buf)) != StreamUtils.END_OF_STREAM) { System.arraycopy(buf, 0, pData, dataOffset, read); dataOffset += read; } } public static final void copy(final InputStream pInputStream, final ByteBuffer pByteBuffer) throws IOException { final byte[] buf = new byte[StreamUtils.IO_BUFFER_SIZE]; int read; while((read = pInputStream.read(buf)) != StreamUtils.END_OF_STREAM) { pByteBuffer.put(buf, 0, read); } } /** * Copy the content of the input stream into the output stream, using a temporary * byte array buffer whose size is defined by {@link #IO_BUFFER_SIZE}. * * @param pInputStream The input stream to copy from. * @param pOutputStream The output stream to copy to. * @param pByteLimit not more than so much bytes to read, or unlimited if {@link StreamUtils#END_OF_STREAM}. * * @throws IOException If any error occurs during the copy. */ public static final void copy(final InputStream pInputStream, final OutputStream pOutputStream, final int pByteLimit) throws IOException { if(pByteLimit == StreamUtils.END_OF_STREAM) { final byte[] buf = new byte[StreamUtils.IO_BUFFER_SIZE]; int read; while((read = pInputStream.read(buf)) != StreamUtils.END_OF_STREAM) { pOutputStream.write(buf, 0, read); } } else { final byte[] buf = new byte[StreamUtils.IO_BUFFER_SIZE]; final int bufferReadLimit = Math.min(pByteLimit, StreamUtils.IO_BUFFER_SIZE); long pBytesLeftToRead = pByteLimit; int read; while((read = pInputStream.read(buf, 0, bufferReadLimit)) != StreamUtils.END_OF_STREAM) { if(pBytesLeftToRead > read) { pOutputStream.write(buf, 0, read); pBytesLeftToRead -= read; } else { pOutputStream.write(buf, 0, (int) pBytesLeftToRead); break; } } } pOutputStream.flush(); } public static final boolean copyAndClose(final InputStream pInputStream, final OutputStream pOutputStream) { try { StreamUtils.copy(pInputStream, pOutputStream, StreamUtils.END_OF_STREAM); return true; } catch (final IOException e) { return false; } finally { StreamUtils.close(pInputStream); StreamUtils.close(pOutputStream); } } /** * Closes the specified stream. * * @param pCloseable The stream to close. */ public static final void close(final Closeable pCloseable) { if(pCloseable != null) { try { pCloseable.close(); } catch (final IOException e) { e.printStackTrace(); } } } /** * Flushes and closes the specified stream. * * @param pOutputStream The stream to close. */ public static final void flushCloseStream(final OutputStream pOutputStream) { if(pOutputStream != null) { try { pOutputStream.flush(); } catch (final IOException e) { e.printStackTrace(); } finally { StreamUtils.close(pOutputStream); } } } /** * Flushes and closes the specified stream. * * @param pWriter The Writer to close. */ public static final void flushCloseWriter(final Writer pWriter) { if(pWriter != null) { try { pWriter.flush(); } catch (final IOException e) { e.printStackTrace(); } finally { StreamUtils.close(pWriter); } } } // =========================================================== // Inner and Anonymous Classes // =========================================================== }