commons-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Elijah Zupancic (JIRA)" <>
Subject [jira] [Commented] (IO-546) ClosedOutputStream#flush should throw
Date Wed, 16 Aug 2017 01:15:00 GMT


Elijah Zupancic commented on IO-546:

This sample application illustrates the inconsistency:


import java.nio.charset.StandardCharsets;

public class BrokenShield {
    public static void main(String[] argv) throws IOException {
        File file = File.createTempFile("broken-shield", "txt");

        byte[] arbitraryData = "Hello World ".getBytes(StandardCharsets.UTF_8);

        FileOutputStream fout = new FileOutputStream(file);
        BufferedOutputStream bout = new BufferedOutputStream(fout, 99999);
        CloseShieldOutputStream cout = new CloseShieldOutputStream(fout);

        try {
            // This should work because we haven't tried to close the stream

            // Here we pretend this is some stupid library that insists on
            // closing a stream when it shouldn't.

            // After we try to close the stream, new data can't be written to
            // the stream. For example: cout.write(arbitraryData);
            // Would throw an exception like:
            // write(72) failed: stream is closed

            // However, if we call flush(), no exception is thrown - this is
            // inconsistent with the behavior of write()
        } finally {
            // We properly close the stream we have to use the underlying
            // stream like you would expect.

        try (FileInputStream fin = new FileInputStream(file)) {
            String data = IOUtils.toString(fin, StandardCharsets.UTF_8);

> ClosedOutputStream#flush should throw
> -------------------------------------
>                 Key: IO-546
>                 URL:
>             Project: Commons IO
>          Issue Type: Improvement
>          Components: Streams/Writers
>            Reporter: Tomas Celaya
>            Priority: Minor
>         Attachments: IO-546.patch
> While debugging an issue involving usage of {{CloseShieldOutputStream}} I discovered
that {{ClosedOutputStream#flush}} is not overridden and will silently succeed. Not sure how
much of a breaking change this might be but I think it makes more sense for {{ClosedOutputStream#flush}}
to throw. This is only really meaningful in contexts where multiple streams are being chained
together and some of the streams before {{CloseShieldOutputStream}} perform buffering, but
it would make behavior more consistent for these more complex use-cases.
> No patches are included because I'm interested in hearing what the opinion would be on
this issue. I can provide a patch if this seems like desired behavior.

This message was sent by Atlassian JIRA

View raw message