#include </data/code/userver/libraries/s3api/src/s3api/clients/client.hpp>

Detailed Description

Implementation of S3 client.

Definition at line 35 of file client.hpp.

Inheritance diagram for s3api::ClientImpl:

Public Types
using	CiUnorderedMap = ::http::headers::HeaderMap
using	Meta = CiUnorderedMap
using	Headers = CiUnorderedMap

Public Member Functions
	ClientImpl (std::shared_ptr< S3Connection > s3conn, std::shared_ptr< authenticators::Authenticator > authenticator, std::string bucket)
	ClientImpl (std::shared_ptr< S3Connection > s3conn, std::shared_ptr< authenticators::AccessKey > authenticator, std::string bucket)
std::string	PutObject (std::string_view path, std::string data, const std::optional< Meta > &meta, std::string_view content_type, const std::optional< std::string > &content_disposition, const std::optional< std::vector< Tag > > &tags) const final
void	DeleteObject (std::string_view path) const final
std::optional< std::string >	GetObject (std::string_view path, std::optional< std::string > versiong, HeadersDataResponse *headers_data, const HeaderDataRequest &headers_request) const final
std::string	TryGetObject (std::string_view path, std::optional< std::string > versiong, HeadersDataResponse *headers_data, const HeaderDataRequest &headers_request) const final
std::optional< std::string >	GetPartialObject (std::string_view path, std::string_view range, std::optional< std::string > versiong, HeadersDataResponse *headers_data, const HeaderDataRequest &headers_request) const final
std::string	TryGetPartialObject (std::string_view path, std::string_view range, std::optional< std::string > versiong, HeadersDataResponse *headers_data, const HeaderDataRequest &headers_request) const final
std::string	CopyObject (std::string_view key_from, std::string_view bucket_to, std::string_view key_to, const std::optional< Meta > &meta) final
std::string	CopyObject (std::string_view key_from, std::string_view key_to, const std::optional< Meta > &meta) final
std::optional< HeadersDataResponse >	GetObjectHead (std::string_view path, const HeaderDataRequest &request) const final
std::string	GenerateDownloadUrl (std::string_view path, time_t expires, bool use_ssl) const final
std::string	GenerateDownloadUrlVirtualHostAddressing (std::string_view path, const std::chrono::system_clock::time_point &expires_at, std::string_view protocol) const final
std::string	GenerateUploadUrlVirtualHostAddressing (std::string_view data, std::string_view content_type, std::string_view path, const std::chrono::system_clock::time_point &expires_at, std::string_view protocol) const final
std::optional< std::string >	ListBucketContents (std::string_view path, int max_keys, std::string marker, std::string delimiter) const final
std::vector< ObjectMeta >	ListBucketContentsParsed (std::string_view path_prefix) const final
std::vector< std::string >	ListBucketDirectories (std::string_view path_prefix) const final
multipart_upload::InitiateMultipartUploadResult	CreateMultipartUpload (const multipart_upload::CreateMultipartUploadRequest &request) const final
	Initiate a multipart upload sequence Performs a CreateMultipartUpload S3 Action. Returns result with upload ID which is used to associate all of the parts in the specific multipart upload. You specify this upload ID in each of your subsequent upload part requests For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html.
multipart_upload::UploadPartResult	UploadPart (const multipart_upload::UploadPartRequest &request) const final
	Upload a part in a multipart upload sequence. Performs an UploadPart S3 Action. Returns ETag value which you must include in the subsequent request to complete the multipart upload. For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html.
multipart_upload::CompleteMultipartUploadResult	CompleteMultipartUpload (const multipart_upload::CompleteMultipartUploadRequest &request) const final
	Complete a multipart upload by assembling previously uploaded parts. Performs a CompleteMultipartUpload S3 Action. For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html.
void	AbortMultipartUpload (const multipart_upload::AbortMultipartUploadRequest &request) const final
	Abort a multipart upload sequence. Performs an AbortMultipartUpload S3 Action. For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html.
multipart_upload::ListPartsResult	ListParts (const multipart_upload::ListPartsRequest &request) const final
	List the parts that have been uploaded for a specific multipart upload. Performs a ListParts S3 Action. For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html.
multipart_upload::ListMultipartUploadsResult	ListMultipartUploads (const multipart_upload::ListMultipartUploadsRequest &request) const final
	List in-progress multipart uploads in a bucket Performs a ListMultipartUploads S3 Action. For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html.
void	UpdateConfig (ConnectionCfg &&config) final
std::string_view	GetBucketName () const final

Member Typedef Documentation

◆ CiUnorderedMap

using s3api::Client::CiUnorderedMap = ::http::headers::HeaderMap

inherited

Definition at line 76 of file s3api.hpp.

◆ Headers

using s3api::Client::Headers = CiUnorderedMap

inherited

Definition at line 78 of file s3api.hpp.

◆ Meta

using s3api::Client::Meta = CiUnorderedMap

inherited

Definition at line 77 of file s3api.hpp.

Constructor & Destructor Documentation

◆ ClientImpl() [1/2]

s3api::ClientImpl::ClientImpl	(	std::shared_ptr< S3Connection >	s3conn,
		std::shared_ptr< authenticators::Authenticator >	authenticator,
		std::string	bucket )

Definition at line 171 of file client.cpp.

◆ ClientImpl() [2/2]

s3api::ClientImpl::ClientImpl	(	std::shared_ptr< S3Connection >	s3conn,
		std::shared_ptr< authenticators::AccessKey >	authenticator,
		std::string	bucket )

Definition at line 181 of file client.cpp.

Member Function Documentation

◆ AbortMultipartUpload()

void s3api::ClientImpl::AbortMultipartUpload ( const multipart_upload::AbortMultipartUploadRequest & request ) const

finalvirtual

Abort a multipart upload sequence. Performs an AbortMultipartUpload S3 Action. For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html.

Implements s3api::Client.

Definition at line 584 of file client.cpp.

◆ CompleteMultipartUpload()

multipart_upload::CompleteMultipartUploadResult s3api::ClientImpl::CompleteMultipartUpload ( const multipart_upload::CompleteMultipartUploadRequest & request ) const

finalvirtual

Complete a multipart upload by assembling previously uploaded parts. Performs a CompleteMultipartUpload S3 Action. For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html.

Implements s3api::Client.

Definition at line 568 of file client.cpp.

◆ CopyObject() [1/2]

std::string s3api::ClientImpl::CopyObject	(	std::string_view	key_from,
		std::string_view	bucket_to,
		std::string_view	key_to,
		const std::optional< Meta > &	meta )

finalvirtual

Implements s3api::Client.

Definition at line 480 of file client.cpp.

◆ CopyObject() [2/2]

std::string s3api::ClientImpl::CopyObject	(	std::string_view	key_from,
		std::string_view	key_to,
		const std::optional< Meta > &	meta )

finalvirtual

Implements s3api::Client.

Definition at line 518 of file client.cpp.

◆ CreateMultipartUpload()

multipart_upload::InitiateMultipartUploadResult s3api::ClientImpl::CreateMultipartUpload ( const multipart_upload::CreateMultipartUploadRequest & request ) const

finalvirtual

Initiate a multipart upload sequence Performs a CreateMultipartUpload S3 Action. Returns result with upload ID which is used to associate all of the parts in the specific multipart upload. You specify this upload ID in each of your subsequent upload part requests For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html.

Implements s3api::Client.

Definition at line 526 of file client.cpp.

◆ DeleteObject()

void s3api::ClientImpl::DeleteObject ( std::string_view path ) const

finalvirtual

Implements s3api::Client.

Definition at line 220 of file client.cpp.

◆ GenerateDownloadUrl()

std::string s3api::ClientImpl::GenerateDownloadUrl	(	std::string_view	path,
		time_t	expires,
		bool	use_ssl ) const

finalvirtual

Implements s3api::Client.

Definition at line 305 of file client.cpp.

◆ GenerateDownloadUrlVirtualHostAddressing()

std::string s3api::ClientImpl::GenerateDownloadUrlVirtualHostAddressing	(	std::string_view	path,
		const std::chrono::system_clock::time_point &	expires_at,
		std::string_view	protocol ) const

finalvirtual

Implements s3api::Client.

Definition at line 328 of file client.cpp.

◆ GenerateUploadUrlVirtualHostAddressing()

std::string s3api::ClientImpl::GenerateUploadUrlVirtualHostAddressing	(	std::string_view	data,
		std::string_view	content_type,
		std::string_view	path,
		const std::chrono::system_clock::time_point &	expires_at,
		std::string_view	protocol ) const

finalvirtual

Implements s3api::Client.

Definition at line 340 of file client.cpp.

◆ GetBucketName()

std::string_view s3api::ClientImpl::GetBucketName ( ) const

finalvirtual

Implements s3api::Client.

Definition at line 193 of file client.cpp.

◆ GetObject()

std::optional< std::string > s3api::ClientImpl::GetObject	(	std::string_view	path,
		std::optional< std::string >	versiong,
		HeadersDataResponse *	headers_data,
		const HeaderDataRequest &	headers_request ) const

finalvirtual

Implements s3api::Client.

Definition at line 225 of file client.cpp.

◆ GetObjectHead()

std::optional< ClientImpl::HeadersDataResponse > s3api::ClientImpl::GetObjectHead	(	std::string_view	path,
		const HeaderDataRequest &	request ) const

finalvirtual

Implements s3api::Client.

Definition at line 290 of file client.cpp.

◆ GetPartialObject()

std::optional< std::string > s3api::ClientImpl::GetPartialObject	(	std::string_view	path,
		std::string_view	range,
		std::optional< std::string >	versiong,
		HeadersDataResponse *	headers_data,
		const HeaderDataRequest &	headers_request ) const

finalvirtual

Implements s3api::Client.

Definition at line 256 of file client.cpp.

◆ ListBucketContents()

std::optional< std::string > s3api::ClientImpl::ListBucketContents	(	std::string_view	path,
		int	max_keys,
		std::string	marker,
		std::string	delimiter ) const

finalvirtual

Implements s3api::Client.

Definition at line 405 of file client.cpp.

◆ ListBucketContentsParsed()

std::vector< ObjectMeta > s3api::ClientImpl::ListBucketContentsParsed ( std::string_view path_prefix ) const

finalvirtual

Implements s3api::Client.

Definition at line 419 of file client.cpp.

◆ ListBucketDirectories()

std::vector< std::string > s3api::ClientImpl::ListBucketDirectories ( std::string_view path_prefix ) const

finalvirtual

Implements s3api::Client.

Definition at line 449 of file client.cpp.

◆ ListMultipartUploads()

multipart_upload::ListMultipartUploadsResult s3api::ClientImpl::ListMultipartUploads ( const multipart_upload::ListMultipartUploadsRequest & request ) const

finalvirtual

List in-progress multipart uploads in a bucket Performs a ListMultipartUploads S3 Action. For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html.

Implements s3api::Client.

Definition at line 603 of file client.cpp.

◆ ListParts()

multipart_upload::ListPartsResult s3api::ClientImpl::ListParts ( const multipart_upload::ListPartsRequest & request ) const

finalvirtual

List the parts that have been uploaded for a specific multipart upload. Performs a ListParts S3 Action. For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html.

Implements s3api::Client.

Definition at line 589 of file client.cpp.

◆ PutObject()

std::string s3api::ClientImpl::PutObject	(	std::string_view	path,
		std::string	data,
		const std::optional< Meta > &	meta,
		std::string_view	content_type,
		const std::optional< std::string > &	content_disposition,
		const std::optional< std::vector< Tag > > &	tags ) const

finalvirtual

Implements s3api::Client.

Definition at line 195 of file client.cpp.

◆ TryGetObject()

std::string s3api::ClientImpl::TryGetObject	(	std::string_view	path,
		std::optional< std::string >	versiong,
		HeadersDataResponse *	headers_data,
		const HeaderDataRequest &	headers_request ) const

finalvirtual

Implements s3api::Client.

Definition at line 246 of file client.cpp.

◆ TryGetPartialObject()

std::string s3api::ClientImpl::TryGetPartialObject	(	std::string_view	path,
		std::string_view	range,
		std::optional< std::string >	versiong,
		HeadersDataResponse *	headers_data,
		const HeaderDataRequest &	headers_request ) const

finalvirtual

Implements s3api::Client.

Definition at line 278 of file client.cpp.

◆ UpdateConfig()

void s3api::ClientImpl::UpdateConfig ( ConnectionCfg && config )

finalvirtual

Implements s3api::Client.

Definition at line 169 of file client.cpp.

◆ UploadPart()

multipart_upload::UploadPartResult s3api::ClientImpl::UploadPart ( const multipart_upload::UploadPartRequest & request ) const

finalvirtual

Upload a part in a multipart upload sequence. Performs an UploadPart S3 Action. Returns ETag value which you must include in the subsequent request to complete the multipart upload. For details see https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html.

Implements s3api::Client.

Definition at line 539 of file client.cpp.

The documentation for this class was generated from the following files:

/data/code/userver/libraries/s3api/src/s3api/clients/client.hpp
/data/code/userver/libraries/s3api/src/s3api/clients/client.cpp

Detailed Description

Public Types

Public Member Functions

Member Typedef Documentation

◆ CiUnorderedMap

◆ Headers

◆ Meta

Constructor & Destructor Documentation

◆ ClientImpl() [1/2]

◆ ClientImpl() [2/2]

Member Function Documentation

◆ AbortMultipartUpload()

◆ CompleteMultipartUpload()

◆ CopyObject() [1/2]

◆ CopyObject() [2/2]

◆ CreateMultipartUpload()

◆ DeleteObject()

◆ GenerateDownloadUrl()

◆ GenerateDownloadUrlVirtualHostAddressing()

◆ GenerateUploadUrlVirtualHostAddressing()

◆ GetBucketName()

◆ GetObject()

◆ GetObjectHead()

◆ GetPartialObject()

◆ ListBucketContents()

◆ ListBucketContentsParsed()

◆ ListBucketDirectories()

◆ ListMultipartUploads()

◆ ListParts()

◆ PutObject()

◆ TryGetObject()

◆ TryGetPartialObject()

◆ UpdateConfig()

◆ UploadPart()