You are viewing a plain text version of this content. The canonical link for it is here.
Posted to common-commits@hadoop.apache.org by to...@apache.org on 2010/06/11 23:35:05 UTC
svn commit: r953881 [1/5] - in /hadoop/common/trunk: ./
src/java/org/apache/hadoop/ src/java/org/apache/hadoop/classification/
src/java/org/apache/hadoop/conf/ src/java/org/apache/hadoop/fs/
src/java/org/apache/hadoop/fs/ftp/ src/java/org/apache/hadoop...
Author: tomwhite
Date: Fri Jun 11 21:34:56 2010
New Revision: 953881
URL: http://svn.apache.org/viewvc?rev=953881&view=rev
Log:
HADOOP-6668. Apply audience and stability annotations to classes in common.
Added:
hadoop/common/trunk/src/java/org/apache/hadoop/fs/local/package-info.java (with props)
hadoop/common/trunk/src/java/org/apache/hadoop/fs/shell/package-info.java (with props)
hadoop/common/trunk/src/java/org/apache/hadoop/http/package-info.java (with props)
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/bzip2/package-info.java (with props)
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/zlib/package-info.java (with props)
hadoop/common/trunk/src/java/org/apache/hadoop/io/retry/package-info.java (with props)
hadoop/common/trunk/src/java/org/apache/hadoop/ipc/metrics/package-info.java (with props)
hadoop/common/trunk/src/java/org/apache/hadoop/ipc/package-info.java (with props)
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/jvm/package-info.java (with props)
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/util/package-info.java (with props)
Modified:
hadoop/common/trunk/CHANGES.txt
hadoop/common/trunk/src/java/org/apache/hadoop/HadoopIllegalArgumentException.java
hadoop/common/trunk/src/java/org/apache/hadoop/HadoopVersionAnnotation.java
hadoop/common/trunk/src/java/org/apache/hadoop/classification/InterfaceAudience.java
hadoop/common/trunk/src/java/org/apache/hadoop/classification/InterfaceStability.java
hadoop/common/trunk/src/java/org/apache/hadoop/conf/ConfServlet.java
hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configurable.java
hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configuration.java
hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configured.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/AvroFSInput.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/BlockLocation.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/BufferedFSInputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/ChecksumException.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/ChecksumFileSystem.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/CommonConfigurationKeys.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/ContentSummary.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/CreateFlag.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/DF.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/DU.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSDataInputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSDataOutputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSError.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSInputChecker.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSInputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSOutputSummer.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileAlreadyExistsException.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileChecksum.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileStatus.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileSystem.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileUtil.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FilterFileSystem.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsConstants.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsServerDefaults.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsShell.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsShellPermissions.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsStatus.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlConnection.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlStreamHandler.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlStreamHandlerFactory.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/GlobExpander.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/InvalidPathException.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalDirAllocator.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalFileSystem.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalFileSystemConfigKeys.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/MD5MD5CRC32FileChecksum.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/Options.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/ParentNotDirectoryException.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/Path.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/PathFilter.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/PositionedReadable.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/RawLocalFileSystem.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/Seekable.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/Syncable.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/Trash.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/UnresolvedLinkException.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/UnsupportedFileSystemException.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/ftp/FTPException.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/ftp/FTPFileSystem.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/ftp/FTPInputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/kfs/KFSConfigKeys.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/kfs/KFSImpl.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/kfs/KFSInputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/kfs/KFSOutputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/kfs/KosmosFileSystem.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/permission/AccessControlException.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/permission/ChmodParser.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/permission/FsAction.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/permission/FsPermission.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/permission/PermissionParser.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/permission/PermissionStatus.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/permission/UmaskParser.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3/Block.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3/FileSystemStore.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3/INode.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3/Jets3tFileSystemStore.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3/MigrationTool.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3/S3Credentials.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3/S3Exception.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3/S3FileSystem.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3/S3FileSystemConfigKeys.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3/S3FileSystemException.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3/S3InputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3/S3OutputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3/VersionMismatchException.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3native/FileMetadata.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3native/Jets3tNativeFileSystemStore.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3native/NativeFileSystemStore.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3native/NativeS3FileSystem.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3native/PartialListing.java
hadoop/common/trunk/src/java/org/apache/hadoop/fs/s3native/S3NativeFileSystemConfigKeys.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/AbstractMapWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/ArrayFile.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/ArrayWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/BinaryComparable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/BloomMapFile.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/BooleanWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/BoundedByteArrayOutputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/ByteWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/BytesWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/Closeable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/CompressedWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/DataInputBuffer.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/DataOutputBuffer.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/DefaultStringifier.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/DoubleWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/EnumSetWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/FloatWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/GenericWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/IOUtils.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/InputBuffer.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/IntWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/LongWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/MD5Hash.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/MapFile.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/MapWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/MultipleIOException.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/NullWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/ObjectWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/OutputBuffer.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/RawComparator.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/SequenceFile.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/SetFile.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/SortedMapWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/Stringifier.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/Text.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/TwoDArrayWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/UTF8.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/VIntWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/VLongWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/VersionMismatchException.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/VersionedWritable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/Writable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/WritableComparable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/WritableComparator.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/WritableFactories.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/WritableFactory.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/WritableName.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/WritableUtils.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/BZip2Codec.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/BlockCompressorStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/BlockDecompressorStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/CodecPool.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/CompressionCodec.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/CompressionCodecFactory.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/CompressionInputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/CompressionOutputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/Compressor.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/CompressorStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/Decompressor.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/DecompressorStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/DefaultCodec.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/GzipCodec.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/SplitCompressionInputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/compress/SplittableCompressionCodec.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/file/tfile/ByteArray.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/file/tfile/MetaBlockAlreadyExists.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/file/tfile/MetaBlockDoesNotExist.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/file/tfile/RawComparable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/file/tfile/TFile.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/file/tfile/Utils.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/serializer/Deserializer.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/serializer/DeserializerComparator.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/serializer/JavaSerialization.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/serializer/JavaSerializationComparator.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/serializer/Serialization.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/serializer/SerializationFactory.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/serializer/Serializer.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/serializer/WritableSerialization.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/serializer/avro/AvroReflectSerializable.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/serializer/avro/AvroReflectSerialization.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/serializer/avro/AvroSerialization.java
hadoop/common/trunk/src/java/org/apache/hadoop/io/serializer/avro/AvroSpecificSerialization.java
hadoop/common/trunk/src/java/org/apache/hadoop/ipc/metrics/RpcActivityMBean.java
hadoop/common/trunk/src/java/org/apache/hadoop/ipc/metrics/RpcDetailedActivityMBean.java
hadoop/common/trunk/src/java/org/apache/hadoop/ipc/metrics/RpcDetailedMetrics.java
hadoop/common/trunk/src/java/org/apache/hadoop/ipc/metrics/RpcMetrics.java
hadoop/common/trunk/src/java/org/apache/hadoop/ipc/metrics/RpcMgt.java
hadoop/common/trunk/src/java/org/apache/hadoop/ipc/metrics/RpcMgtMBean.java
hadoop/common/trunk/src/java/org/apache/hadoop/log/LogLevel.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/ContextFactory.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/MetricsContext.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/MetricsException.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/MetricsRecord.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/MetricsServlet.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/MetricsUtil.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/Updater.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/file/FileContext.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/ganglia/GangliaContext.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/jvm/EventCounter.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/jvm/JvmMetrics.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/spi/AbstractMetricsContext.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/spi/CompositeContext.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/spi/MetricValue.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/spi/MetricsRecordImpl.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/spi/NoEmitMetricsContext.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/spi/NullContext.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/spi/NullContextWithUpdateThread.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/spi/OutputRecord.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/spi/Util.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/util/MBeanUtil.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/util/MetricsBase.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/util/MetricsDynamicMBeanBase.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/util/MetricsIntValue.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/util/MetricsLongValue.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/util/MetricsRegistry.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/util/MetricsTimeVaryingInt.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/util/MetricsTimeVaryingLong.java
hadoop/common/trunk/src/java/org/apache/hadoop/metrics/util/MetricsTimeVaryingRate.java
hadoop/common/trunk/src/java/org/apache/hadoop/net/CachedDNSToSwitchMapping.java
hadoop/common/trunk/src/java/org/apache/hadoop/net/DNS.java
hadoop/common/trunk/src/java/org/apache/hadoop/net/DNSToSwitchMapping.java
hadoop/common/trunk/src/java/org/apache/hadoop/net/NetUtils.java
hadoop/common/trunk/src/java/org/apache/hadoop/net/NetworkTopology.java
hadoop/common/trunk/src/java/org/apache/hadoop/net/Node.java
hadoop/common/trunk/src/java/org/apache/hadoop/net/NodeBase.java
hadoop/common/trunk/src/java/org/apache/hadoop/net/ScriptBasedMapping.java
hadoop/common/trunk/src/java/org/apache/hadoop/net/SocketInputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/net/SocketOutputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/net/SocksSocketFactory.java
hadoop/common/trunk/src/java/org/apache/hadoop/net/StandardSocketFactory.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/BinaryRecordInput.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/BinaryRecordOutput.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/Buffer.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/CsvRecordInput.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/CsvRecordOutput.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/Index.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/Record.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/RecordComparator.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/RecordInput.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/RecordOutput.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/Utils.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/XmlRecordInput.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/XmlRecordOutput.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/CodeBuffer.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/Consts.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/JBoolean.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/JBuffer.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/JByte.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/JDouble.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/JField.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/JFile.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/JFloat.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/JInt.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/JLong.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/JMap.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/JRecord.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/JString.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/JType.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/JVector.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/ant/RccTask.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/generated/ParseException.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/generated/Rcc.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/generated/RccConstants.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/generated/RccTokenManager.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/generated/SimpleCharStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/generated/Token.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/compiler/generated/TokenMgrError.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/meta/FieldTypeInfo.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/meta/MapTypeID.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/meta/RecordTypeInfo.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/meta/StructTypeID.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/meta/TypeID.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/meta/Utils.java
hadoop/common/trunk/src/java/org/apache/hadoop/record/meta/VectorTypeID.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/AccessControlException.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/GroupMappingServiceProvider.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/Groups.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/KerberosInfo.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/KerberosName.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/RefreshUserMappingsProtocol.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/SaslInputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/SaslOutputStream.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/SaslRpcClient.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/SaslRpcServer.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/SecurityUtil.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/ShellBasedUnixGroupsMapping.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/TokenStorage.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/User.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/UserGroupInformation.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/authorize/AccessControlList.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/authorize/AuthorizationException.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/authorize/PolicyProvider.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/authorize/RefreshAuthorizationPolicyProtocol.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/authorize/Service.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/authorize/ServiceAuthorizationManager.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/token/SecretManager.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/token/Token.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/token/TokenIdentifier.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/token/TokenInfo.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/token/TokenSelector.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/token/delegation/AbstractDelegationTokenIdentifier.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/token/delegation/AbstractDelegationTokenSecretManager.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/token/delegation/AbstractDelegationTokenSelector.java
hadoop/common/trunk/src/java/org/apache/hadoop/security/token/delegation/DelegationKey.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/AsyncDiskService.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/CyclicIteration.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/Daemon.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/DataChecksum.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/DiskChecker.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/GenericOptionsParser.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/GenericsUtil.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/HeapSort.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/HostsFileReader.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/IndexedSortable.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/IndexedSorter.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/LineReader.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/MergeSort.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/NativeCodeLoader.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/PlatformName.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/PrintJarMainClass.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/PriorityQueue.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/ProgramDriver.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/Progress.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/Progressable.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/PureJavaCrc32.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/QuickSort.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/ReflectionUtils.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/RunJar.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/ServicePlugin.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/ServletUtil.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/Shell.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/StringUtils.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/Tool.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/ToolRunner.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/UTF8ByteArrayUtils.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/VersionInfo.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/XMLUtils.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/bloom/BloomFilter.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/bloom/CountingBloomFilter.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/bloom/DynamicBloomFilter.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/bloom/Filter.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/bloom/HashFunction.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/bloom/Key.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/bloom/RemoveScheme.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/bloom/RetouchedBloomFilter.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/hash/Hash.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/hash/JenkinsHash.java
hadoop/common/trunk/src/java/org/apache/hadoop/util/hash/MurmurHash.java
Modified: hadoop/common/trunk/CHANGES.txt
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/CHANGES.txt?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/CHANGES.txt (original)
+++ hadoop/common/trunk/CHANGES.txt Fri Jun 11 21:34:56 2010
@@ -945,6 +945,9 @@ Release 0.21.0 - Unreleased
HADOOP-6813. Add a new newInstance method in FileSystem that takes
a "user" as argument (ddas via boryas)
+ HADOOP-6668. Apply audience and stability annotations to classes in
+ common. (tomwhite)
+
OPTIMIZATIONS
HADOOP-5595. NameNode does not need to run a replicator to choose a
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/HadoopIllegalArgumentException.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/HadoopIllegalArgumentException.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/HadoopIllegalArgumentException.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/HadoopIllegalArgumentException.java Fri Jun 11 21:34:56 2010
@@ -17,11 +17,16 @@
*/
package org.apache.hadoop;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/**
* Indicates that a method has been passed illegal or invalid argument. This
* exception is thrown instead of IllegalArgumentException to differentiate the
* exception thrown in Hadoop implementation from the one thrown in JDK.
*/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class HadoopIllegalArgumentException extends IllegalArgumentException {
private static final long serialVersionUID = 1L;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/HadoopVersionAnnotation.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/HadoopVersionAnnotation.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/HadoopVersionAnnotation.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/HadoopVersionAnnotation.java Fri Jun 11 21:34:56 2010
@@ -19,11 +19,16 @@ package org.apache.hadoop;
import java.lang.annotation.*;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/**
* A package attribute that captures the version of Hadoop that was compiled.
*/
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.PACKAGE)
+@InterfaceAudience.LimitedPrivate({"HDFS", "MapReduce"})
+@InterfaceStability.Unstable
public @interface HadoopVersionAnnotation {
/**
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/classification/InterfaceAudience.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/classification/InterfaceAudience.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/classification/InterfaceAudience.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/classification/InterfaceAudience.java Fri Jun 11 21:34:56 2010
@@ -22,6 +22,8 @@ import java.lang.annotation.Documented;
/**
* Annotation to inform users of a package, class or method's intended audience.
*/
+@InterfaceAudience.Public
+@InterfaceStability.Evolving
public class InterfaceAudience {
/**
* Intended for use by any project or application.
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/classification/InterfaceStability.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/classification/InterfaceStability.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/classification/InterfaceStability.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/classification/InterfaceStability.java Fri Jun 11 21:34:56 2010
@@ -23,6 +23,8 @@ import java.lang.annotation.Documented;
* Annotation to inform users of how much to rely on a particular package,
* class or method not changing over time.
*/
+@InterfaceAudience.Public
+@InterfaceStability.Evolving
public class InterfaceStability {
/**
* Can evolve while retaining compatibility for minor release boundaries.;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/conf/ConfServlet.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/conf/ConfServlet.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/conf/ConfServlet.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/conf/ConfServlet.java Fri Jun 11 21:34:56 2010
@@ -26,11 +26,15 @@ import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.http.HttpServer;
/**
* A servlet to print out the running configuration data.
*/
+@InterfaceAudience.LimitedPrivate({"HDFS", "MapReduce"})
+@InterfaceStability.Unstable
public class ConfServlet extends HttpServlet {
private static final long serialVersionUID = 1L;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configurable.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configurable.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configurable.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configurable.java Fri Jun 11 21:34:56 2010
@@ -18,7 +18,12 @@
package org.apache.hadoop.conf;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/** Something that may be configured with a {@link Configuration}. */
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public interface Configurable {
/** Set the configuration to be used by this object. */
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configuration.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configuration.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configuration.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configuration.java Fri Jun 11 21:34:56 2010
@@ -61,6 +61,8 @@ import javax.xml.transform.stream.Stream
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;
import org.apache.hadoop.fs.CommonConfigurationKeys;
@@ -144,6 +146,8 @@ import org.xml.sax.SAXException;
* <tt>${<i>user.name</i>}</tt> would then ordinarily be resolved to the value
* of the System property with that name.
*/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class Configuration implements Iterable<Map.Entry<String,String>>,
Writable {
private static final Log LOG =
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configured.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configured.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configured.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/conf/Configured.java Fri Jun 11 21:34:56 2010
@@ -18,7 +18,12 @@
package org.apache.hadoop.conf;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/** Base class for things that may be configured with a {@link Configuration}. */
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class Configured implements Configurable {
private Configuration conf;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/AvroFSInput.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/AvroFSInput.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/AvroFSInput.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/AvroFSInput.java Fri Jun 11 21:34:56 2010
@@ -22,8 +22,12 @@ import java.io.Closeable;
import java.io.IOException;
import org.apache.avro.file.SeekableInput;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
/** Adapts an {@link FSDataInputStream} to Avro's SeekableInput interface. */
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class AvroFSInput implements Closeable, SeekableInput {
private final FSDataInputStream stream;
private final long len;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/BlockLocation.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/BlockLocation.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/BlockLocation.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/BlockLocation.java Fri Jun 11 21:34:56 2010
@@ -21,6 +21,8 @@ import java.io.DataInput;
import java.io.DataOutput;
import java.io.IOException;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.io.Text;
import org.apache.hadoop.io.Writable;
import org.apache.hadoop.io.WritableFactories;
@@ -31,6 +33,8 @@ import org.apache.hadoop.io.WritableFact
* of block.
*
*/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class BlockLocation implements Writable {
static { // register a ctor
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/BufferedFSInputStream.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/BufferedFSInputStream.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/BufferedFSInputStream.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/BufferedFSInputStream.java Fri Jun 11 21:34:56 2010
@@ -20,12 +20,16 @@ package org.apache.hadoop.fs;
import java.io.BufferedInputStream;
import java.io.IOException;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/**
* A class optimizes reading from FSInputStream by bufferring
*/
-
+@InterfaceAudience.Private
+@InterfaceStability.Unstable
public class BufferedFSInputStream extends BufferedInputStream
implements Seekable, PositionedReadable {
/**
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/ChecksumException.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/ChecksumException.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/ChecksumException.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/ChecksumException.java Fri Jun 11 21:34:56 2010
@@ -20,7 +20,12 @@ package org.apache.hadoop.fs;
import java.io.IOException;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/** Thrown for checksum errors. */
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class ChecksumException extends IOException {
private static final long serialVersionUID = 1L;
private long pos;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/ChecksumFileSystem.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/ChecksumFileSystem.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/ChecksumFileSystem.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/ChecksumFileSystem.java Fri Jun 11 21:34:56 2010
@@ -25,6 +25,8 @@ import java.util.zip.CRC32;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
+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;
import org.apache.hadoop.util.Progressable;
@@ -38,6 +40,8 @@ import org.apache.hadoop.util.StringUtil
* It generates & verifies checksums at the client side.
*
*****************************************************************/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public abstract class ChecksumFileSystem extends FilterFileSystem {
private static final byte[] CHECKSUM_VERSION = new byte[] {'c', 'r', 'c', 0};
private int bytesPerChecksum = 512;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/CommonConfigurationKeys.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/CommonConfigurationKeys.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/CommonConfigurationKeys.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/CommonConfigurationKeys.java Fri Jun 11 21:34:56 2010
@@ -18,12 +18,16 @@
package org.apache.hadoop.fs;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/**
* This class contains constants for configuration keys used
* in the common code.
*
*/
-
+@InterfaceAudience.Private
+@InterfaceStability.Unstable
public class CommonConfigurationKeys {
// The Keys
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/ContentSummary.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/ContentSummary.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/ContentSummary.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/ContentSummary.java Fri Jun 11 21:34:56 2010
@@ -21,9 +21,13 @@ import java.io.DataInput;
import java.io.DataOutput;
import java.io.IOException;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.io.Writable;
/** Store the summary of a content (a directory or a file). */
+@InterfaceAudience.Public
+@InterfaceStability.Evolving
public class ContentSummary implements Writable{
private long length;
private long fileCount;
@@ -72,6 +76,7 @@ public class ContentSummary implements W
public long getSpaceQuota() {return spaceQuota;}
/** {@inheritDoc} */
+ @InterfaceAudience.Private
public void write(DataOutput out) throws IOException {
out.writeLong(length);
out.writeLong(fileCount);
@@ -82,6 +87,7 @@ public class ContentSummary implements W
}
/** {@inheritDoc} */
+ @InterfaceAudience.Private
public void readFields(DataInput in) throws IOException {
this.length = in.readLong();
this.fileCount = in.readLong();
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/CreateFlag.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/CreateFlag.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/CreateFlag.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/CreateFlag.java Fri Jun 11 21:34:56 2010
@@ -17,6 +17,9 @@
*/
package org.apache.hadoop.fs;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/****************************************************************
*CreateFlag specifies the file create semantic. Users can combine flags like:<br>
*<code>
@@ -36,6 +39,8 @@ package org.apache.hadoop.fs;
* <li> append the file if it already exists.
* </ol>
*****************************************************************/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public enum CreateFlag {
/**
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/DF.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/DF.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/DF.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/DF.java Fri Jun 11 21:34:56 2010
@@ -24,6 +24,8 @@ import java.io.BufferedReader;
import java.util.EnumSet;
import java.util.StringTokenizer;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.CommonConfigurationKeys;
import org.apache.hadoop.util.Shell;
@@ -31,6 +33,8 @@ import org.apache.hadoop.util.Shell;
/** Filesystem disk space usage statistics.
* Uses the unix 'df' program to get mount points, and java.io.File for
* space utilization. Tested on Linux, FreeBSD, Cygwin. */
+@InterfaceAudience.LimitedPrivate({"HDFS", "MapReduce"})
+@InterfaceStability.Evolving
public class DF extends Shell {
/** Default DF refresh interval. */
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/DU.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/DU.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/DU.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/DU.java Fri Jun 11 21:34:56 2010
@@ -17,6 +17,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.apache.hadoop.util.Shell;
@@ -26,6 +28,8 @@ import java.io.IOException;
import java.util.concurrent.atomic.AtomicLong;
/** Filesystem disk space usage statistics. Uses the unix 'du' program*/
+@InterfaceAudience.LimitedPrivate({"HDFS", "MapReduce"})
+@InterfaceStability.Evolving
public class DU extends Shell {
private String dirPath;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSDataInputStream.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSDataInputStream.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSDataInputStream.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSDataInputStream.java Fri Jun 11 21:34:56 2010
@@ -19,8 +19,13 @@ package org.apache.hadoop.fs;
import java.io.*;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/** Utility that wraps a {@link FSInputStream} in a {@link DataInputStream}
* and buffers input through a {@link BufferedInputStream}. */
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class FSDataInputStream extends DataInputStream
implements Seekable, PositionedReadable {
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSDataOutputStream.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSDataOutputStream.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSDataOutputStream.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSDataOutputStream.java Fri Jun 11 21:34:56 2010
@@ -19,9 +19,14 @@ package org.apache.hadoop.fs;
import java.io.*;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/** Utility that wraps a {@link OutputStream} in a {@link DataOutputStream},
* buffers output through a {@link BufferedOutputStream} and creates a checksum
* file. */
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class FSDataOutputStream extends DataOutputStream implements Syncable {
private OutputStream wrappedStream;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSError.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSError.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSError.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSError.java Fri Jun 11 21:34:56 2010
@@ -18,8 +18,13 @@
package org.apache.hadoop.fs;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/** Thrown for unexpected filesystem errors, presumed to reflect disk errors
* in the native filesystem. */
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class FSError extends Error {
private static final long serialVersionUID = 1L;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSInputChecker.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSInputChecker.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSInputChecker.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSInputChecker.java Fri Jun 11 21:34:56 2010
@@ -23,6 +23,8 @@ import java.util.zip.Checksum;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.util.StringUtils;
import java.nio.ByteBuffer;
import java.nio.IntBuffer;
@@ -31,7 +33,8 @@ import java.nio.IntBuffer;
* This is a generic input stream for verifying checksums for
* data before it is read by a user.
*/
-
+@InterfaceAudience.LimitedPrivate({"HDFS"})
+@InterfaceStability.Unstable
abstract public class FSInputChecker extends FSInputStream {
public static final Log LOG
= LogFactory.getLog(FSInputChecker.class);
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSInputStream.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSInputStream.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSInputStream.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSInputStream.java Fri Jun 11 21:34:56 2010
@@ -19,11 +19,16 @@ package org.apache.hadoop.fs;
import java.io.*;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/****************************************************************
* FSInputStream is a generic old InputStream with a little bit
* of RAF-style seek ability.
*
*****************************************************************/
+@InterfaceAudience.LimitedPrivate({"HDFS"})
+@InterfaceStability.Unstable
public abstract class FSInputStream extends InputStream
implements Seekable, PositionedReadable {
/**
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSOutputSummer.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSOutputSummer.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSOutputSummer.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FSOutputSummer.java Fri Jun 11 21:34:56 2010
@@ -22,11 +22,15 @@ import java.io.IOException;
import java.io.OutputStream;
import java.util.zip.Checksum;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/**
* This is a generic output stream for generating checksums for
* data before it is written to the underlying stream
*/
-
+@InterfaceAudience.LimitedPrivate({"HDFS"})
+@InterfaceStability.Unstable
abstract public class FSOutputSummer extends OutputStream {
// data checksum
private Checksum sum;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileAlreadyExistsException.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileAlreadyExistsException.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileAlreadyExistsException.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileAlreadyExistsException.java Fri Jun 11 21:34:56 2010
@@ -21,10 +21,15 @@ package org.apache.hadoop.fs;
import java.io.IOException;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/**
* Used when target file already exists for any operation and
* is not configured to be overwritten.
*/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class FileAlreadyExistsException
extends IOException {
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileChecksum.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileChecksum.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileChecksum.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileChecksum.java Fri Jun 11 21:34:56 2010
@@ -19,9 +19,13 @@ package org.apache.hadoop.fs;
import java.util.Arrays;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.io.Writable;
/** An abstract class representing file checksums for files. */
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public abstract class FileChecksum implements Writable {
/** The checksum algorithm name */
public abstract String getAlgorithmName();
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileStatus.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileStatus.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileStatus.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileStatus.java Fri Jun 11 21:34:56 2010
@@ -21,12 +21,16 @@ import java.io.DataInput;
import java.io.DataOutput;
import java.io.IOException;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.fs.permission.FsPermission;
import org.apache.hadoop.io.Text;
import org.apache.hadoop.io.Writable;
/** Interface that represents the client side information for a file.
*/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class FileStatus implements Writable, Comparable {
private Path path = null;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileSystem.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileSystem.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileSystem.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileSystem.java Fri Jun 11 21:34:56 2010
@@ -38,6 +38,8 @@ import java.util.regex.Pattern;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.conf.Configured;
import org.apache.hadoop.fs.Options.CreateOpts;
@@ -67,6 +69,8 @@ import org.apache.hadoop.util.Reflection
* The local implementation is {@link LocalFileSystem} and distributed
* implementation is DistributedFileSystem.
*****************************************************************/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public abstract class FileSystem extends Configured implements Closeable {
public static final String FS_DEFAULT_NAME_KEY =
CommonConfigurationKeys.FS_DEFAULT_NAME_KEY;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileUtil.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileUtil.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileUtil.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FileUtil.java Fri Jun 11 21:34:56 2010
@@ -22,6 +22,9 @@ import java.io.*;
import java.util.Enumeration;
import java.util.zip.ZipEntry;
import java.util.zip.ZipFile;
+
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.io.IOUtils;
import org.apache.hadoop.util.StringUtils;
@@ -34,6 +37,8 @@ import org.apache.commons.logging.LogFac
/**
* A collection of file-processing util methods
*/
+@InterfaceAudience.Public
+@InterfaceStability.Evolving
public class FileUtil {
private static final Log LOG = LogFactory.getLog(FileUtil.class);
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FilterFileSystem.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FilterFileSystem.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FilterFileSystem.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FilterFileSystem.java Fri Jun 11 21:34:56 2010
@@ -22,6 +22,8 @@ import java.io.*;
import java.net.URI;
import java.util.EnumSet;
+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;
import org.apache.hadoop.util.Progressable;
@@ -41,6 +43,8 @@ import org.apache.hadoop.util.Progressab
* and fields.
*
*****************************************************************/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class FilterFileSystem extends FileSystem {
protected FileSystem fs;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsConstants.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsConstants.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsConstants.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsConstants.java Fri Jun 11 21:34:56 2010
@@ -19,9 +19,14 @@ package org.apache.hadoop.fs;
import java.net.URI;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/**
* FileSystem related constants.
*/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public interface FsConstants {
// URI for local filesystem
public static final URI LOCAL_FS_URI = URI.create("file:///");
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsServerDefaults.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsServerDefaults.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsServerDefaults.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsServerDefaults.java Fri Jun 11 21:34:56 2010
@@ -21,6 +21,8 @@ import java.io.DataInput;
import java.io.DataOutput;
import java.io.IOException;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.io.Writable;
import org.apache.hadoop.io.WritableFactories;
import org.apache.hadoop.io.WritableFactory;
@@ -29,6 +31,8 @@ import org.apache.hadoop.io.WritableFact
* Provides server default configuration values to clients.
*
****************************************************/
+@InterfaceAudience.Public
+@InterfaceStability.Evolving
public class FsServerDefaults implements Writable {
static { // register a ctor
@@ -80,6 +84,7 @@ public class FsServerDefaults implements
// /////////////////////////////////////////
// Writable
// /////////////////////////////////////////
+ @InterfaceAudience.Private
public void write(DataOutput out) throws IOException {
out.writeLong(blockSize);
out.writeInt(bytesPerChecksum);
@@ -88,6 +93,7 @@ public class FsServerDefaults implements
out.writeInt(fileBufferSize);
}
+ @InterfaceAudience.Private
public void readFields(DataInput in) throws IOException {
blockSize = in.readLong();
bytesPerChecksum = in.readInt();
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsShell.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsShell.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsShell.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsShell.java Fri Jun 11 21:34:56 2010
@@ -26,6 +26,7 @@ import java.text.SimpleDateFormat;
import java.util.*;
import java.util.zip.GZIPInputStream;
+import org.apache.hadoop.classification.InterfaceAudience;
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.conf.Configured;
import org.apache.hadoop.fs.shell.CommandFormat;
@@ -46,6 +47,7 @@ import org.apache.hadoop.util.ToolRunner
import org.apache.hadoop.util.StringUtils;
/** Provide command line access to a FileSystem. */
+@InterfaceAudience.Private
public class FsShell extends Configured implements Tool {
protected FileSystem fs;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsShellPermissions.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsShellPermissions.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsShellPermissions.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsShellPermissions.java Fri Jun 11 21:34:56 2010
@@ -21,6 +21,8 @@ import java.io.IOException;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.fs.FsShell.CmdHandler;
import org.apache.hadoop.fs.permission.FsPermission;
import org.apache.hadoop.fs.permission.ChmodParser;
@@ -30,6 +32,8 @@ import org.apache.hadoop.fs.permission.C
* This class is the home for file permissions related commands.
* Moved to this separate class since FsShell is getting too large.
*/
+@InterfaceAudience.Private
+@InterfaceStability.Unstable
class FsShellPermissions {
/*========== chmod ==========*/
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsStatus.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsStatus.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsStatus.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsStatus.java Fri Jun 11 21:34:56 2010
@@ -21,11 +21,15 @@ import java.io.DataInput;
import java.io.DataOutput;
import java.io.IOException;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.io.Writable;
/** This class is used to represent the capacity, free and used space on a
* {@link FileSystem}.
*/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class FsStatus implements Writable {
private long capacity;
private long used;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlConnection.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlConnection.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlConnection.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlConnection.java Fri Jun 11 21:34:56 2010
@@ -23,11 +23,15 @@ import java.net.URISyntaxException;
import java.net.URL;
import java.net.URLConnection;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.conf.Configuration;
/**
* Representation of a URL connection to open InputStreams.
*/
+@InterfaceAudience.Private
+@InterfaceStability.Unstable
class FsUrlConnection extends URLConnection {
private Configuration conf;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlStreamHandler.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlStreamHandler.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlStreamHandler.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlStreamHandler.java Fri Jun 11 21:34:56 2010
@@ -21,12 +21,16 @@ import java.io.IOException;
import java.net.URL;
import java.net.URLStreamHandler;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.conf.Configuration;
/**
* URLStream handler relying on FileSystem and on a given Configuration to
* handle URL protocols.
*/
+@InterfaceAudience.Private
+@InterfaceStability.Unstable
class FsUrlStreamHandler extends URLStreamHandler {
private Configuration conf;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlStreamHandlerFactory.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlStreamHandlerFactory.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlStreamHandlerFactory.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/FsUrlStreamHandlerFactory.java Fri Jun 11 21:34:56 2010
@@ -21,6 +21,8 @@ import java.net.URLStreamHandlerFactory;
import java.util.HashMap;
import java.util.Map;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.conf.Configuration;
/**
@@ -33,6 +35,8 @@ import org.apache.hadoop.conf.Configurat
* Before returning our handler, we make sure that FileSystem knows an
* implementation for the requested scheme/protocol.
*/
+@InterfaceAudience.Private
+@InterfaceStability.Unstable
public class FsUrlStreamHandlerFactory implements
URLStreamHandlerFactory {
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/GlobExpander.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/GlobExpander.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/GlobExpander.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/GlobExpander.java Fri Jun 11 21:34:56 2010
@@ -21,6 +21,11 @@ import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
+@InterfaceAudience.Private
+@InterfaceStability.Unstable
class GlobExpander {
static class StringWithOffset {
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/InvalidPathException.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/InvalidPathException.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/InvalidPathException.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/InvalidPathException.java Fri Jun 11 21:34:56 2010
@@ -18,11 +18,15 @@
package org.apache.hadoop.fs;
import org.apache.hadoop.HadoopIllegalArgumentException;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
/**
* Path string is invalid either because it has invalid characters or due to
* other file system specific reasons.
*/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class InvalidPathException extends HadoopIllegalArgumentException {
private static final long serialVersionUID = 1L;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalDirAllocator.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalDirAllocator.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalDirAllocator.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalDirAllocator.java Fri Jun 11 21:34:56 2010
@@ -27,6 +27,8 @@ import org.apache.hadoop.util.*;
import org.apache.hadoop.fs.FileSystem;
import org.apache.hadoop.fs.Path;
import org.apache.hadoop.util.DiskChecker.DiskErrorException;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.conf.Configuration;
/** An implementation of a round-robin scheme for disk allocation for creating
@@ -60,6 +62,8 @@ import org.apache.hadoop.conf.Configurat
* actually points to the configured directory on the Disk which will be the
* parent for all file write/read allocations.
*/
+@InterfaceAudience.LimitedPrivate({"HDFS", "MapReduce"})
+@InterfaceStability.Unstable
public class LocalDirAllocator {
//A Map from the config item names like "mapred.local.dir",
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalFileSystem.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalFileSystem.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalFileSystem.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalFileSystem.java Fri Jun 11 21:34:56 2010
@@ -22,10 +22,15 @@ import java.io.*;
import java.net.URI;
import java.util.*;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/****************************************************************
* Implement the FileSystem API for the checksumed local filesystem.
*
*****************************************************************/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class LocalFileSystem extends ChecksumFileSystem {
static final URI NAME = URI.create("file:///");
static private Random rand = new Random();
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalFileSystemConfigKeys.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalFileSystemConfigKeys.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalFileSystemConfigKeys.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/LocalFileSystemConfigKeys.java Fri Jun 11 21:34:56 2010
@@ -18,12 +18,16 @@
package org.apache.hadoop.fs;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/**
* This class contains constants for configuration keys used
* in the local file system, raw local fs and checksum fs.
*
*/
-
+@InterfaceAudience.Private
+@InterfaceStability.Unstable
public class LocalFileSystemConfigKeys extends CommonConfigurationKeys {
public static final String LOCAL_FS_BLOCK_SIZE_KEY = "file.blocksize";
public static final long LOCAL_FS_BLOCK_SIZE_DEFAULT = 64*1024*1024;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/MD5MD5CRC32FileChecksum.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/MD5MD5CRC32FileChecksum.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/MD5MD5CRC32FileChecksum.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/MD5MD5CRC32FileChecksum.java Fri Jun 11 21:34:56 2010
@@ -21,6 +21,8 @@ import java.io.DataInput;
import java.io.DataOutput;
import java.io.IOException;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.io.MD5Hash;
import org.apache.hadoop.io.WritableUtils;
import org.xml.sax.Attributes;
@@ -28,6 +30,8 @@ import org.xml.sax.SAXException;
import org.znerd.xmlenc.XMLOutputter;
/** MD5 of MD5 of CRC32. */
+@InterfaceAudience.LimitedPrivate({"HDFS"})
+@InterfaceStability.Unstable
public class MD5MD5CRC32FileChecksum extends FileChecksum {
public static final int LENGTH = MD5Hash.MD5_LEN
+ (Integer.SIZE + Long.SIZE)/Byte.SIZE;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/Options.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/Options.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/Options.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/Options.java Fri Jun 11 21:34:56 2010
@@ -17,12 +17,16 @@
*/
package org.apache.hadoop.fs;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.fs.permission.FsPermission;
import org.apache.hadoop.util.Progressable;
/**
* This class contains options related to file system operations.
*/
+@InterfaceAudience.Public
+@InterfaceStability.Evolving
public final class Options {
/**
* Class to support the varargs for create() options.
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/ParentNotDirectoryException.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/ParentNotDirectoryException.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/ParentNotDirectoryException.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/ParentNotDirectoryException.java Fri Jun 11 21:34:56 2010
@@ -19,10 +19,15 @@ package org.apache.hadoop.fs;
import java.io.IOException;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/**
* Indicates that the parent of specified Path is not a directory
* as expected.
*/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class ParentNotDirectoryException extends IOException {
private static final long serialVersionUID = 1L;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/Path.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/Path.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/Path.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/Path.java Fri Jun 11 21:34:56 2010
@@ -22,6 +22,8 @@ import java.net.*;
import java.io.*;
import org.apache.avro.reflect.Stringable;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.conf.Configuration;
/** Names a file or directory in a {@link FileSystem}.
@@ -29,6 +31,8 @@ import org.apache.hadoop.conf.Configurat
* absolute if it begins with a slash.
*/
@Stringable
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class Path implements Comparable {
/** The directory separator, a slash. */
@@ -306,6 +310,7 @@ public class Path implements Comparable
/** Returns a qualified path object. */
+ @InterfaceAudience.LimitedPrivate({"HDFS", "MapReduce"})
public Path makeQualified(URI defaultUri, Path workingDir ) {
Path path = this;
if (!isAbsolute()) {
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/PathFilter.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/PathFilter.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/PathFilter.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/PathFilter.java Fri Jun 11 21:34:56 2010
@@ -17,6 +17,11 @@
*/
package org.apache.hadoop.fs;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public interface PathFilter {
/**
* Tests whether or not the specified abstract pathname should be
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/PositionedReadable.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/PositionedReadable.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/PositionedReadable.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/PositionedReadable.java Fri Jun 11 21:34:56 2010
@@ -18,9 +18,14 @@
package org.apache.hadoop.fs;
import java.io.*;
+
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.fs.*;
/** Stream that permits positional reading. */
+@InterfaceAudience.Public
+@InterfaceStability.Evolving
public interface PositionedReadable {
/**
* Read upto the specified number of bytes, from a given
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/RawLocalFileSystem.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/RawLocalFileSystem.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/RawLocalFileSystem.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/RawLocalFileSystem.java Fri Jun 11 21:34:56 2010
@@ -31,6 +31,8 @@ import java.nio.ByteBuffer;
import java.util.EnumSet;
import java.util.StringTokenizer;
+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;
import org.apache.hadoop.util.Progressable;
@@ -41,6 +43,8 @@ import org.apache.hadoop.util.StringUtil
* Implement the FileSystem API for the raw local filesystem.
*
*****************************************************************/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class RawLocalFileSystem extends FileSystem {
static final URI NAME = URI.create("file:///");
private Path workingDir;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/Seekable.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/Seekable.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/Seekable.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/Seekable.java Fri Jun 11 21:34:56 2010
@@ -19,7 +19,12 @@ package org.apache.hadoop.fs;
import java.io.*;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/** Stream that permits seeking. */
+@InterfaceAudience.Public
+@InterfaceStability.Evolving
public interface Seekable {
/**
* Seek to the given offset from the start of the file.
@@ -37,5 +42,6 @@ public interface Seekable {
* Seeks a different copy of the data. Returns true if
* found a new source, false otherwise.
*/
+ @InterfaceAudience.Private
boolean seekToNewSource(long targetPos) throws IOException;
}
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/Syncable.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/Syncable.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/Syncable.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/Syncable.java Fri Jun 11 21:34:56 2010
@@ -20,7 +20,12 @@ package org.apache.hadoop.fs;
import java.io.IOException;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/** This interface for flush/sync operation. */
+@InterfaceAudience.Public
+@InterfaceStability.Evolving
public interface Syncable {
/**
* @deprecated As of HADOOP 0.21.0, replaced by hflush
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/Trash.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/Trash.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/Trash.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/Trash.java Fri Jun 11 21:34:56 2010
@@ -26,6 +26,8 @@ import java.util.Date;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.conf.Configured;
import static org.apache.hadoop.fs.CommonConfigurationKeys.*;
@@ -42,6 +44,8 @@ import org.apache.hadoop.util.StringUtil
* content, without date support in the filesystem, and without clock
* synchronization.)
*/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class Trash extends Configured {
private static final Log LOG =
LogFactory.getLog(Trash.class);
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/UnresolvedLinkException.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/UnresolvedLinkException.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/UnresolvedLinkException.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/UnresolvedLinkException.java Fri Jun 11 21:34:56 2010
@@ -21,11 +21,13 @@ package org.apache.hadoop.fs;
import java.io.IOException;
import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
/**
* Thrown when a symbolic link is encountered in a path.
*/
@InterfaceAudience.LimitedPrivate({"HDFS"})
+@InterfaceStability.Stable
public class UnresolvedLinkException extends IOException {
private static final long serialVersionUID = 1L;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/UnsupportedFileSystemException.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/UnsupportedFileSystemException.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/UnsupportedFileSystemException.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/UnsupportedFileSystemException.java Fri Jun 11 21:34:56 2010
@@ -19,9 +19,14 @@ package org.apache.hadoop.fs;
import java.io.IOException;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/**
* File system for a given file system name/scheme is not supported
*/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class UnsupportedFileSystemException extends IOException {
private static final long serialVersionUID = 1L;
Modified: hadoop/common/trunk/src/java/org/apache/hadoop/fs/ftp/FTPException.java
URL: http://svn.apache.org/viewvc/hadoop/common/trunk/src/java/org/apache/hadoop/fs/ftp/FTPException.java?rev=953881&r1=953880&r2=953881&view=diff
==============================================================================
--- hadoop/common/trunk/src/java/org/apache/hadoop/fs/ftp/FTPException.java (original)
+++ hadoop/common/trunk/src/java/org/apache/hadoop/fs/ftp/FTPException.java Fri Jun 11 21:34:56 2010
@@ -17,9 +17,14 @@
*/
package org.apache.hadoop.fs.ftp;
+import org.apache.hadoop.classification.InterfaceAudience;
+import org.apache.hadoop.classification.InterfaceStability;
+
/**
* A class to wrap a {@link Throwable} into a Runtime Exception.
*/
+@InterfaceAudience.Public
+@InterfaceStability.Stable
public class FTPException extends RuntimeException {
private static final long serialVersionUID = 1L;