nl.nn.adapterframework.util

Class StreamUtil

java.lang.Object

nl.nn.adapterframework.util.StreamUtil

public class StreamUtil
extends Object

Functions to read and write from one stream to another.

Author:

Gerrit van Brakel

Field Summary

Fields

Modifier and Type	Field and Description
static String	AUTO_DETECT_CHARSET
static int	BUFFERSIZE
static Charset	DEFAULT_CHARSET
static String	DEFAULT_INPUT_STREAM_ENCODING
protected static org.apache.logging.log4j.Logger	log

Constructor Summary

Constructors

Constructor and Description
StreamUtil()

Method Summary

Modifier and Type	Method and Description
static void	copyReaderToWriter(Reader reader, Writer writer, int chunkSize)
static void	copyStream(InputStream in, OutputStream out, int chunkSize)
static InputStream	dontClose(InputStream stream)
static OutputStream	dontClose(OutputStream stream)
static Reader	dontClose(Reader reader)
static void	fileToStream(String filename, OutputStream output) Copies the content of the specified file to an output stream.
static String	fileToString(String fileName, String endOfLineString) Deprecated.
static String	fileToString(String fileName, String endOfLineString, boolean xmlEncode) Deprecated.
static Reader	getCharsetDetectingInputStreamReader(InputStream inputStream) Return a Reader that reads the InputStream in the character set specified by the BOM.
static Reader	getCharsetDetectingInputStreamReader(InputStream inputStream, String defaultCharset) Return a Reader that reads the InputStream in the character set specified by the BOM.
static InputStream	onClose(InputStream stream, ThrowingRunnable<IOException> onClose)
static Reader	onClose(Reader reader, ThrowingRunnable<IOException> onClose)
static String	readerToString(Reader reader, String endOfLineString)
static String	readerToString(Reader reader, String endOfLineString, boolean xmlEncode) Copies the content of a reader into a string, adds specified string to the end of the line, if specified.
static void	readerToWriter(Reader reader, Writer writer) Copies the content of a reader to the buffer of a writer.
static String	resourceToString(URL resource)
static String	resourceToString(URL resource, String endOfLineString)
static String	resourceToString(URL resource, String endOfLineString, boolean xmlEncode)
static byte[]	streamToByteArray(InputStream inputStream, boolean skipBOM)
static byte[]	streamToBytes(InputStream inputStream) Writes the content of an input stream to a byte array.
static void	streamToFile(InputStream inputStream, File file) Writes the content of an input stream to a specified file.
static void	streamToStream(InputStream input, OutputStream output)
static void	streamToStream(InputStream input, OutputStream output, byte[] eof) Writes the content of an input stream to an output stream by copying the buffer of input stream to the buffer of the output stream.
static String	streamToString(InputStream stream)
static String	streamToString(InputStream stream, String streamEncoding)
static String	streamToString(InputStream stream, String endOfLineString, boolean xmlEncode)
static String	streamToString(InputStream stream, String endOfLineString, String streamEncoding)
static String	streamToString(InputStream stream, String endOfLineString, String streamEncoding, boolean xmlEncode)
static void	stringToFile(String string, String fileName) Writes the string to a file.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_CHARSET

public static final Charset DEFAULT_CHARSET

DEFAULT_INPUT_STREAM_ENCODING

public static final String DEFAULT_INPUT_STREAM_ENCODING

AUTO_DETECT_CHARSET

public static final String AUTO_DETECT_CHARSET

See Also:

Constant Field Values

BUFFERSIZE

public static final int BUFFERSIZE

See Also:

Constant Field Values

log

protected static org.apache.logging.log4j.Logger log

Constructor Detail

StreamUtil

public StreamUtil()

Method Detail

dontClose

public static InputStream dontClose(InputStream stream)

dontClose

public static Reader dontClose(Reader reader)

dontClose

public static OutputStream dontClose(OutputStream stream)

readerToString

public static String readerToString(Reader reader,
                                    String endOfLineString)
                             throws IOException

Throws:

IOException

streamToString

public static String streamToString(InputStream stream,
                                    String endOfLineString,
                                    String streamEncoding)
                             throws IOException

Throws:

IOException

streamToByteArray

public static byte[] streamToByteArray(InputStream inputStream,
                                       boolean skipBOM)
                                throws IOException

Throws:

IOException

getCharsetDetectingInputStreamReader

public static Reader getCharsetDetectingInputStreamReader(InputStream inputStream)
                                                   throws IOException

Return a Reader that reads the InputStream in the character set specified by the BOM. If no BOM is found, the default character set UTF-8 is used.

Throws:

IOException

getCharsetDetectingInputStreamReader

public static Reader getCharsetDetectingInputStreamReader(InputStream inputStream,
                                                          String defaultCharset)
                                                   throws IOException

Return a Reader that reads the InputStream in the character set specified by the BOM. If no BOM is found, a default character set is used.

Throws:

IOException

copyStream

public static void copyStream(InputStream in,
                              OutputStream out,
                              int chunkSize)
                       throws IOException

Throws:

IOException

copyReaderToWriter

public static void copyReaderToWriter(Reader reader,
                                      Writer writer,
                                      int chunkSize)
                               throws IOException

Throws:

IOException

onClose

public static InputStream onClose(InputStream stream,
                                  ThrowingRunnable<IOException> onClose)

onClose

public static Reader onClose(Reader reader,
                             ThrowingRunnable<IOException> onClose)

fileToStream

public static void fileToStream(String filename,
                                OutputStream output)
                         throws IOException

Copies the content of the specified file to an output stream.

Example:

         OutputStream os = new ByteArrayOutputStream
         Misc.fileToStream(someFileName, os);
         System.out.println(os.toString) // prints the content of the output stream
                                           // that's copied from the file.
     

Throws:

IOException - exception to be thrown if an I/O exception occurs

streamToStream

public static void streamToStream(InputStream input,
                                  OutputStream output)
                           throws IOException

Throws:

IOException

streamToStream

public static void streamToStream(InputStream input,
                                  OutputStream output,
                                  byte[] eof)
                           throws IOException

Writes the content of an input stream to an output stream by copying the buffer of input stream to the buffer of the output stream. If eof is specified, appends the eof(could represent a new line) to the outputstream Closes the input stream if specified.

Example:

         String test = "test";
         ByteArrayInputStream bais = new ByteArrayInputStream(test.getBytes());
         OutputStream baos = new ByteArrayOutputStream();
         Misc.streamToStream(bais, baos);
         System.out.println(baos.toString()); // prints "test"
     

Throws:

IOException - exception to be thrown if an I/O exception occurs

streamToFile

public static void streamToFile(InputStream inputStream,
                                File file)
                         throws IOException

Writes the content of an input stream to a specified file.

Example:

         String test = "test";
         ByteArrayInputStream bais = new ByteArrayInputStream(test.getBytes());
         Misc.streamToFile(bais, file); // "test" copied inside the file.
     

Throws:

IOException - exception to be thrown if an I/O exception occurs

streamToBytes

public static byte[] streamToBytes(InputStream inputStream)
                            throws IOException

Writes the content of an input stream to a byte array.

Example:

         String test = "test";
         ByteArrayInputStream bais = new ByteArrayInputStream(test.getBytes());
         byte[] arr = Misc.streamToBytes(bais);
         System.out.println(new String(arr, StandardCharsets.UTF_8)); // prints "test"
     

Throws:

IOException

readerToWriter

public static void readerToWriter(Reader reader,
                                  Writer writer)
                           throws IOException

Copies the content of a reader to the buffer of a writer.

Example:

         Reader reader = new StringReader("test");
         Writer writer = new StringWriter();
         Misc.readerToWriter(reader, writer, true);
         System.out.println(writer.toString)); // prints "test"
     

Throws:

IOException

fileToString

@Deprecated
public static String fileToString(String fileName,
                                              String endOfLineString)
                                       throws IOException

Deprecated.

Please consider using resourceToString() instead of relying on files.

Throws:

IOException

fileToString

@Deprecated
public static String fileToString(String fileName,
                                              String endOfLineString,
                                              boolean xmlEncode)
                                       throws IOException

Deprecated.

Please consider using resourceToString() instead of relying on files.

Throws:

IOException

readerToString

public static String readerToString(Reader reader,
                                    String endOfLineString,
                                    boolean xmlEncode)
                             throws IOException

Copies the content of a reader into a string, adds specified string to the end of the line, if specified.

Example:

         Reader r = new StringReader(" WeAreFrank' \n";
         String s = Misc.readerToString(r, "!!", true);
         System.out.println(s);
         // prints "<root> WeAreFrank!!</root>"
     

Parameters:

xmlEncode - if set to true, applies XML encodings to the content of the reader

Throws:

IOException

streamToString

public static String streamToString(InputStream stream)
                             throws IOException

Returns:

String that's included in the stream

Throws:

IOException

See Also:

streamToString(InputStream, String, boolean)

streamToString

public static String streamToString(InputStream stream,
                                    String streamEncoding)
                             throws IOException

Throws:

IOException

See Also:

streamToString(InputStream, String, String, boolean)

streamToString

public static String streamToString(InputStream stream,
                                    String endOfLineString,
                                    boolean xmlEncode)
                             throws IOException

Throws:

IOException

See Also:

streamToString(InputStream, String, String, boolean)

streamToString

public static String streamToString(InputStream stream,
                                    String endOfLineString,
                                    String streamEncoding,
                                    boolean xmlEncode)
                             throws IOException

Throws:

IOException

See Also:

readerToString(Reader, String, boolean)

resourceToString

public static String resourceToString(URL resource,
                                      String endOfLineString,
                                      boolean xmlEncode)
                               throws IOException

Throws:

IOException

See Also:

streamToString(InputStream, String, boolean)

resourceToString

public static String resourceToString(URL resource)
                               throws IOException

Throws:

IOException

See Also:

streamToString(InputStream, String, boolean)

resourceToString

public static String resourceToString(URL resource,
                                      String endOfLineString)
                               throws IOException

Throws:

IOException

See Also:

streamToString(InputStream, String, boolean)

stringToFile

public static void stringToFile(String string,
                                String fileName)
                         throws IOException

Writes the string to a file.

Throws:

IOException