Read and return the entire contents of the supplied InputStream. This method always closes the stream when finished reading. : InputStream « File « Java Tutorial






/*
 * JBoss DNA (http://www.jboss.org/dna)
 * See the COPYRIGHT.txt file distributed with this work for information
 * regarding copyright ownership.  Some portions may be licensed
 * to Red Hat, Inc. under one or more contributor license agreements.
 * See the AUTHORS.txt file in the distribution for a full listing of 
 * individual contributors. 
 *
 * JBoss DNA is free software. Unless otherwise indicated, all code in JBoss DNA
 * is licensed to you under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; either version 2.1 of
 * the License, or (at your option) any later version.
 *
 * JBoss DNA is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this software; if not, write to the Free
 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
 */
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.Reader;
/**
 * @author Randall Hauch
 */
public class Main {
  /**
   * Read and return the entire contents of the supplied {@link InputStream}. This method always closes the stream when finished
   * reading.
   * 
   * @param stream the streamed contents; may be null
   * @return the contents, or an empty string if the supplied stream is null
   * @throws IOException if there is an error reading the content
   */
  public static String read( InputStream stream ) throws IOException {
      return stream == null ? "" : read(new InputStreamReader(stream));
  }
  /**
   * Read and return the entire contents of the supplied {@link Reader}. This method always closes the reader when finished
   * reading.
   * 
   * @param reader the reader of the contents; may be null
   * @return the contents, or an empty string if the supplied reader is null
   * @throws IOException if there is an error reading the content
   */
  public static String read( Reader reader ) throws IOException {
      if (reader == null) return "";
      StringBuilder sb = new StringBuilder();
      boolean error = false;
      try {
          int numRead = 0;
          char[] buffer = new char[1024];
          while ((numRead = reader.read(buffer)) > -1) {
              sb.append(buffer, 0, numRead);
          }
      } catch (IOException e) {
          error = true; // this error should be thrown, even if there is an error closing reader
          throw e;
      } catch (RuntimeException e) {
          error = true; // this error should be thrown, even if there is an error closing reader
          throw e;
      } finally {
          try {
              reader.close();
          } catch (IOException e) {
              if (!error) throw e;
          }
      }
      return sb.toString();
  }
}








11.7.InputStream
11.7.1.Creating an input or output stream on a ByteBuffer
11.7.2.Creating a Manifest for a JAR File
11.7.3.Convert InputStream to String
11.7.4.Compare the contents of two Streams to determine if they are equal or not.
11.7.5.Compare two InputStream
11.7.6.Counts down from a specified value the number of bytes actually read from the wrapped InputStream.
11.7.7.EOLConvertingInputStream: InputStream which converts \r bytes not followed by \n and \n not preceded by \r to \r\n.
11.7.8.Minimal InputStream subclass to fetch bytes form a String
11.7.9.Read and return the entire contents of the supplied InputStream.
11.7.10.Read and return the entire contents of the supplied InputStream. This method always closes the stream when finished reading.
11.7.11.Reads at most certain bytes from input stream and returns them as a byte array.
11.7.12.Using a Reader and a Writer, returns a String from an InputStream
11.7.13.Write the entire contents of the supplied string to the given stream. This method always flushes and closes the stream when finished.
11.7.14.Resettable File InputStream
11.7.15.An InputStream class that terminates the stream when it encounters a particular byte sequence.