DeferredFileOutputStream now clears and deletes its temporary storage by

default (#858)

To get the old behavior back, call
org.apache.commons.io.output.DeferredFileOutputStream.Builder.setDeleteTempFileOnClose(false)

- Add DeferredFileOutputStream.Builder.setDeleteTempFileOnClose(boolean)
- Add PathUtils.clear[IfExists](Path)
- Add PathUtils.deleteIfExists(Path)
- Update generic type of RandomAccessFileMode.accept(Path, IOConsumer)
from IOConsumer<RandomAccessFile> to IOConsumer<IORandomAccessFile>
- Harden tests for NPEs on failures, happy path unchanged.

Author: garydgregory

src/changes/changes.xml

@@ -55,11 +55,17 @@ The <action> type attribute can be add,update,fix,remove.
       <action type="fix" dev="ggregory" due-to="Gary Gregory">BufferedFileChannelInputStream now clears its direct memory byte buffer on close (#855).</action>
       <action type="fix" dev="ggregory" due-to="Gary Gregory">MemoryMappedFileInputStream now clears its direct memory byte buffer on close (#855).</action>
       <action type="fix" dev="ggregory" due-to="Sarankumar Baskar" issue="IO-855">Clarify PeekableInputStream.peek() behavior in Javadoc (#856).</action>
+      <action type="fix" dev="ggregory" due-to="Gary Gregory">DeferredFileOutputStream now clears and deletes its temporary storage by default (#858).</action>
+      <action type="fix" dev="ggregory" due-to="Gary Gregory">Update generic type of RandomAccessFileMode.accept(Path, IOConsumer) from IOConsumer&lt;RandomAccessFile&gt; to IOConsumer&lt;IORandomAccessFile&gt;.</action>
+      <action type="fix" dev="ggregory" due-to="Gary Gregory">Harden tests for NPEs on failures, happy path unchanged.</action>
       <!-- ADD -->
       <action type="add" dev="ggregory" due-to="Gary Gregory">Add IOConsumer.accept(IOConsumer, T) (#846).</action>
       <action type="add" dev="ggregory" due-to="Gary Gregory">Add UnsynchronizedBufferedReader.unwrap() (#850).</action>
       <action type="add" dev="ggregory" due-to="Gary Gregory">Add UnsynchronizedBufferedReader.getPosition() (#851).</action>
       <action type="add" dev="ggregory" due-to="Gary Gregory">Add Buffers clear() methods (#853).</action>
+      <action type="add" dev="ggregory" due-to="Gary Gregory">Add DeferredFileOutputStream.Builder.setDeleteTempFileOnClose(boolean) (#858).</action>
+      <action type="add" dev="ggregory" due-to="Gary Gregory">Add PathUtils.clear[IfExists](Path) (#858).</action>
+      <action type="add" dev="ggregory" due-to="Gary Gregory">Add PathUtils.deleteIfExists(Path) (#858).</action>
       <!-- UPDATE -->
       <action type="update" dev="ggregory" due-to="Gary Gregory">Bump org.apache.commons:commons-parent from 98 to 102 (#849).</action>
       <action type="update" dev="ggregory" due-to="Gary Gregory">[test] Bump commons-codec:commons-codec from 1.21.0 to 1.22.0.</action>