[CODEC-183] BaseNCodecOutputStream only supports writing EOF on close().

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/codec/trunk@1640000 13f79535-47bb-0310-9956-ffa450edef68

Author: garydgregory

src/main/java/org/apache/commons/codec/binary/BaseNCodecOutputStream.java

@@ -27,7 +27,13 @@
 
 /**
  * Abstract superclass for Base-N output streams.
- *
+ * <p>
+ * To write the EOF marker without closing the stream, call {@link #eof()} or use an <a
+ * href="https://commons.apache.org/proper/commons-io/">Apache Commons IO</a> <a href=
+ * "https://commons.apache.org/proper/commons-io/apidocs/org/apache/commons/io/output/CloseShieldOutputStream.html"
+ * >CloseShieldOutputStream</a>.
+ * </p>
+ * 
  * @since 1.5
  * @version $Id$
  */
@@ -134,20 +140,36 @@ public void flush() throws IOException {
 
     /**
      * Closes this output stream and releases any system resources associated with the stream.
+     * <p>
+     * To write the EOF marker without closing the stream, call {@link #eof()} or use an
+     * <a href="https://commons.apache.org/proper/commons-io/">Apache Commons IO</a> <a href=
+     * "https://commons.apache.org/proper/commons-io/apidocs/org/apache/commons/io/output/CloseShieldOutputStream.html"
+     * >CloseShieldOutputStream</a>.
+     * </p>
      *
      * @throws IOException
      *             if an I/O error occurs.
      */
     @Override
     public void close() throws IOException {
+        eof();
+        flush();
+        out.close();
+    }
+
+    /**
+     * Writes EOF.
+     * 
+     * @throws IOException
+     *             if an I/O error occurs.
+     */
+    public void eof() throws IOException {
         // Notify encoder of EOF (-1).
         if (doEncode) {
             baseNCodec.encode(singleByte, 0, EOF, context);
         } else {
             baseNCodec.decode(singleByte, 0, EOF, context);
         }
-        flush();
-        out.close();
     }
 
 }