org.apache.commons.io.output

Class ProxyOutputStream

  • All Implemented Interfaces:
    Closeable, Flushable, AutoCloseable
    Direct Known Subclasses:
    CloseShieldOutputStream, CountingOutputStream, TaggedOutputStream, TeeOutputStream


    public class ProxyOutputStreamextends FilterOutputStream
    A Proxy stream which acts as expected, that is it passes the method calls on to the proxied stream and doesn't change which methods are being called. It is an alternative base class to FilterOutputStream to increase reusability.

    See the protected methods for ways in which a subclass can easily decorate a stream with custom pre-, post- or error processing functionality.

    Version:
    $Id: ProxyOutputStream.java 1415850 2012-11-30 20:51:39Z ggregory $
    • Constructor Detail

      • ProxyOutputStream

        public ProxyOutputStream(OutputStream proxy)
        Constructs a new ProxyOutputStream.
        Parameters:
        proxy - the OutputStream to delegate to
    • Method Detail

      • write

        public void write(byte[] bts,         int st,         int end)           throws IOException
        Invokes the delegate's write(byte[]) method.
        Overrides:
        write in class FilterOutputStream
        Parameters:
        bts - the bytes to write
        st - The start offset
        end - The number of bytes to write
        Throws:
        IOException - if an I/O error occurs
      • beforeWrite

        protected void beforeWrite(int n)                    throws IOException
        Invoked by the write methods before the call is proxied. The number of bytes to be written (1 for the write(int) method, buffer length for write(byte[]), etc.) is given as an argument.

        Subclasses can override this method to add common pre-processing functionality without having to override all the write methods. The default implementation does nothing.

        Parameters:
        n - number of bytes to be written
        Throws:
        IOException - if the pre-processing fails
        Since:
        2.0
      • afterWrite

        protected void afterWrite(int n)                   throws IOException
        Invoked by the write methods after the proxied call has returned successfully. The number of bytes written (1 for the write(int) method, buffer length for write(byte[]), etc.) is given as an argument.

        Subclasses can override this method to add common post-processing functionality without having to override all the write methods. The default implementation does nothing.

        Parameters:
        n - number of bytes written
        Throws:
        IOException - if the post-processing fails
        Since:
        2.0
      • handleIOException

        protected void handleIOException(IOException e)                          throws IOException
        Handle any IOExceptions thrown.

        This method provides a point to implement custom exception handling. The default behaviour is to re-throw the exception.

        Parameters:
        e - The IOException thrown
        Throws:
        IOException - if an I/O error occurs
        Since:
        2.0

Copyright © 2002–2016 The Apache Software Foundation. All rights reserved.



NOTHING
NOTHING
Add the Maven Dependecy to your project: maven dependecy for com.amazonaws : aws-java-sdk : 1.3.14