Class AsyncConnection (2.23.0-rc)

The *Connection object for AsyncClient.

This interface defines virtual methods for each of the user-facing overload sets in AsyncClient. This allows users to inject custom behavior (e.g., with a Google Mock object) when writing tests that use objects of type AsyncClient.

To create a concrete instance, see MakeAsyncConnection().

For mocking, see storage_mocks::MockAsyncConnection.

Functions

options() const

The options used to configure this connection, with any defaults applied.

Returns
Type	Description
`Options`

InsertObject(InsertObjectParams)

Insert a new object.

Parameter
Name	Description
`p`	`InsertObjectParams`

Returns
Type	Description
`future< StatusOr< storage::ObjectMetadata > >`

ReadObject(ReadObjectParams)

Asynchronously create a stream to read object contents.

Parameter
Name	Description
`p`	`ReadObjectParams`

Returns
Type	Description
`future< StatusOr< std::unique_ptr< AsyncReaderConnection > > >`

ReadObjectRange(ReadObjectParams)

Read a range from an object returning all the contents.

Parameter
Name	Description
`p`	`ReadObjectParams`

Returns
Type	Description
`future< StatusOr< ReadPayload > >`

StartUnbufferedUpload(UploadParams)

Start (or resume) an upload configured for persistent sources.

Parameter
Name	Description
`p`	`UploadParams`

Returns
Type	Description
`future< StatusOr< std::unique_ptr< storage_experimental::AsyncWriterConnection > > >`

StartBufferedUpload(UploadParams)

Start (or resume) an upload configured for streaming sources.

Parameter
Name	Description
`p`	`UploadParams`

Returns
Type	Description
`future< StatusOr< std::unique_ptr< storage_experimental::AsyncWriterConnection > > >`

ComposeObject(ComposeObjectParams)

Create a new object by composing (concatenating) the contents of existing objects.

Parameter
Name	Description
`p`	`ComposeObjectParams`

Returns
Type	Description
`future< StatusOr< storage::ObjectMetadata > >`

DeleteObject(DeleteObjectParams)

Delete an object.

Parameter
Name	Description
`p`	`DeleteObjectParams`

Returns
Type	Description
`future< Status >`

RewriteObject(RewriteObjectParams)

Start an object rewrite.

Parameter
Name	Description
`p`	`RewriteObjectParams`

Returns
Type	Description
`std::shared_ptr< AsyncRewriterConnection >`