Validate output buffer capacity in RapidsInputFile.readVectored default

Throw IllegalArgumentException when any CopyRange's outputOffset + length
exceeds output.getLength(), before opening the stream. This lets callers
rely on the default implementation instead of duplicating the check, and
gives a clearer error message than the lower-level failure surfaced by
HostMemoryBuffer.copyFromStream.

The CopyRange constructor already rejects negative inputOffset/outputOffset
and non-positive length, so those guards are not duplicated here.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Signed-off-by: Chong Gao <res_life@163.com>

Author: Chong Gao

src/main/java/com/nvidia/spark/rapids/jni/fileio/RapidsInputFile.java

@@ -72,8 +72,14 @@ default void readVectored(HostMemoryBuffer output, List<CopyRange> copyRanges)
     if (copyRanges.isEmpty()) {
       return;
     }
+    long outputLength = output.getLength();
     for (CopyRange copyRange : copyRanges) {
       Objects.requireNonNull(copyRange, "copyRange can't be null");
+      long end = copyRange.getOutputOffset() + copyRange.getLength();
+      if (end > outputLength) {
+        throw new IllegalArgumentException(
+            "Output buffer length " + outputLength + " is smaller than requested end " + end);
+      }
     }
 
     try (SeekableInputStream input = open()) {

src/test/java/com/nvidia/spark/rapids/jni/fileio/RapidsInputFileTest.java

@@ -66,6 +66,20 @@ public void readVectoredRejectsNullRangesBeforeOpeningStream() throws IOExceptio
     assertEquals(0, inputFile.getOpenCount());
   }
 
+  @Test
+  public void readVectoredRejectsRangeExceedingOutputBeforeOpeningStream() throws IOException {
+    TestRapidsInputFile inputFile = new TestRapidsInputFile(FILE_DATA);
+    try (HostMemoryBuffer output = HostMemoryBuffer.allocate(3)) {
+      assertThrows(IllegalArgumentException.class,
+          () -> inputFile.readVectored(output,
+              Collections.singletonList(new RapidsInputFile.CopyRange(0, 4, 0))));
+      assertThrows(IllegalArgumentException.class,
+          () -> inputFile.readVectored(output,
+              Collections.singletonList(new RapidsInputFile.CopyRange(0, 2, 2))));
+    }
+    assertEquals(0, inputFile.getOpenCount());
+  }
+
   @Test
   public void readTailUsesSeekableStreamFallback() throws IOException {
     RapidsInputFile inputFile = new TestRapidsInputFile(FILE_DATA);