Package org.apache.tools.ant.util

Class LazyFileOutputStream

java.lang.Object
java.io.OutputStream
org.apache.tools.ant.util.LazyFileOutputStream
All Implemented Interfaces:
Closeable, Flushable, AutoCloseable
public class LazyFileOutputStream extends OutputStream
Class that delays opening the output file until the first bytes shall be written or the method open has been invoked explicitly.
Since:
Ant 1.6

  • Constructor Summary

    Constructors
    Constructor
    Description
    LazyFileOutputStream(File f)
    Creates a stream that will eventually write to the file with the given name and replace it.
    LazyFileOutputStream(File file, boolean append)
    Creates a stream that will eventually write to the file with the given name and optionally append to instead of replacing it.
    LazyFileOutputStream(File file, boolean append, boolean alwaysCreate)
    Creates a stream that will eventually write to the file with the given name, optionally append to instead of replacing it, and optionally always create a file (even if zero length).
    LazyFileOutputStream(String name)
    Creates a stream that will eventually write to the file with the given name and replace it.
    LazyFileOutputStream(String name, boolean append)
    Creates a stream that will eventually write to the file with the given name and optionally append to instead of replacing it.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    close()
    Close the file.
    void
    open()
    Explicitly open the file for writing.
    void
    write(byte[] b)
    Delegates to the three-arg version.
    void
    write(byte[] b, int offset, int len)
    Write part of a byte array.
    void
    write(int b)
    Write a byte.

    Methods inherited from class java.io.OutputStream

    flush, nullOutputStream

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • LazyFileOutputStream

      public LazyFileOutputStream(String name)
      Creates a stream that will eventually write to the file with the given name and replace it.
      Parameters:
      name - the filename.

    • LazyFileOutputStream

      public LazyFileOutputStream(String name, boolean append)
      Creates a stream that will eventually write to the file with the given name and optionally append to instead of replacing it.
      Parameters:
      name - the filename.
      append - if true append rather than replace.

    • LazyFileOutputStream

      public LazyFileOutputStream(File f)
      Creates a stream that will eventually write to the file with the given name and replace it.
      Parameters:
      f - the file to create.

    • LazyFileOutputStream

      public LazyFileOutputStream(File file, boolean append)
      Creates a stream that will eventually write to the file with the given name and optionally append to instead of replacing it.
      Parameters:
      file - the file to create.
      append - if true append rather than replace.

    • LazyFileOutputStream

      public LazyFileOutputStream(File file, boolean append, boolean alwaysCreate)
      Creates a stream that will eventually write to the file with the given name, optionally append to instead of replacing it, and optionally always create a file (even if zero length).
      Parameters:
      file - the file to create.
      append - if true append rather than replace.
      alwaysCreate - if true create the file even if nothing to write.

  • Method Details

    • open

      public void open() throws IOException
      Explicitly open the file for writing.

      Returns silently if the file has already been opened.

      Throws:
      IOException - if there is an error.

    • close

      public void close() throws IOException
      Close the file.
      Specified by:
      close in interface AutoCloseable
      Specified by:
      close in interface Closeable
      Overrides:
      close in class OutputStream
      Throws:
      IOException - if there is an error.

    • write

      public void write(byte[] b) throws IOException
      Delegates to the three-arg version.
      Overrides:
      write in class OutputStream
      Parameters:
      b - the bytearray to write.
      Throws:
      IOException - if there is a problem.

    • write

      public void write(byte[] b, int offset, int len) throws IOException
      Write part of a byte array.
      Overrides:
      write in class OutputStream
      Parameters:
      b - the byte array.
      offset - write from this index.
      len - the number of bytes to write.
      Throws:
      IOException - if there is a problem.

    • write

      public void write(int b) throws IOException
      Write a byte.
      Specified by:
      write in class OutputStream
      Parameters:
      b - the byte to write.
      Throws:
      IOException - if there is a problem.