Write the entire contents of the supplied string to the given stream. This method always flushes and closes the stream when finished. : OutputStream « 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.OutputStream;
/**
 * @author Randall Hauch
 */
public class Main {
  /**
   * Write the entire contents of the supplied string to the given stream. This method always flushes and closes the stream when
   * finished.
   * 
   * @param content the content to write to the stream; may be null
   * @param stream the stream to which the content is to be written
   * @throws IOException
   * @throws IllegalArgumentException if the stream is null
   */
  public static void write( String content,
                            OutputStream stream ) throws IOException {
      boolean error = false;
      try {
          if (content != null) {
              byte[] bytes = content.getBytes();
              stream.write(bytes, 0, bytes.length);
          }
      } catch (IOException e) {
          error = true; // this error should be thrown, even if there is an error flushing/closing stream
          throw e;
      } catch (RuntimeException e) {
          error = true; // this error should be thrown, even if there is an error flushing/closing stream
          throw e;
      } finally {
          try {
              stream.flush();
          } catch (IOException e) {
              if (!error) throw e;
          } finally {
              try {
                  stream.close();
              } catch (IOException e) {
                  if (!error) throw e;
              }
          }
      }
  }
}








11.13.OutputStream
11.13.1.Byte Counting OutputStream
11.13.2.Memory Byte Array OutputStream
11.13.3.A null output stream. All data written to this stream is ignored.
11.13.4.Provides true Closable semantics ordinarily missing in a {@link java.io.ByteArrayOutputStream}.
11.13.5.Write the entire contents of the supplied string to the given stream. This method always flushes and closes the stream when finished.
11.13.6.Transfers all bytes that can be read from one stream to another stream.