HADOOP-19131. Assist reflection IO with WrappedOperations class

Change-Id: Ia70557518cacab9fd3c9811b6f94bc87afc36395

Author: steveloughran

hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/io/WrappedOperations.java

@@ -27,6 +27,7 @@
 import org.apache.hadoop.fs.FileStatus;
 import org.apache.hadoop.fs.FileSystem;
 import org.apache.hadoop.fs.FutureDataInputStreamBuilder;
+import org.apache.hadoop.fs.Path;
 import org.apache.hadoop.util.functional.FutureIO;
 
 import static org.apache.hadoop.fs.Options.OpenFileOptions.FS_OPTION_OPENFILE_READ_POLICY;
@@ -49,7 +50,7 @@ private WrappedOperations() {
 
   /**
    * OpenFile assistant, easy reflection-based access to
-   * {@link FileSystem#openFile(org.apache.hadoop.fs.Path)}.
+   * {@link FileSystem#openFile(Path)}.
    * @param fs filesystem
    * @param path path
    * @param policy read policy
@@ -58,8 +59,10 @@ private WrappedOperations() {
    * @return an opened file
    * @throws IOException for any failure.
    */
-  public static FSDataInputStream openFile(final FileSystem fs,
-      final org.apache.hadoop.fs.Path path,
+  @InterfaceStability.Stable
+  public static FSDataInputStream openFile(
+      final FileSystem fs,
+      final Path path,
       final String policy,
       final FileStatus status,
       final Map<String, String> options) throws IOException {