Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
com.amazonaws.services.s3.model.ProgressListener Use ProgressListener instead. Using this class is dangerous as it uses the deprecated ProgressEvent, which performs an unsafe cast from long to int in ProgressEvent.getBytesTransfered().

Deprecated Classes

Class and Description
com.amazonaws.services.s3.internal.AbstractRepeatableCipherInputStream this class is no longer used and will be removed in the future Common base class used to wrap an InputStream with a cipher input stream to encrypt it, and handles resets by attempting to reset on the original, unencrypted data InputStream, and recreate an identical Cipher and identical CipherInputStream on the original data. It's repeatable if and only if the underlying unencryptedDataStream is repeatable - if the underlying input stream is not repeatable and you're going to buffer to make it repeatable anyways, it makes more sense to do so after wrapping in this object, so we buffer the encrypted data and don't have to bother re-encrypting on retry. This stream only supports being marked before the first call to read or skip, since it's not possible to rewind the encryption state of a CipherInputStream to an arbitrary point. If you call mark after calling read or skip, it will throw an UnsupportedOperationException.
com.amazonaws.services.s3.model.BucketNotificationConfiguration.TopicConfiguration Use TopicConfiguration instead
com.amazonaws.services.s3.model.CloudFunctionConfiguration use LambdaConfiguration instead
com.amazonaws.services.s3.model.LegacyS3ProgressListener
com.amazonaws.services.s3.model.ProgressEvent Replaced by ProgressEvent
com.amazonaws.services.s3.internal.RepeatableFileInputStream by ResettableInputStream and this class will be removed in future releases. A repeatable input stream for files. This input stream can be repeated an unlimited number of times, without any limitation on when a repeat can occur.
com.amazonaws.services.s3.internal.RepeatableInputStream by SdkBufferedInputStream. A repeatable input stream wrapper for any input stream. This input stream relies on buffered data to repeat, and can therefore only be repeated when less data has been read than this buffer can hold. Note: Always use a ResettableInputStream instead of this class if you are sourcing data from a file, as the file-based repeatable input stream can be repeated without any limitations.

Deprecated Fields

Field and Description
com.amazonaws.services.s3.internal.ServiceUtils.dateUtils
com.amazonaws.services.s3.model.InstructionFileId.DEFAULT_INSTURCTION_FILE_SUFFIX

Deprecated Methods

Method and Description
com.amazonaws.services.s3.model.NotificationConfiguration.addObjectPrefix(String) This field is not used by S3. It will be removed in the next major version of the SDK
com.amazonaws.services.s3.transfer.Transfer.addProgressListener(ProgressListener) Replaced by Transfer.addProgressListener(ProgressListener)
com.amazonaws.services.s3.transfer.internal.AbstractTransfer.addProgressListener(ProgressListener) Replaced by AbstractTransfer.addProgressListener(ProgressListener)
com.amazonaws.services.s3.AmazonS3.changeObjectStorageClass(String, String, StorageClass) this operation will not retain the ACL's or SSE parameters associated with the given Amazon S3 object. Use AmazonS3.copyObject(CopyObjectRequest) instead.
com.amazonaws.services.s3.internal.ServiceUtils.convertRequestToUrl(Request<?>) No longer used. May be removed in a future major version.
com.amazonaws.services.s3.internal.ServiceUtils.convertRequestToUrl(Request<?>, boolean) No longer used. May be removed in a future major version.
com.amazonaws.services.s3.AmazonS3Client.createBucket(String, Region)
com.amazonaws.services.s3.AmazonS3.createBucket(String, Region) Use regional endpoint and call AmazonS3.createBucket(String) instead.
com.amazonaws.services.s3.AmazonS3Client.createBucket(String, String)
com.amazonaws.services.s3.AmazonS3.createBucket(String, String) Use regional endpoint and call AmazonS3.createBucket(String) instead.
com.amazonaws.services.s3.S3ClientOptions.disableChunkedEncoding() Use S3ClientOptions.builder() to build new S3ClientOptions instead.
com.amazonaws.services.s3.AmazonS3.doesBucketExist(String) By AmazonS3.doesBucketExistV2(String) which will correctly throw an exception when credentials are invalid instead of returning true. See Issue #1256.
com.amazonaws.services.s3.model.SetBucketNotificationConfigurationRequest.getBucket() Use getBucketName() instead.
com.amazonaws.services.s3.model.GenericBucketRequest.getBucket() Use getBucketName() instead.
com.amazonaws.services.s3.model.SetBucketNotificationConfigurationRequest.getBucketNotificationConfiguration() Use getNotificationConfiguration() instead.
com.amazonaws.services.s3.transfer.TransferProgress.getBytesTransfered() Replaced by TransferProgress.getBytesTransferred()
com.amazonaws.services.s3.model.ProgressEvent.getBytesTransfered() Replaced by ProgressEvent.getBytesTransferred(). This method SHOULD NEVER be used as it can lead to integer overflow if the number of bytes transferred was greater than Integer.MAX_VALUE.
com.amazonaws.services.s3.model.BucketNotificationConfiguration.TopicConfiguration.getEvent() use NotificationConfiguration.getEvents() instead.
com.amazonaws.services.s3.model.AccessControlList.getGrants() This will remove the duplicate grants if received from Amazon S3. Use AccessControlList.getGrantsAsList() instead.
com.amazonaws.services.s3.model.CryptoConfiguration.getKmsRegion()
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.getNoncurrentVersionTransition()
com.amazonaws.services.s3.model.NotificationConfiguration.getObjectPrefixes() This field is not used by S3. It will be removed in the next major version of the SDK. See NotificationConfiguration.getFilter() for the correct way to filter notifications.
com.amazonaws.services.s3.transfer.TransferProgress.getPercentTransfered() Replaced by TransferProgress.getPercentTransferred()
com.amazonaws.services.s3.model.ReplicationRule.getPrefix() Use ReplicationFilter instead.
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.getPrefix() The method returns prefix only if was was set using BucketLifecycleConfiguration.Rule.setPrefix(String). Otherwise, Use LifecycleFilter.
com.amazonaws.services.s3.model.GetObjectRequest.getProgressListener() use AmazonWebServiceRequest.getGeneralProgressListener() instead.
com.amazonaws.services.s3.model.UploadPartRequest.getProgressListener() use AmazonWebServiceRequest.getGeneralProgressListener() instead.
com.amazonaws.services.s3.model.AbstractPutObjectRequest.getProgressListener() use AmazonWebServiceRequest.getGeneralProgressListener() instead.
com.amazonaws.services.s3.model.CreateBucketRequest.getRegion()
com.amazonaws.services.s3.internal.SSEResultBase.getServerSideEncryption() Replaced by SSEResultBase.getSSEAlgorithm()
com.amazonaws.services.s3.model.ObjectMetadata.getServerSideEncryption() Replaced by ObjectMetadata.getSSEAlgorithm()
com.amazonaws.services.s3.event.S3EventNotification.S3ObjectEntity.getSize() use S3EventNotification.S3ObjectEntity.getSizeAsLong() instead.
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Transition.getStorageClass() This method should not be used. Use BucketLifecycleConfiguration.Transition.getStorageClassAsString() instead.
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.NoncurrentVersionTransition.getStorageClass() This method should not be used. Use BucketLifecycleConfiguration.NoncurrentVersionTransition.getStorageClassAsString() instead.
com.amazonaws.services.s3.internal.Constants.getStreamBufferSize()
com.amazonaws.services.s3.model.BucketNotificationConfiguration.getTopicConfigurations()
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.getTransition()
com.amazonaws.services.s3.transfer.Transfer.removeProgressListener(ProgressListener) Replaced by Transfer.removeProgressListener(ProgressListener)
com.amazonaws.services.s3.transfer.internal.AbstractTransfer.removeProgressListener(ProgressListener) Replaced by AbstractTransfer.removeProgressListener(ProgressListener)
com.amazonaws.services.s3.AmazonS3.restoreObject(RestoreObjectRequest) use AmazonS3.restoreObjectV2(RestoreObjectRequest)
com.amazonaws.services.s3.AmazonS3.restoreObject(String, String, int) use AmazonS3.restoreObjectV2(RestoreObjectRequest)
com.amazonaws.services.s3.model.SetBucketNotificationConfigurationRequest.setBucket(String) Use setBucketName(String) instead.
com.amazonaws.services.s3.model.SetBucketNotificationConfigurationRequest.setBucketNotificationConfiguration(BucketNotificationConfiguration) Use setNotificationConfiguration(BucketNotificationConfiguration) instead.
com.amazonaws.services.s3.S3ClientOptions.setChunkedEncodingDisabled(boolean) Use S3ClientOptions.builder() to build new S3ClientOptions instead.
com.amazonaws.services.s3.transfer.TransferManager.setConfiguration(TransferManagerConfiguration) use appropriate method on the TransferManagerBuilder for example: TransferManagerBuilder.standard().withMinimumUploadPartSize(100L).build();
com.amazonaws.services.s3.AmazonS3Client.setEndpoint(String) use AwsClientBuilder.setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration)
com.amazonaws.services.s3.model.CryptoConfiguration.setKmsRegion(Regions)
com.amazonaws.services.s3.transfer.TransferManagerConfiguration.setMultipartUploadThreshold(int) replaced by TransferManagerConfiguration.setMultipartUploadThreshold(long)
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.setNoncurrentVersionTransition(BucketLifecycleConfiguration.NoncurrentVersionTransition)
com.amazonaws.services.s3.model.NotificationConfiguration.setObjectPrefixes(List<String>) This field is not used by S3. It will be removed in the next major version of the SDK. See NotificationConfiguration.setFilter(Filter) for the correct way to filter notifications.
com.amazonaws.services.s3.AmazonS3.setObjectRedirectLocation(String, String, String) this operation will not retain the ACL's or SSE parameters associated with the given Amazon S3 object. Use AmazonS3.copyObject(CopyObjectRequest) instead.
com.amazonaws.services.s3.S3ClientOptions.setPathStyleAccess(boolean) Use S3ClientOptions.builder() to build new S3ClientOptions instead.
com.amazonaws.services.s3.model.ReplicationRule.setPrefix(String) Use ReplicationFilter.
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.setPrefix(String) Use LifecycleFilter instead.
com.amazonaws.services.s3.model.GetObjectRequest.setProgressListener(ProgressListener) use AmazonWebServiceRequest.setGeneralProgressListener(ProgressListener) instead.
com.amazonaws.services.s3.model.UploadPartRequest.setProgressListener(ProgressListener) use AmazonWebServiceRequest.setGeneralProgressListener(ProgressListener) instead.
com.amazonaws.services.s3.model.AbstractPutObjectRequest.setProgressListener(ProgressListener) use AmazonWebServiceRequest.setGeneralProgressListener(ProgressListener) instead.
com.amazonaws.services.s3.AmazonS3Client.setRegion(Region) use AwsClientBuilder.setRegion(String)
com.amazonaws.services.s3.model.CreateBucketRequest.setRegion(String) Use regional client instead to create bucket in that region.
com.amazonaws.services.s3.model.ObjectMetadata.setServerSideEncryption(String) Replaced by ObjectMetadata.setSSEAlgorithm(String)
com.amazonaws.services.s3.model.BucketNotificationConfiguration.setTopicConfigurations(Collection<BucketNotificationConfiguration.TopicConfiguration>)
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.setTransition(BucketLifecycleConfiguration.Transition)
com.amazonaws.services.s3.S3ClientOptions.withChunkedEncodingDisabled(boolean) Use S3ClientOptions.builder() to build new S3ClientOptions instead.
com.amazonaws.services.s3.model.CryptoConfiguration.withKmsRegion(Regions)
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.withNoncurrentVersionTransition(BucketLifecycleConfiguration.NoncurrentVersionTransition)
com.amazonaws.services.s3.model.NotificationConfiguration.withObjectPrefixes(String...) This field is not used by S3. It will be removed in the next major version of the SDK. See NotificationConfiguration.withFilter(Filter) for the correct way to filter notifications.
com.amazonaws.services.s3.S3ClientOptions.withPathStyleAccess(boolean) Use S3ClientOptions.builder() to build new S3ClientOptions instead.
com.amazonaws.services.s3.model.ReplicationRule.withPrefix(String) Use ReplicationFilter.
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.withPrefix(String) Use LifecycleFilter instead.
com.amazonaws.services.s3.model.GetObjectRequest.withProgressListener(ProgressListener) use AmazonWebServiceRequest.withGeneralProgressListener(ProgressListener) instead.
com.amazonaws.services.s3.model.UploadPartRequest.withProgressListener(ProgressListener) use AmazonWebServiceRequest.withGeneralProgressListener(ProgressListener) instead.
com.amazonaws.services.s3.model.PutObjectRequest.withProgressListener(ProgressListener)
com.amazonaws.services.s3.model.AbstractPutObjectRequest.withProgressListener(ProgressListener) use AmazonWebServiceRequest.withGeneralProgressListener(ProgressListener) instead.
com.amazonaws.services.s3.model.BucketNotificationConfiguration.withTopicConfigurations(BucketNotificationConfiguration.TopicConfiguration...)
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.withTransition(BucketLifecycleConfiguration.Transition)

Deprecated Constructors

Constructor and Description
com.amazonaws.services.s3.AmazonS3Client() use AmazonS3ClientBuilder.defaultClient()
com.amazonaws.services.s3.AmazonS3Client(AWSCredentials) use AwsClientBuilder.withCredentials(AWSCredentialsProvider)
com.amazonaws.services.s3.AmazonS3Client(AWSCredentials, ClientConfiguration) use AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AwsClientBuilder.withClientConfiguration(ClientConfiguration)
com.amazonaws.services.s3.AmazonS3Client(AWSCredentialsProvider) use AwsClientBuilder.withCredentials(AWSCredentialsProvider)
com.amazonaws.services.s3.AmazonS3Client(AWSCredentialsProvider, ClientConfiguration) use AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AwsClientBuilder.withClientConfiguration(ClientConfiguration)
com.amazonaws.services.s3.AmazonS3Client(AWSCredentialsProvider, ClientConfiguration, RequestMetricCollector) use AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AwsClientBuilder.withClientConfiguration(ClientConfiguration) and AwsClientBuilder.withMetricsCollector(RequestMetricCollector)
com.amazonaws.services.s3.AmazonS3Client(ClientConfiguration) use AwsClientBuilder.withClientConfiguration(ClientConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentials, EncryptionMaterials) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentials, EncryptionMaterials, ClientConfiguration, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration) and AwsClientBuilder.withClientConfiguration(ClientConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentials, EncryptionMaterials, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentials, EncryptionMaterialsProvider) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentials, EncryptionMaterialsProvider, ClientConfiguration, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration) and AwsClientBuilder.withClientConfiguration(ClientConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentials, EncryptionMaterialsProvider, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentialsProvider, EncryptionMaterialsProvider) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentialsProvider, EncryptionMaterialsProvider, ClientConfiguration, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration) and AwsClientBuilder.withClientConfiguration(ClientConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentialsProvider, EncryptionMaterialsProvider, ClientConfiguration, CryptoConfiguration, RequestMetricCollector) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration) and AwsClientBuilder.withClientConfiguration(ClientConfiguration) and AwsClientBuilder.withMetricsCollector(RequestMetricCollector)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentialsProvider, EncryptionMaterialsProvider, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSKMSClient, AWSCredentialsProvider, EncryptionMaterialsProvider, ClientConfiguration, CryptoConfiguration, RequestMetricCollector) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration) and AwsClientBuilder.withClientConfiguration(ClientConfiguration) and AwsClientBuilder.withMetricsCollector(RequestMetricCollector) and AmazonS3EncryptionClientBuilder.withKmsClient(AWSKMS)
com.amazonaws.services.s3.AmazonS3EncryptionClient(EncryptionMaterials) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider)
com.amazonaws.services.s3.AmazonS3EncryptionClient(EncryptionMaterials, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(EncryptionMaterialsProvider) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider)
com.amazonaws.services.s3.AmazonS3EncryptionClient(EncryptionMaterialsProvider, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration)
com.amazonaws.services.s3.model.BucketNotificationConfiguration(Collection<BucketNotificationConfiguration.TopicConfiguration>)
com.amazonaws.services.s3.transfer.internal.DownloadImpl(String, TransferProgress, ProgressListenerChain, S3Object, TransferStateChangeListener, GetObjectRequest, File)
com.amazonaws.services.s3.S3ClientOptions() Use S3ClientOptions.builder() to build new S3ClientOptions instead.
com.amazonaws.services.s3.S3ClientOptions(S3ClientOptions) Will be removed once S3ClientOptions is made an immutable class.
com.amazonaws.services.s3.event.S3EventNotification.S3EventNotificationRecord(String, String, String, String, String, S3EventNotification.RequestParametersEntity, S3EventNotification.ResponseElementsEntity, S3EventNotification.S3Entity, S3EventNotification.UserIdentityEntity)
com.amazonaws.services.s3.event.S3EventNotification.S3ObjectEntity(String, Integer, String, String)
com.amazonaws.services.s3.event.S3EventNotification.S3ObjectEntity(String, Long, String, String)
com.amazonaws.services.s3.model.SetBucketNotificationConfigurationRequest(BucketNotificationConfiguration, String) Use SetBucketNotificationConfigurationRequest(String, BucketNotificationConfiguration) instead.
com.amazonaws.services.s3.transfer.TransferManager() use TransferManagerBuilder.defaultTransferManager()
com.amazonaws.services.s3.transfer.TransferManager(AmazonS3) use TransferManagerBuilder.withS3Client(AmazonS3)
com.amazonaws.services.s3.transfer.TransferManager(AmazonS3, ExecutorService) use TransferManagerBuilder.withS3Client(AmazonS3) and TransferManagerBuilder.withExecutorFactory(com.amazonaws.client.builder.ExecutorFactory)
com.amazonaws.services.s3.transfer.TransferManager(AmazonS3, ExecutorService, boolean) use TransferManagerBuilder.withS3Client(AmazonS3) and TransferManagerBuilder.withExecutorFactory(com.amazonaws.client.builder.ExecutorFactory) and TransferManagerBuilder.withShutDownThreadPools(Boolean)
com.amazonaws.services.s3.transfer.TransferManager(AWSCredentials) use TransferManagerBuilder.withS3Client(AmazonS3) for example: TransferManagerBuilder.standard().withS3Client(AmazonS3ClientBuilder.standard.withCredentials(credentials).build()).build();
com.amazonaws.services.s3.transfer.TransferManager(AWSCredentialsProvider) use TransferManagerBuilder.withS3Client(AmazonS3) for example: TransferManagerBuilder.standard().withS3Client(AmazonS3ClientBuilder.standard.withCredentials(credentialsProvider).build()).build();