DataHandleService: Prominently expose ReadBufferDataHandle and WriteBufferDataHandle

Author: gab1one

src/main/java/org/scijava/io/handle/DataHandleService.java

@@ -33,6 +33,7 @@
 package org.scijava.io.handle;
 
 import java.io.IOException;
+import java.util.Objects;
 
 import org.scijava.io.IOService;
 import org.scijava.io.location.Location;
@@ -79,4 +80,40 @@ default boolean exists(final Location location) throws IOException {
 			return handle.exists();
 		}
 	}
+
+	/**
+	 * Wraps the provided {@link DataHandle} in a read-only buffer for accelerated
+	 * reading.
+	 *
+	 * @param handle the handle to wrap
+	 * @see ReadBufferDataHandle#ReadBufferDataHandle(DataHandle)
+	 */
+	default DataHandle<Location> readBuffer(final DataHandle<Location> handle) {
+		Objects.nonNull(handle);
+		return new ReadBufferDataHandle(handle);
+	}
+
+	/**
+	 * Creates a {@link DataHandle} on the provided {@link Location} wrapped in a
+	 * read-only buffer for accelerated reading.
+	 *
+	 * @param location the handle to wrap
+	 * @see ReadBufferDataHandle#ReadBufferDataHandle(DataHandle)
+	 */
+	default DataHandle<Location> readBuffer(final Location location) {
+		final DataHandle<Location> handle = create(location);
+		return handle == null ? null : new ReadBufferDataHandle(handle);
+	}
+
+	/**
+	 * Wraps the provided {@link DataHandle} in a write-only buffer for
+	 * accelerated writing.
+	 *
+	 * @param handle the handle to wrap
+	 * @see WriteBufferDataHandle#WriteBufferDataHandle(DataHandle)
+	 */
+	default DataHandle<Location> writeBuffer(final DataHandle<Location> handle) {
+		Objects.nonNull(handle);
+		return new WriteBufferDataHandle(handle);
+	}
 }