client_session.hpp

Go to the documentation of this file.

// Copyright 2009-present MongoDB, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
 
#pragma once
 
#include <mongocxx/client_session-fwd.hpp> // IWYU pragma: export
 
//
 
#include <mongocxx/v1/client_session.hpp> // IWYU pragma: export
 
#include <cstdint>
#include <functional>
#include <memory> // IWYU pragma: keep: backward compatibility, to be removed.
 
#include <mongocxx/bulk_write-fwd.hpp> // IWYU pragma: keep: backward compatibility, to be removed.
#include <mongocxx/client-fwd.hpp>
#include <mongocxx/collection-fwd.hpp>        // IWYU pragma: keep: backward compatibility, to be removed.
#include <mongocxx/database-fwd.hpp>          // IWYU pragma: keep: backward compatibility, to be removed.
#include <mongocxx/index_view-fwd.hpp>        // IWYU pragma: keep: backward compatibility, to be removed.
#include <mongocxx/search_index_view-fwd.hpp> // IWYU pragma: keep: backward compatibility, to be removed.
 
#include <bsoncxx/document/view.hpp>
#include <bsoncxx/stdx/optional.hpp>
#include <bsoncxx/types.hpp>
 
#include <mongocxx/options/client_session.hpp>
#include <mongocxx/options/transaction.hpp>
 
#include <mongocxx/config/prelude.hpp>
 
namespace mongocxx {
namespace v_noabi {

class client_session {
   private:
    v1::client_session _session;
    v_noabi::client* _client;
    v_noabi::options::client_session _options;
 
   public:
    using transaction_state = v1::client_session::transaction_state;

    v_noabi::client const& client() const noexcept {
        return *_client;
    }

    options::client_session const& options() const noexcept {
        return _options;
    }

    bsoncxx::v_noabi::document::view id() const noexcept {
        return _session.id();
    }

    bsoncxx::v_noabi::document::view cluster_time() const noexcept {
        return _session.cluster_time();
    }

    bsoncxx::v_noabi::types::b_timestamp operation_time() const noexcept {
        return bsoncxx::v_noabi::from_v1(_session.operation_time());
    }

    std::uint32_t server_id() const noexcept {
        return _session.server_id();
    }

    transaction_state get_transaction_state() const noexcept {
        return _session.get_transaction_state();
    }

    bool get_dirty() const noexcept {
        return _session.get_dirty();
    }

    void advance_cluster_time(bsoncxx::v_noabi::document::view const& cluster_time) {
        _session.advance_cluster_time(bsoncxx::v_noabi::to_v1(cluster_time));
    }

    void advance_operation_time(bsoncxx::v_noabi::types::b_timestamp const& operation_time) {
        _session.advance_operation_time(bsoncxx::v_noabi::to_v1(operation_time));
    }

    MONGOCXX_ABI_EXPORT_CDECL(void) start_transaction(
        bsoncxx::v_noabi::stdx::optional<v_noabi::options::transaction> const& transaction_opts = {});

    MONGOCXX_ABI_EXPORT_CDECL(void) commit_transaction();

    MONGOCXX_ABI_EXPORT_CDECL(void) abort_transaction();

    using with_transaction_cb = std::function<void MONGOCXX_ABI_CDECL(client_session*)>;

    MONGOCXX_ABI_EXPORT_CDECL(void) with_transaction(with_transaction_cb cb, v_noabi::options::transaction opts = {});
 
    class internal;
 
   private:
    client_session(v1::client_session session, v_noabi::client& client, v_noabi::options::client_session options);
};
 
} // namespace v_noabi
} // namespace mongocxx
 
#include <mongocxx/config/postlude.hpp>