Source for org.jfree.report.util.NoCloseOutputStream

   1: /**
   2:  * ========================================
   3:  * JFreeReport : a free Java report library
   4:  * ========================================
   5:  *
   6:  * Project Info:  http://reporting.pentaho.org/
   7:  *
   8:  * (C) Copyright 2000-2007, by Object Refinery Limited, Pentaho Corporation and Contributors.
   9:  *
  10:  * This library is free software; you can redistribute it and/or modify it under the terms
  11:  * of the GNU Lesser General Public License as published by the Free Software Foundation;
  12:  * either version 2.1 of the License, or (at your option) any later version.
  13:  *
  14:  * This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
  15:  * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  16:  * See the GNU Lesser General Public License for more details.
  17:  *
  18:  * You should have received a copy of the GNU Lesser General Public License along with this
  19:  * library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  20:  * Boston, MA 02111-1307, USA.
  21:  *
  22:  * [Java is a trademark or registered trademark of Sun Microsystems, Inc.
  23:  * in the United States and other countries.]
  24:  *
  25:  * ------------
  26:  * $Id: NoCloseOutputStream.java 2725 2007-04-01 18:49:29Z taqua $
  27:  * ------------
  28:  * (C) Copyright 2000-2005, by Object Refinery Limited.
  29:  * (C) Copyright 2005-2007, by Pentaho Corporation.
  30:  */
  31: package org.jfree.report.util;
  32: 
  33: import java.io.FilterOutputStream;
  34: import java.io.IOException;
  35: import java.io.OutputStream;
  36: 
  37: /**
  38:  * A Wrapper stream that does never calls close on its parent. This implementation is
  39:  * needed when creating ZipOutputStream, as the final ZipDirectory is written when close
  40:  * is called on the ZipOutputSteam.
  41:  *
  42:  * @author Thomas Morgner
  43:  */
  44: public class NoCloseOutputStream extends FilterOutputStream
  45: {
  46:   /**
  47:    * Create a new NoCloseOutputStream with the given output stream a parent.
  48:    *
  49:    * @param out the parent stream
  50:    */
  51:   public NoCloseOutputStream (final OutputStream out)
  52:   {
  53:     super(out);
  54:     if (out == null)
  55:     {
  56:       throw new NullPointerException("Given Output Stream is null!");
  57:     }
  58:   }
  59: 
  60:   /**
  61:    * Closes this output stream and releases any system resources associated with the
  62:    * stream, but does not close the underlying output stream.
  63:    * <p/>
  64:    * The <code>close</code> method of <code>FilterOutputStream</code> calls its
  65:    * <code>flush</code> method.
  66:    *
  67:    * @throws IOException if an I/O error occurs.
  68:    * @see FilterOutputStream#flush()
  69:    * @see FilterOutputStream#out
  70:    */
  71:   public void close ()
  72:           throws IOException
  73:   {
  74:     flush();
  75:     // do not close the parent stream ... !
  76:   }
  77: }