Add AbstractOrigin.size()

Author: garydgregory

src/changes/changes.xml

@@ -86,6 +86,9 @@ The <action> type attribute can be add,update,fix,remove.
       <action dev="ggregory" type="add" due-to="Gary Gregory">
         Add and use RandomAccessFiles.
       </action>
+      <action dev="ggregory" type="add" due-to="Gary Gregory">
+        Add AbstractOrigin.size().
+      </action>
       <!-- UPDATE -->
       <action dev="ggregory" type="update" due-to="Gary Gregory, Dependabot">
         Bump commons-parent from 57 to 58.

src/main/java/org/apache/commons/io/build/AbstractOrigin.java

@@ -86,6 +86,11 @@ public Reader getReader(final Charset charset) throws IOException {
             return new InputStreamReader(getInputStream(), charset);
         }
 
+        @Override
+        public long size() throws IOException {
+            return origin.length;
+        }
+
     }
 
     /**
@@ -127,6 +132,11 @@ public Reader getReader(final Charset charset) throws IOException {
             return new InputStreamReader(getInputStream(), charset);
         }
 
+        @Override
+        public long size() throws IOException {
+            return origin.length();
+        }
+
     }
 
     /**
@@ -501,6 +511,17 @@ public Writer getWriter(final Charset charset, final OpenOption... options) thro
         return Files.newBufferedWriter(getPath(), charset, options);
     }
 
+    /**
+     * Gets the size of the origin, if possible.
+     *
+     * @return the size of the origin in bytes or characters.
+     * @throws IOException if an I/O error occurs.
+     * @since 2.13.0
+     */
+    public long size() throws IOException {
+        return Files.size(getPath());
+    }
+
     @Override
     public String toString() {
         return origin.toString();

src/test/java/org/apache/commons/io/build/AbstractOriginTest.java

@@ -17,6 +17,7 @@
 package org.apache.commons.io.build;
 
 import static org.junit.jupiter.api.Assertions.assertArrayEquals;
+import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
 
 import java.io.IOException;
@@ -124,4 +125,9 @@ public void testGetWriter() throws IOException {
             assertNotNull(writer);
         }
     }
+
+    @Test
+    public void testSize() throws IOException {
+        assertEquals(Files.size(Paths.get(FILE_NAME_RO)), getOriginRo().getByteArray().length);
+    }
 }

src/test/java/org/apache/commons/io/build/OutputStreamOriginTest.java

@@ -102,4 +102,11 @@ public void testGetReader() {
         assertThrows(UnsupportedOperationException.class, super::testGetReader);
     }
 
+    @Override
+    @Test
+    public void testSize() {
+        // Cannot convert a Writer to a size.
+        assertThrows(UnsupportedOperationException.class, super::testSize);
+    }
+
 }

src/test/java/org/apache/commons/io/build/WriterStreamOriginTest.java

@@ -101,4 +101,11 @@ public void testGetReader() {
         assertThrows(UnsupportedOperationException.class, super::testGetReader);
     }
 
+    @Override
+    @Test
+    public void testSize() {
+        // Cannot convert a Writer to a size.
+        assertThrows(UnsupportedOperationException.class, super::testSize);
+    }
+
 }