Add ProxyInputStream.setReference(InputStream), was package-private

setIn(InputStream)

Author: garydgregory

src/changes/changes.xml

@@ -58,6 +58,7 @@ The <action> type attribute can be add,update,fix,remove.
       <action dev="ggregory" type="add"                due-to="Gary Gregory">Add AbstractByteArrayOutputStream.write(CharSequence, Charset).</action>
       <action dev="ggregory" type="add"                due-to="Gary Gregory">Add AbstractByteArrayOutputStream.write(byte[]).</action>
       <action dev="ggregory" type="add"                due-to="Gary Gregory">Add RandomAccessFileOutputStream.getRandomAccessFile().</action>
+      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add ProxyInputStream.setReference(InputStream), was package-private setIn(InputStream).</action>
       <!-- UPDATE -->
       <action dev="ggregory" type="update"             due-to="Dependabot, Gary Gregory">Bump commons.bytebuddy.version from 1.15.10 to 1.15.11 #710.</action>
     </release>

src/main/java/org/apache/commons/io/input/ProxyInputStream.java

@@ -367,12 +367,15 @@ public synchronized void reset() throws IOException {
     }
 
     /**
-     * Package-private for testing.
+     * Sets the underlying input stream.
      *
      * @param in The input stream to set in {@link java.io.FilterInputStream#in}.
+     * @return this instance.
+     * @since 2.19.0
      */
-    void setIn(final InputStream in) {
+    public ProxyInputStream setReference(final InputStream in) {
         this.in = in;
+        return this;
     }
 
     /**

src/test/java/org/apache/commons/io/input/ProxyInputStreamTest.java

@@ -145,11 +145,11 @@ public void testAvailableAll() throws IOException {
     public void testAvailableNull() throws IOException {
         try (T inputStream = createFixture(null)) {
             assertEquals(0, inputStream.available());
-            inputStream.setIn(createFixture());
+            inputStream.setReference(createFixture());
             assertEquals(3, inputStream.available());
             IOUtils.toByteArray(inputStream);
             assertEquals(0, inputStream.available());
-            inputStream.setIn(null);
+            inputStream.setReference(null);
             assertEquals(0, inputStream.available());
         }
     }
@@ -162,11 +162,11 @@ protected void testEos(final T inputStream) {
     public void testMarkOnNull() throws IOException {
         try (T inputStream = createFixture(null)) {
             inputStream.mark(1);
-            inputStream.setIn(createFixture());
+            inputStream.setReference(createFixture());
             inputStream.mark(1);
             IOUtils.toByteArray(inputStream);
             inputStream.mark(1);
-            inputStream.setIn(null);
+            inputStream.setReference(null);
             inputStream.mark(1);
         }
     }
@@ -192,7 +192,7 @@ public void testMarkSupportedAfterClose() throws IOException {
     public void testMarkSupportedOnNull() throws IOException {
         try (ProxyInputStream fixture = createFixture()) {
             assertMarkSupportedEquals(fixture);
-            fixture.setIn(null);
+            fixture.setReference(null);
             assertFalse(fixture.markSupported());
         }
     }