database.hpp

// Copyright 2014 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 <string>
 
#include <bsoncxx/document/view_or_value.hpp>
#include <bsoncxx/string/view_or_value.hpp>
#include <mongocxx/client_session.hpp>
#include <mongocxx/collection.hpp>
#include <mongocxx/gridfs/bucket.hpp>
#include <mongocxx/options/create_collection.hpp>
#include <mongocxx/options/create_view.hpp>
#include <mongocxx/options/gridfs/bucket.hpp>
#include <mongocxx/read_preference.hpp>
#include <mongocxx/write_concern.hpp>
 
#include <mongocxx/config/prelude.hpp>
 
namespace mongocxx {
MONGOCXX_INLINE_NAMESPACE_BEGIN
 
class client;
 
class MONGOCXX_API database {
   public:
    database() noexcept;
 
    database(database&&) noexcept;
 
    database& operator=(database&&) noexcept;
 
    database(const database&);
 
    database& operator=(const database&);
 
    ~database();
 
    explicit operator bool() const noexcept;
 
    bsoncxx::document::value run_command(bsoncxx::document::view_or_value command);
 
    bsoncxx::document::value run_command(const client_session& session,
                                         bsoncxx::document::view_or_value command);
 
    class collection create_collection(stdx::string_view name,
                                       bsoncxx::document::view_or_value collection_options = {},
                                       const stdx::optional<write_concern>& write_concern = {});
 
    class collection create_collection(const client_session& session,
                                       stdx::string_view name,
                                       bsoncxx::document::view_or_value collection_options = {},
                                       const stdx::optional<write_concern>& write_concern = {});
 
    class collection create_collection(bsoncxx::string::view_or_value name,
                                       const options::create_collection& collection_options,
                                       const stdx::optional<write_concern>& write_concern = {}) {
        return create_collection_deprecated(name, collection_options, write_concern);
    }
 
    class collection create_collection_deprecated(
        bsoncxx::string::view_or_value name,
        const options::create_collection& collection_options,
        const stdx::optional<write_concern>& write_concern = {});
 
    class collection create_collection(const client_session& session,
                                       bsoncxx::string::view_or_value name,
                                       const options::create_collection& collection_options,
                                       const stdx::optional<write_concern>& write_concern = {}) {
        return create_collection_deprecated(session, name, collection_options, write_concern);
    }
 
    class collection create_collection_deprecated(
        const client_session& session,
        bsoncxx::string::view_or_value name,
        const options::create_collection& collection_options,
        const stdx::optional<write_concern>& write_concern = {});
 
 
    MONGOCXX_DEPRECATED class collection create_view(
        bsoncxx::string::view_or_value name,
        bsoncxx::string::view_or_value view_on,
        const options::create_view& options = options::create_view());
 
    class collection create_view_deprecated(
        bsoncxx::string::view_or_value name,
        bsoncxx::string::view_or_value view_on,
        const options::create_view& options = options::create_view());
 
 
    void drop(const bsoncxx::stdx::optional<mongocxx::write_concern>& write_concern = {});
 
    void drop(const client_session& session,
              const bsoncxx::stdx::optional<mongocxx::write_concern>& write_concern = {});
 
    bool has_collection(bsoncxx::string::view_or_value name) const;
 
    cursor list_collections(bsoncxx::document::view_or_value filter = {});
 
    cursor list_collections(const client_session& session,
                            bsoncxx::document::view_or_value filter = {});
 
    std::vector<std::string> list_collection_names(bsoncxx::document::view_or_value filter = {});
 
    std::vector<std::string> list_collection_names(const client_session& session,
                                                   bsoncxx::document::view_or_value filter = {});
 
 
    stdx::string_view name() const;
 
    void read_concern(class read_concern rc);
 
    class read_concern read_concern() const;
 
    void read_preference(class read_preference rp);
 
    class read_preference read_preference() const;
 
    void write_concern(class write_concern wc);
 
    class write_concern write_concern() const;
 
    class collection collection(bsoncxx::string::view_or_value name) const;
 
    MONGOCXX_INLINE class collection operator[](bsoncxx::string::view_or_value name) const;
 
    class gridfs::bucket gridfs_bucket(
        const options::gridfs::bucket& options = options::gridfs::bucket()) const;
 
    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 = {});
 
 
   private:
    friend class client;
    friend class collection;
 
    MONGOCXX_PRIVATE database(const class client& client, bsoncxx::string::view_or_value name);
 
    MONGOCXX_PRIVATE bsoncxx::document::value _run_command(
        const client_session* session, bsoncxx::document::view_or_value command);
 
    MONGOCXX_PRIVATE class collection _create_collection(
        const client_session* session,
        stdx::string_view name,
        bsoncxx::document::view_or_value collection_options,
        const stdx::optional<class write_concern>& write_concern);
 
    MONGOCXX_PRIVATE class collection _create_collection_deprecated(
        const client_session* session,
        bsoncxx::string::view_or_value name,
        const options::create_collection& collection_options,
        const stdx::optional<class write_concern>& write_concern);
 
    MONGOCXX_PRIVATE cursor _list_collections(const client_session* session,
                                              bsoncxx::document::view_or_value filter);
 
    MONGOCXX_PRIVATE std::vector<std::string> _list_collection_names(
        const client_session* session, bsoncxx::document::view_or_value filter);
 
    MONGOCXX_PRIVATE void _drop(
        const client_session* session,
        const bsoncxx::stdx::optional<mongocxx::write_concern>& write_concern);
 
    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 collection database::operator[](bsoncxx::string::view_or_value name) const {
    return collection(name);
}
 
MONGOCXX_INLINE_NAMESPACE_END
}  // namespace mongocxx
 
#include <mongocxx/config/postlude.hpp>