persisted.h

/* Jazz (c) 2018-2025 kaalam.ai (The Authors of Jazz), using (under the same license):
 
    1. Biomodelling - The AATBlockQueue class (c) Jacques Basaldúa, 2009-2012 licensed
      exclusively for the use in the Jazz server software.
 
      Copyright 2009-2012 Jacques Basaldúa
 
    2. BBVA - Jazz: A lightweight analytical web server for data-driven applications.
 
      Copyright 2016-2017 Banco Bilbao Vizcaya Argentaria, S.A.
 
      This product includes software developed at
 
      BBVA (https://www.bbva.com/)
 
    3. LMDB, Copyright 2011-2017 Howard Chu, Symas Corp. All rights reserved.
 
      Licensed under http://www.OpenLDAP.org/license.html
 
 
      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.
*/
 
 
#include "src/jazz_elements/volatile.h"
 
#ifdef CATCH_TEST
#ifndef INCLUDED_JAZZ_CATCH2
#define INCLUDED_JAZZ_CATCH2
 
#include "src/catch2/catch.hpp"
 
#endif
#endif
 
 
#ifndef INCLUDED_JAZZ_ELEMENTS_PERSISTED
#define INCLUDED_JAZZ_ELEMENTS_PERSISTED
 
#include "src/lmdb/lmdb.h"
 
 
namespace jazz_elements
{
 
#define MAX_POSSIBLE_SOURCES                32      
#define MAX_LMDB_HOME_LEN                  128      
#define LMDB_UNIX_FILE_PERMISSIONS        0664      
#define INVALID_MDB_DBI             0xefefEFEF      
 
 
struct JazzLmdbOptions {
    char path[MAX_LMDB_HOME_LEN];           
 
    int env_set_mapsize;                    
    int env_set_maxreaders;                 
    int env_set_maxdbs;                     
    int flags;                              
};
 
 
typedef std::map <std::string, MDB_dbi> DBImap;     
typedef MDB_txn *pMDB_txn;                          
 
 
class Persisted : public Container {
 
    public:
 
        Persisted(pLogger a_logger, pConfigFile a_config);
       ~Persisted();
 
        virtual pChar const id();
 
        StatusCode start    ();
        StatusCode shut_down();
 
        // The easy interface (Requires explicit pulling because of the native interface using the same names.)
 
        using Container::get;
        using Container::header;
        using Container::put;
        using Container::new_entity;
        using Container::remove;
        using Container::copy;
 
        // The "native" interface
 
        virtual StatusCode get       (pTransaction      &p_txn,
                                      Locator           &what);
        virtual StatusCode get       (pTransaction      &p_txn,
                                      Locator           &what,
                                      pBlock             p_row_filter);
        virtual StatusCode get       (pTransaction      &p_txn,
                                      Locator           &what,
                                      pChar              name);
        virtual StatusCode header    (StaticBlockHeader &hea,
                                      Locator           &what);
        virtual StatusCode header    (pTransaction      &p_txn,
                                      Locator           &what);
        virtual StatusCode put       (Locator           &where,
                                      pBlock             p_block,
                                      int                mode = WRITE_AS_FULL_BLOCK);
        virtual StatusCode new_entity(Locator           &where);
        virtual StatusCode remove    (Locator           &where);
        virtual StatusCode copy      (Locator           &where,
                                      Locator           &what);
 
        // Support for container names in the BaseAPI .base_names()
 
        void base_names(BaseNames &base_names);
        bool dbi_exists(Name       dbi_name);
 
        inline bool is_running() {
            return lmdb_env != nullptr;
        }
 
#ifndef CATCH_TEST
    private:
#endif
 
        // Hot LMDB get
 
        pBlock lock_pointer_to_block(Locator &what, pMDB_txn &p_txn);
        void   done_pointer_to_block(pMDB_txn &p_txn);
 
        // Internal dbi management
 
        bool open_all_databases ();
        void close_all_databases();
        StatusCode new_database   (pChar name);
        StatusCode remove_database(pChar name);
 
        // Logger with full messages for lmdb errors.
 
        void log_lmdb_err(int loglevel, int lmdb_err, const char *msg);
 
        DBImap           source_dbi = {};       
        JazzLmdbOptions  lmdb_opt;              
        MDB_env         *lmdb_env = nullptr;    
};
typedef Persisted *pPersisted;                  
 
#ifdef CATCH_TEST
 
// Instancing Persisted
// --------------------
 
extern Persisted PER;
 
#endif
 
} // namespace jazz_elements
 
#endif // ifndef INCLUDED_JAZZ_ELEMENTS_PERSISTED