Przeglądaj źródła

HDFS-13937. Multipart Uploader APIs to be marked as private/unstable in 3.2.0. Contributed by Steve Loughran.

Sunil G 6 lat temu
rodzic
commit
d060cbea48

+ 5 - 0
hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/BBPartHandle.java

@@ -19,9 +19,14 @@ package org.apache.hadoop.fs;
 import java.nio.ByteBuffer;
 import java.util.Arrays;
 
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
 /**
  * Byte array backed part handle.
  */
+@InterfaceAudience.Private
+@InterfaceStability.Unstable
 public final class BBPartHandle implements PartHandle {
 
   private static final long serialVersionUID = 0x23ce3eb1;

+ 5 - 0
hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/BBUploadHandle.java

@@ -19,9 +19,14 @@ package org.apache.hadoop.fs;
 import java.nio.ByteBuffer;
 import java.util.Arrays;
 
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
 /**
  * Byte array backed upload handle.
  */
+@InterfaceAudience.Private
+@InterfaceStability.Unstable
 public final class BBUploadHandle implements UploadHandle {
 
   private static final long serialVersionUID = 0x69d5509b;

+ 4 - 0
hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/FileSystemMultipartUploader.java

@@ -28,6 +28,8 @@ import com.google.common.base.Preconditions;
 
 import org.apache.commons.compress.utils.IOUtils;
 import org.apache.commons.lang3.tuple.Pair;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
 import org.apache.hadoop.conf.Configuration;
 import org.apache.hadoop.fs.permission.FsPermission;
 
@@ -44,6 +46,8 @@ import static org.apache.hadoop.fs.Path.mergePaths;
  *   and then delete the temp directory.</li>
  * </ul>
  */
+@InterfaceAudience.Private
+@InterfaceStability.Unstable
 public class FileSystemMultipartUploader extends MultipartUploader {
 
   private final FileSystem fs;

+ 5 - 0
hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/MultipartUploader.java

@@ -27,6 +27,9 @@ import org.slf4j.LoggerFactory;
 
 import org.apache.commons.lang3.tuple.Pair;
 
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
 /**
  * MultipartUploader is an interface for copying files multipart and across
  * multiple nodes. Users should:
@@ -41,6 +44,8 @@ import org.apache.commons.lang3.tuple.Pair;
  * that 'complete' will reorder parts if the destination FS doesn't already
  * do it for them.
  */
+@InterfaceAudience.Private
+@InterfaceStability.Unstable
 public abstract class MultipartUploader {
   public static final Logger LOG =
       LoggerFactory.getLogger(MultipartUploader.class);

+ 4 - 0
hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/MultipartUploaderFactory.java

@@ -16,6 +16,8 @@
  */
 package org.apache.hadoop.fs;
 
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
 import org.apache.hadoop.conf.Configuration;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -28,6 +30,8 @@ import java.util.ServiceLoader;
  * {@link ServiceLoader}-driven uploader API for storage services supporting
  * multipart uploads.
  */
+@InterfaceAudience.Private
+@InterfaceStability.Unstable
 public abstract class MultipartUploaderFactory {
   public static final Logger LOG =
       LoggerFactory.getLogger(MultipartUploaderFactory.class);

+ 4 - 0
hadoop-tools/hadoop-aws/src/main/java/org/apache/hadoop/fs/s3a/S3AMultipartUploader.java

@@ -38,6 +38,8 @@ import com.google.common.base.Preconditions;
 
 import org.apache.commons.lang3.StringUtils;
 import org.apache.commons.lang3.tuple.Pair;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
 import org.apache.hadoop.conf.Configuration;
 import org.apache.hadoop.fs.BBPartHandle;
 import org.apache.hadoop.fs.BBUploadHandle;
@@ -55,6 +57,8 @@ import static org.apache.hadoop.fs.s3a.Constants.FS_S3A;
  * MultipartUploader for S3AFileSystem. This uses the S3 multipart
  * upload mechanism.
  */
+@InterfaceAudience.Private
+@InterfaceStability.Unstable
 public class S3AMultipartUploader extends MultipartUploader {
 
   private final S3AFileSystem s3a;