001: /*
002: * IOTools.java
003: * $Header: /home/cvs/jakarta-tomcat-4.0/catalina/src/share/org/apache/catalina/util/IOTools.java,v 1.1 2002/05/11 05:06:25 billbarker Exp $
004: * $Revision: 1.1 $
005: * $Date: 2002/05/11 05:06:25 $
006: *
007: * ====================================================================
008: *
009: * The Apache Software License, Version 1.1
010: *
011: * Copyright (c) 1999 The Apache Software Foundation. All rights
012: * reserved.
013: *
014: * Redistribution and use in source and binary forms, with or without
015: * modification, are permitted provided that the following conditions
016: * are met:
017: *
018: * 1. Redistributions of source code must retain the above copyright
019: * notice, this list of conditions and the following disclaimer.
020: *
021: * 2. Redistributions in binary form must reproduce the above copyright
022: * notice, this list of conditions and the following disclaimer in
023: * the documentation and/or other materials provided with the
024: * distribution.
025: *
026: * 3. The end-user documentation included with the redistribution, if
027: * any, must include the following acknowlegement:
028: * "This product includes software developed by the
029: * Apache Software Foundation (http://www.apache.org/)."
030: * Alternately, this acknowlegement may appear in the software itself,
031: * if and wherever such third-party acknowlegements normally appear.
032: *
033: * 4. The names "The Jakarta Project", "Tomcat", and "Apache Software
034: * Foundation" must not be used to endorse or promote products derived
035: * from this software without prior written permission. For written
036: * permission, please contact apache@apache.org.
037: *
038: * 5. Products derived from this software may not be called "Apache"
039: * nor may "Apache" appear in their names without prior written
040: * permission of the Apache Group.
041: *
042: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
043: * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
044: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
045: * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
046: * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
047: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
048: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
049: * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
050: * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
051: * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
052: * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
053: * SUCH DAMAGE.
054: * ====================================================================
055: *
056: * This software consists of voluntary contributions made by many
057: * individuals on behalf of the Apache Software Foundation. For more
058: * information on the Apache Software Foundation, please see
059: * <http://www.apache.org/>.
060: *
061: * [Additional notices, if required by prior licensing conditions]
062: *
063: */
064: package org.apache.catalina.util;
065:
066: import java.io.InputStream;
067: import java.io.IOException;
068: import java.io.OutputStream;
069: import java.io.Reader;
070: import java.io.Writer;
071:
072: /**
073: * Contains commonly needed I/O-related methods
074: *
075: * @author Dan Sandberg
076: */
077: public class IOTools {
078: protected final static int DEFAULT_BUFFER_SIZE = 4 * 1024; //4k
079:
080: //Ensure non-instantiability
081: private IOTools() {
082: }
083:
084: /**
085: * Read input from reader and write it to writer until there is no more
086: * input from reader.
087: *
088: * @param reader the reader to read from.
089: * @param writer the writer to write to.
090: * @param buf the char array to use as a bufferx
091: */
092: public static void flow(Reader reader, Writer writer, char[] buf)
093: throws IOException {
094: int numRead;
095: while ((numRead = reader.read(buf)) >= 0) {
096: writer.write(buf, 0, numRead);
097: }
098: }
099:
100: /**
101: * @see flow( Reader, Writer, char[] )
102: */
103: public static void flow(Reader reader, Writer writer)
104: throws IOException {
105: char[] buf = new char[DEFAULT_BUFFER_SIZE];
106: flow(reader, writer, buf);
107: }
108:
109: /**
110: * Read input from input stream and write it to output stream
111: * until there is no more input from input stream.
112: *
113: * @param input stream the input stream to read from.
114: * @param output stream the output stream to write to.
115: * @param buf the byte array to use as a buffer
116: */
117: public static void flow(InputStream is, OutputStream os, byte[] buf)
118: throws IOException {
119: int numRead;
120: while ((numRead = is.read(buf)) >= 0) {
121: os.write(buf, 0, numRead);
122: }
123: }
124:
125: /**
126: * @see flow( Reader, Writer, byte[] )
127: */
128: public static void flow(InputStream is, OutputStream os)
129: throws IOException {
130: byte[] buf = new byte[DEFAULT_BUFFER_SIZE];
131: flow(is, os, buf);
132: }
133: }
|