DataHandle: add ensureWritable method

In SCIFIO and Bio-Formats, this was present as the method
AbstractNIOHandle#validateLength.

But there is no reason to limit it to NIO-flavored handles only.

We use the name ensureWritable for clarity, and for symmetry
with a future ensureReadable method.

Author: ctrueden

src/main/java/org/scijava/io/DataHandle.java

@@ -73,6 +73,25 @@ public interface DataHandle<L extends Location> extends WrapperPlugin<L>,
 	 */
 	void setLength(long length) throws IOException;
 
+	/**
+	 * Ensures that the handle has the correct length to be written to and extends
+	 * it as required.
+	 * 
+	 * @param count Number of bytes to write.
+	 * @return {@code true} if the handle's length was sufficient, or
+	 *         {@code false} if the handle's length required an extension.
+	 * @throws IOException If something goes wrong with the check, or there is an
+	 *           error changing the handle's length.
+	 */
+	default boolean ensureWritable(final long count) throws IOException {
+		final long minLength = offset() + count;
+		if (length() < minLength) {
+			setLength(minLength);
+			return false;
+		}
+		return true;
+	}
+
 	/**
 	 * Returns the current order of the stream.
 	 *