{-# LANGUAGE DeriveGeneric #-}
{-# LANGUAGE DuplicateRecordFields #-}
{-# LANGUAGE NamedFieldPuns #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE RecordWildCards #-}
{-# LANGUAGE StrictData #-}
{-# LANGUAGE TypeFamilies #-}
{-# LANGUAGE NoImplicitPrelude #-}
{-# OPTIONS_GHC -fno-warn-unused-binds #-}
{-# OPTIONS_GHC -fno-warn-unused-imports #-}
{-# OPTIONS_GHC -fno-warn-unused-matches #-}

-- Derived from AWS service descriptions, licensed under Apache 2.0.

-- |
-- Module      : Amazonka.LakeFormation.StartTransaction
-- Copyright   : (c) 2013-2023 Brendan Hay
-- License     : Mozilla Public License, v. 2.0.
-- Maintainer  : Brendan Hay
-- Stability   : auto-generated
-- Portability : non-portable (GHC extensions)
--
-- Starts a new transaction and returns its transaction ID. Transaction IDs
-- are opaque objects that you can use to identify a transaction.
module Amazonka.LakeFormation.StartTransaction
  ( -- * Creating a Request
    StartTransaction (..),
    newStartTransaction,

    -- * Request Lenses
    startTransaction_transactionType,

    -- * Destructuring the Response
    StartTransactionResponse (..),
    newStartTransactionResponse,

    -- * Response Lenses
    startTransactionResponse_transactionId,
    startTransactionResponse_httpStatus,
  )
where

import qualified Amazonka.Core as Core
import qualified Amazonka.Core.Lens.Internal as Lens
import qualified Amazonka.Data as Data
import Amazonka.LakeFormation.Types
import qualified Amazonka.Prelude as Prelude
import qualified Amazonka.Request as Request
import qualified Amazonka.Response as Response

-- | /See:/ 'newStartTransaction' smart constructor.
data StartTransaction = StartTransaction'
  { -- | Indicates whether this transaction should be read only or read and
    -- write. Writes made using a read-only transaction ID will be rejected.
    -- Read-only transactions do not need to be committed.
    StartTransaction -> Maybe TransactionType
transactionType :: Prelude.Maybe TransactionType
  }
  deriving (StartTransaction -> StartTransaction -> Bool
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: StartTransaction -> StartTransaction -> Bool
$c/= :: StartTransaction -> StartTransaction -> Bool
== :: StartTransaction -> StartTransaction -> Bool
$c== :: StartTransaction -> StartTransaction -> Bool
Prelude.Eq, ReadPrec [StartTransaction]
ReadPrec StartTransaction
Int -> ReadS StartTransaction
ReadS [StartTransaction]
forall a.
(Int -> ReadS a)
-> ReadS [a] -> ReadPrec a -> ReadPrec [a] -> Read a
readListPrec :: ReadPrec [StartTransaction]
$creadListPrec :: ReadPrec [StartTransaction]
readPrec :: ReadPrec StartTransaction
$creadPrec :: ReadPrec StartTransaction
readList :: ReadS [StartTransaction]
$creadList :: ReadS [StartTransaction]
readsPrec :: Int -> ReadS StartTransaction
$creadsPrec :: Int -> ReadS StartTransaction
Prelude.Read, Int -> StartTransaction -> ShowS
[StartTransaction] -> ShowS
StartTransaction -> String
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
showList :: [StartTransaction] -> ShowS
$cshowList :: [StartTransaction] -> ShowS
show :: StartTransaction -> String
$cshow :: StartTransaction -> String
showsPrec :: Int -> StartTransaction -> ShowS
$cshowsPrec :: Int -> StartTransaction -> ShowS
Prelude.Show, forall x. Rep StartTransaction x -> StartTransaction
forall x. StartTransaction -> Rep StartTransaction x
forall a.
(forall x. a -> Rep a x) -> (forall x. Rep a x -> a) -> Generic a
$cto :: forall x. Rep StartTransaction x -> StartTransaction
$cfrom :: forall x. StartTransaction -> Rep StartTransaction x
Prelude.Generic)

-- |
-- Create a value of 'StartTransaction' with all optional fields omitted.
--
-- Use <https://hackage.haskell.org/package/generic-lens generic-lens> or <https://hackage.haskell.org/package/optics optics> to modify other optional fields.
--
-- The following record fields are available, with the corresponding lenses provided
-- for backwards compatibility:
--
-- 'transactionType', 'startTransaction_transactionType' - Indicates whether this transaction should be read only or read and
-- write. Writes made using a read-only transaction ID will be rejected.
-- Read-only transactions do not need to be committed.
newStartTransaction ::
  StartTransaction
newStartTransaction :: StartTransaction
newStartTransaction =
  StartTransaction'
    { $sel:transactionType:StartTransaction' :: Maybe TransactionType
transactionType =
        forall a. Maybe a
Prelude.Nothing
    }

-- | Indicates whether this transaction should be read only or read and
-- write. Writes made using a read-only transaction ID will be rejected.
-- Read-only transactions do not need to be committed.
startTransaction_transactionType :: Lens.Lens' StartTransaction (Prelude.Maybe TransactionType)
startTransaction_transactionType :: Lens' StartTransaction (Maybe TransactionType)
startTransaction_transactionType = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\StartTransaction' {Maybe TransactionType
transactionType :: Maybe TransactionType
$sel:transactionType:StartTransaction' :: StartTransaction -> Maybe TransactionType
transactionType} -> Maybe TransactionType
transactionType) (\s :: StartTransaction
s@StartTransaction' {} Maybe TransactionType
a -> StartTransaction
s {$sel:transactionType:StartTransaction' :: Maybe TransactionType
transactionType = Maybe TransactionType
a} :: StartTransaction)

instance Core.AWSRequest StartTransaction where
  type
    AWSResponse StartTransaction =
      StartTransactionResponse
  request :: (Service -> Service)
-> StartTransaction -> Request StartTransaction
request Service -> Service
overrides =
    forall a. (ToRequest a, ToJSON a) => Service -> a -> Request a
Request.postJSON (Service -> Service
overrides Service
defaultService)
  response :: forall (m :: * -> *).
MonadResource m =>
(ByteStringLazy -> IO ByteStringLazy)
-> Service
-> Proxy StartTransaction
-> ClientResponse ClientBody
-> m (Either Error (ClientResponse (AWSResponse StartTransaction)))
response =
    forall (m :: * -> *) a.
MonadResource m =>
(Int -> ResponseHeaders -> Object -> Either String (AWSResponse a))
-> (ByteStringLazy -> IO ByteStringLazy)
-> Service
-> Proxy a
-> ClientResponse ClientBody
-> m (Either Error (ClientResponse (AWSResponse a)))
Response.receiveJSON
      ( \Int
s ResponseHeaders
h Object
x ->
          Maybe Text -> Int -> StartTransactionResponse
StartTransactionResponse'
            forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> (Object
x forall a. FromJSON a => Object -> Key -> Either String (Maybe a)
Data..?> Key
"TransactionId")
            forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (forall (f :: * -> *) a. Applicative f => a -> f a
Prelude.pure (forall a. Enum a => a -> Int
Prelude.fromEnum Int
s))
      )

instance Prelude.Hashable StartTransaction where
  hashWithSalt :: Int -> StartTransaction -> Int
hashWithSalt Int
_salt StartTransaction' {Maybe TransactionType
transactionType :: Maybe TransactionType
$sel:transactionType:StartTransaction' :: StartTransaction -> Maybe TransactionType
..} =
    Int
_salt forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe TransactionType
transactionType

instance Prelude.NFData StartTransaction where
  rnf :: StartTransaction -> ()
rnf StartTransaction' {Maybe TransactionType
transactionType :: Maybe TransactionType
$sel:transactionType:StartTransaction' :: StartTransaction -> Maybe TransactionType
..} =
    forall a. NFData a => a -> ()
Prelude.rnf Maybe TransactionType
transactionType

instance Data.ToHeaders StartTransaction where
  toHeaders :: StartTransaction -> ResponseHeaders
toHeaders =
    forall a b. a -> b -> a
Prelude.const
      ( forall a. Monoid a => [a] -> a
Prelude.mconcat
          [ HeaderName
"Content-Type"
              forall a. ToHeader a => HeaderName -> a -> ResponseHeaders
Data.=# ( ByteString
"application/x-amz-json-1.1" ::
                          Prelude.ByteString
                      )
          ]
      )

instance Data.ToJSON StartTransaction where
  toJSON :: StartTransaction -> Value
toJSON StartTransaction' {Maybe TransactionType
transactionType :: Maybe TransactionType
$sel:transactionType:StartTransaction' :: StartTransaction -> Maybe TransactionType
..} =
    [Pair] -> Value
Data.object
      ( forall a. [Maybe a] -> [a]
Prelude.catMaybes
          [ (Key
"TransactionType" forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
Data..=)
              forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> Maybe TransactionType
transactionType
          ]
      )

instance Data.ToPath StartTransaction where
  toPath :: StartTransaction -> ByteString
toPath = forall a b. a -> b -> a
Prelude.const ByteString
"/StartTransaction"

instance Data.ToQuery StartTransaction where
  toQuery :: StartTransaction -> QueryString
toQuery = forall a b. a -> b -> a
Prelude.const forall a. Monoid a => a
Prelude.mempty

-- | /See:/ 'newStartTransactionResponse' smart constructor.
data StartTransactionResponse = StartTransactionResponse'
  { -- | An opaque identifier for the transaction.
    StartTransactionResponse -> Maybe Text
transactionId :: Prelude.Maybe Prelude.Text,
    -- | The response's http status code.
    StartTransactionResponse -> Int
httpStatus :: Prelude.Int
  }
  deriving (StartTransactionResponse -> StartTransactionResponse -> Bool
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: StartTransactionResponse -> StartTransactionResponse -> Bool
$c/= :: StartTransactionResponse -> StartTransactionResponse -> Bool
== :: StartTransactionResponse -> StartTransactionResponse -> Bool
$c== :: StartTransactionResponse -> StartTransactionResponse -> Bool
Prelude.Eq, ReadPrec [StartTransactionResponse]
ReadPrec StartTransactionResponse
Int -> ReadS StartTransactionResponse
ReadS [StartTransactionResponse]
forall a.
(Int -> ReadS a)
-> ReadS [a] -> ReadPrec a -> ReadPrec [a] -> Read a
readListPrec :: ReadPrec [StartTransactionResponse]
$creadListPrec :: ReadPrec [StartTransactionResponse]
readPrec :: ReadPrec StartTransactionResponse
$creadPrec :: ReadPrec StartTransactionResponse
readList :: ReadS [StartTransactionResponse]
$creadList :: ReadS [StartTransactionResponse]
readsPrec :: Int -> ReadS StartTransactionResponse
$creadsPrec :: Int -> ReadS StartTransactionResponse
Prelude.Read, Int -> StartTransactionResponse -> ShowS
[StartTransactionResponse] -> ShowS
StartTransactionResponse -> String
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
showList :: [StartTransactionResponse] -> ShowS
$cshowList :: [StartTransactionResponse] -> ShowS
show :: StartTransactionResponse -> String
$cshow :: StartTransactionResponse -> String
showsPrec :: Int -> StartTransactionResponse -> ShowS
$cshowsPrec :: Int -> StartTransactionResponse -> ShowS
Prelude.Show, forall x.
Rep StartTransactionResponse x -> StartTransactionResponse
forall x.
StartTransactionResponse -> Rep StartTransactionResponse x
forall a.
(forall x. a -> Rep a x) -> (forall x. Rep a x -> a) -> Generic a
$cto :: forall x.
Rep StartTransactionResponse x -> StartTransactionResponse
$cfrom :: forall x.
StartTransactionResponse -> Rep StartTransactionResponse x
Prelude.Generic)

-- |
-- Create a value of 'StartTransactionResponse' with all optional fields omitted.
--
-- Use <https://hackage.haskell.org/package/generic-lens generic-lens> or <https://hackage.haskell.org/package/optics optics> to modify other optional fields.
--
-- The following record fields are available, with the corresponding lenses provided
-- for backwards compatibility:
--
-- 'transactionId', 'startTransactionResponse_transactionId' - An opaque identifier for the transaction.
--
-- 'httpStatus', 'startTransactionResponse_httpStatus' - The response's http status code.
newStartTransactionResponse ::
  -- | 'httpStatus'
  Prelude.Int ->
  StartTransactionResponse
newStartTransactionResponse :: Int -> StartTransactionResponse
newStartTransactionResponse Int
pHttpStatus_ =
  StartTransactionResponse'
    { $sel:transactionId:StartTransactionResponse' :: Maybe Text
transactionId =
        forall a. Maybe a
Prelude.Nothing,
      $sel:httpStatus:StartTransactionResponse' :: Int
httpStatus = Int
pHttpStatus_
    }

-- | An opaque identifier for the transaction.
startTransactionResponse_transactionId :: Lens.Lens' StartTransactionResponse (Prelude.Maybe Prelude.Text)
startTransactionResponse_transactionId :: Lens' StartTransactionResponse (Maybe Text)
startTransactionResponse_transactionId = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\StartTransactionResponse' {Maybe Text
transactionId :: Maybe Text
$sel:transactionId:StartTransactionResponse' :: StartTransactionResponse -> Maybe Text
transactionId} -> Maybe Text
transactionId) (\s :: StartTransactionResponse
s@StartTransactionResponse' {} Maybe Text
a -> StartTransactionResponse
s {$sel:transactionId:StartTransactionResponse' :: Maybe Text
transactionId = Maybe Text
a} :: StartTransactionResponse)

-- | The response's http status code.
startTransactionResponse_httpStatus :: Lens.Lens' StartTransactionResponse Prelude.Int
startTransactionResponse_httpStatus :: Lens' StartTransactionResponse Int
startTransactionResponse_httpStatus = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\StartTransactionResponse' {Int
httpStatus :: Int
$sel:httpStatus:StartTransactionResponse' :: StartTransactionResponse -> Int
httpStatus} -> Int
httpStatus) (\s :: StartTransactionResponse
s@StartTransactionResponse' {} Int
a -> StartTransactionResponse
s {$sel:httpStatus:StartTransactionResponse' :: Int
httpStatus = Int
a} :: StartTransactionResponse)

instance Prelude.NFData StartTransactionResponse where
  rnf :: StartTransactionResponse -> ()
rnf StartTransactionResponse' {Int
Maybe Text
httpStatus :: Int
transactionId :: Maybe Text
$sel:httpStatus:StartTransactionResponse' :: StartTransactionResponse -> Int
$sel:transactionId:StartTransactionResponse' :: StartTransactionResponse -> Maybe Text
..} =
    forall a. NFData a => a -> ()
Prelude.rnf Maybe Text
transactionId
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Int
httpStatus