aws_sdk_dynamodb/operation/execute_transaction/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::execute_transaction::_execute_transaction_output::ExecuteTransactionOutputBuilder;
3
4pub use crate::operation::execute_transaction::_execute_transaction_input::ExecuteTransactionInputBuilder;
5
6impl crate::operation::execute_transaction::builders::ExecuteTransactionInputBuilder {
7    /// Sends a request with this input using the given client.
8    pub async fn send_with(
9        self,
10        client: &crate::Client,
11    ) -> ::std::result::Result<
12        crate::operation::execute_transaction::ExecuteTransactionOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::execute_transaction::ExecuteTransactionError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.execute_transaction();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `ExecuteTransaction`.
24///
25/// <p>This operation allows you to perform transactional reads or writes on data stored in DynamoDB, using PartiQL.</p><note>
26/// <p>The entire transaction must consist of either read statements or write statements, you cannot mix both in one transaction. The EXISTS function is an exception and can be used to check the condition of specific attributes of the item in a similar manner to <code>ConditionCheck</code> in the <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transaction-apis.html#transaction-apis-txwriteitems">TransactWriteItems</a> API.</p>
27/// </note>
28#[derive(::std::clone::Clone, ::std::fmt::Debug)]
29pub struct ExecuteTransactionFluentBuilder {
30    handle: ::std::sync::Arc<crate::client::Handle>,
31    inner: crate::operation::execute_transaction::builders::ExecuteTransactionInputBuilder,
32    config_override: ::std::option::Option<crate::config::Builder>,
33}
34impl
35    crate::client::customize::internal::CustomizableSend<
36        crate::operation::execute_transaction::ExecuteTransactionOutput,
37        crate::operation::execute_transaction::ExecuteTransactionError,
38    > for ExecuteTransactionFluentBuilder
39{
40    fn send(
41        self,
42        config_override: crate::config::Builder,
43    ) -> crate::client::customize::internal::BoxFuture<
44        crate::client::customize::internal::SendResult<
45            crate::operation::execute_transaction::ExecuteTransactionOutput,
46            crate::operation::execute_transaction::ExecuteTransactionError,
47        >,
48    > {
49        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
50    }
51}
52impl ExecuteTransactionFluentBuilder {
53    /// Creates a new `ExecuteTransactionFluentBuilder`.
54    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
55        Self {
56            handle,
57            inner: ::std::default::Default::default(),
58            config_override: ::std::option::Option::None,
59        }
60    }
61    /// Access the ExecuteTransaction as a reference.
62    pub fn as_input(&self) -> &crate::operation::execute_transaction::builders::ExecuteTransactionInputBuilder {
63        &self.inner
64    }
65    /// Sends the request and returns the response.
66    ///
67    /// If an error occurs, an `SdkError` will be returned with additional details that
68    /// can be matched against.
69    ///
70    /// By default, any retryable failures will be retried twice. Retry behavior
71    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
72    /// set when configuring the client.
73    pub async fn send(
74        self,
75    ) -> ::std::result::Result<
76        crate::operation::execute_transaction::ExecuteTransactionOutput,
77        ::aws_smithy_runtime_api::client::result::SdkError<
78            crate::operation::execute_transaction::ExecuteTransactionError,
79            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
80        >,
81    > {
82        let input = self
83            .inner
84            .build()
85            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
86        let runtime_plugins = crate::operation::execute_transaction::ExecuteTransaction::operation_runtime_plugins(
87            self.handle.runtime_plugins.clone(),
88            &self.handle.conf,
89            self.config_override,
90        );
91        crate::operation::execute_transaction::ExecuteTransaction::orchestrate(&runtime_plugins, input).await
92    }
93
94    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
95    pub fn customize(
96        self,
97    ) -> crate::client::customize::CustomizableOperation<
98        crate::operation::execute_transaction::ExecuteTransactionOutput,
99        crate::operation::execute_transaction::ExecuteTransactionError,
100        Self,
101    > {
102        crate::client::customize::CustomizableOperation::new(self)
103    }
104    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
105        self.set_config_override(::std::option::Option::Some(config_override.into()));
106        self
107    }
108
109    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
110        self.config_override = config_override;
111        self
112    }
113    ///
114    /// Appends an item to `TransactStatements`.
115    ///
116    /// To override the contents of this collection use [`set_transact_statements`](Self::set_transact_statements).
117    ///
118    /// <p>The list of PartiQL statements representing the transaction to run.</p>
119    pub fn transact_statements(mut self, input: crate::types::ParameterizedStatement) -> Self {
120        self.inner = self.inner.transact_statements(input);
121        self
122    }
123    /// <p>The list of PartiQL statements representing the transaction to run.</p>
124    pub fn set_transact_statements(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::ParameterizedStatement>>) -> Self {
125        self.inner = self.inner.set_transact_statements(input);
126        self
127    }
128    /// <p>The list of PartiQL statements representing the transaction to run.</p>
129    pub fn get_transact_statements(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::ParameterizedStatement>> {
130        self.inner.get_transact_statements()
131    }
132    /// <p>Set this value to get remaining results, if <code>NextToken</code> was returned in the statement response.</p>
133    pub fn client_request_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
134        self.inner = self.inner.client_request_token(input.into());
135        self
136    }
137    /// <p>Set this value to get remaining results, if <code>NextToken</code> was returned in the statement response.</p>
138    pub fn set_client_request_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
139        self.inner = self.inner.set_client_request_token(input);
140        self
141    }
142    /// <p>Set this value to get remaining results, if <code>NextToken</code> was returned in the statement response.</p>
143    pub fn get_client_request_token(&self) -> &::std::option::Option<::std::string::String> {
144        self.inner.get_client_request_token()
145    }
146    /// <p>Determines the level of detail about either provisioned or on-demand throughput consumption that is returned in the response. For more information, see <a href="https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactGetItems.html">TransactGetItems</a> and <a href="https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactWriteItems.html">TransactWriteItems</a>.</p>
147    pub fn return_consumed_capacity(mut self, input: crate::types::ReturnConsumedCapacity) -> Self {
148        self.inner = self.inner.return_consumed_capacity(input);
149        self
150    }
151    /// <p>Determines the level of detail about either provisioned or on-demand throughput consumption that is returned in the response. For more information, see <a href="https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactGetItems.html">TransactGetItems</a> and <a href="https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactWriteItems.html">TransactWriteItems</a>.</p>
152    pub fn set_return_consumed_capacity(mut self, input: ::std::option::Option<crate::types::ReturnConsumedCapacity>) -> Self {
153        self.inner = self.inner.set_return_consumed_capacity(input);
154        self
155    }
156    /// <p>Determines the level of detail about either provisioned or on-demand throughput consumption that is returned in the response. For more information, see <a href="https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactGetItems.html">TransactGetItems</a> and <a href="https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactWriteItems.html">TransactWriteItems</a>.</p>
157    pub fn get_return_consumed_capacity(&self) -> &::std::option::Option<crate::types::ReturnConsumedCapacity> {
158        self.inner.get_return_consumed_capacity()
159    }
160}
aws_sdk_dynamodb/operation/execute_transaction/builders.rs

aws_sdk_dynamodb/operation/execute_transaction/
builders.rs
