pool.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 <functional>
#include <memory>
 
#include <mongocxx/options/auto_encryption-fwd.hpp>
#include <mongocxx/pool-fwd.hpp>
 
#include <bsoncxx/stdx/optional.hpp>
 
#include <mongocxx/client.hpp>
#include <mongocxx/database.hpp>
#include <mongocxx/options/pool.hpp>
#include <mongocxx/uri.hpp>
 
#include <mongocxx/config/prelude.hpp>
 
namespace mongocxx {
namespace v_noabi {
 
class pool {
   public:
    explicit MONGOCXX_ABI_EXPORT_CDECL() pool(const uri& mongodb_uri = mongocxx::v_noabi::uri(),
                                              const options::pool& options = options::pool());
 
    MONGOCXX_ABI_EXPORT_CDECL() ~pool();
 
    pool(pool&&) = delete;
    pool& operator=(pool&&) = delete;
 
    pool(const pool&) = delete;
    pool& operator=(const pool&) = delete;
 
    class entry {
       public:
        MONGOCXX_ABI_EXPORT_CDECL(client*) operator->() const& noexcept;
        client* operator->() && = delete;
 
        MONGOCXX_ABI_EXPORT_CDECL(client&) operator*() const& noexcept;
        client& operator*() && = delete;
 
        MONGOCXX_ABI_EXPORT_CDECL(entry&) operator=(std::nullptr_t) noexcept;
 
        explicit MONGOCXX_ABI_EXPORT_CDECL() operator bool() const noexcept;
 
        // Allows the pool_entry["db_name"] syntax to be used to access a database within the
        // entry's underlying client.
        mongocxx::v_noabi::database operator[](
            bsoncxx::v_noabi::string::view_or_value name) const& {
            return (**this)[name];
        }
 
        mongocxx::v_noabi::database operator[](bsoncxx::v_noabi::string::view_or_value name) && =
            delete;
 
       private:
        friend ::mongocxx::v_noabi::pool;
 
        using unique_client =
            std::unique_ptr<client, std::function<void MONGOCXX_ABI_CDECL(client*)>>;
 
        explicit entry(unique_client);
 
        unique_client _client;
    };
 
    MONGOCXX_ABI_EXPORT_CDECL(entry) acquire();
 
    MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<entry>) try_acquire();
 
   private:
    friend ::mongocxx::v_noabi::options::auto_encryption;
 
    void _release(client* client);
 
    class impl;
    const std::unique_ptr<impl> _impl;
};
 
}  // namespace v_noabi
}  // namespace mongocxx
 
#include <mongocxx/config/postlude.hpp>