client.hpp

// Copyright 2014-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 <memory>

#include <mongocxx/client_session.hpp>
#include <mongocxx/database.hpp>
#include <mongocxx/options/client.hpp>
#include <mongocxx/options/client_session.hpp>
#include <mongocxx/read_concern.hpp>
#include <mongocxx/read_preference.hpp>
#include <mongocxx/stdx.hpp>
#include <mongocxx/uri.hpp>
#include <mongocxx/write_concern.hpp>

#include <mongocxx/config/prelude.hpp>

namespace mongocxx {
MONGOCXX_INLINE_NAMESPACE_BEGIN

class client_session;

class MONGOCXX_API client {
   public:
    client() noexcept;

    client(const class uri& mongodb_uri, const options::client& options = options::client());

    client(client&&) noexcept;

    client& operator=(client&&) noexcept;

    ~client();

    explicit operator bool() const noexcept;

    MONGOCXX_DEPRECATED void read_concern(class read_concern rc);
    void read_concern_deprecated(class read_concern rc);

    class read_concern read_concern() const;

    MONGOCXX_DEPRECATED void read_preference(class read_preference rp);
    void read_preference_deprecated(class read_preference rp);

    class read_preference read_preference() const;

    class uri uri() const;

    MONGOCXX_DEPRECATED void write_concern(class write_concern wc);
    void write_concern_deprecated(class write_concern wc);

    class write_concern write_concern() const;

    class database database(bsoncxx::string::view_or_value name) const&;
    class database database(bsoncxx::string::view_or_value name) const&& = delete;

    MONGOCXX_INLINE class database operator[](bsoncxx::string::view_or_value name) const&;
    MONGOCXX_INLINE class database operator[](bsoncxx::string::view_or_value name) const&& = delete;

    cursor list_databases() const;

    cursor list_databases(const client_session& session) const;

    cursor list_databases(const bsoncxx::document::view_or_value filter) const;

    std::vector<std::string> list_database_names(
        const bsoncxx::document::view_or_value filter = {}) const;


    client_session start_session(const options::client_session& options = {});

    change_stream watch(const options::change_stream& options = {});

    change_stream watch(const client_session& session, const options::change_stream& options = {});

    change_stream watch(const pipeline& pipe, const options::change_stream& options = {});

    change_stream watch(const client_session& session,
                        const pipeline& pipe,
                        const options::change_stream& options = {});


    void reset();

   private:
    friend class collection;
    friend class database;
    friend class pool;
    friend class client_session;

    MONGOCXX_PRIVATE explicit client(void* implementation);

    MONGOCXX_PRIVATE change_stream _watch(const client_session* session,
                                          const pipeline& pipe,
                                          const options::change_stream& options);

    class MONGOCXX_PRIVATE impl;

    MONGOCXX_PRIVATE impl& _get_impl();
    MONGOCXX_PRIVATE const impl& _get_impl() const;

    std::unique_ptr<impl> _impl;
};

MONGOCXX_INLINE database client::operator[](bsoncxx::string::view_or_value name) const& {
    return database(name);
}

MONGOCXX_INLINE_NAMESPACE_END
}  // namespace mongocxx

#include <mongocxx/config/postlude.hpp>