api.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 <map>
 
#include "src/include/jazz_models.h"
 
#ifdef CATCH_TEST
#ifndef INCLUDED_JAZZ_CATCH2
#define INCLUDED_JAZZ_CATCH2
 
#include "src/catch2/catch.hpp"
 
#endif
#endif
 
 
#ifndef INCLUDED_JAZZ_MAIN_API
#define INCLUDED_JAZZ_MAIN_API
 
 
#define MHD_PLATFORM_H                  // Following recommendation in: 1.5 Including the microhttpd.h header
 
 
#include <microhttpd.h>
 
#if MHD_VERSION < 0x00097000
typedef int MHD_Result;
#endif
 
 
namespace jazz_main
{
 
//TODO: Create interface for ACTOR model (as described in develop/rfc2/jazz_actor_model.html)
 
using namespace jazz_elements;
using namespace jazz_bebop;
using namespace jazz_models;
 
#define MAX_RECURSE_LEVEL_ON_STATICS        16  
 
// Values of http_put(sequence)
#define SEQUENCE_FIRST_CALL                  0  
#define SEQUENCE_INCREMENT_CALL              1  
#define SEQUENCE_FINAL_CALL                  2  
 
 
#define HTTP_NOTUSED                         0  
#define HTTP_OPTIONS                         1  
#define HTTP_HEAD                            2  
#define HTTP_GET                             3  
#define HTTP_PUT                             4  
#define HTTP_DELETE                          5  
 
typedef struct MHD_Response *pMHD_Response;     
typedef struct MHD_Connection *pMHD_Connection; 
 
extern MHD_Result http_request_callback(void *cls,
                                        struct MHD_Connection *connection,
                                        const char *url,
                                        const char *method,
                                        const char *version,
                                        const char *upload_data,
                                        size_t *upload_data_size,
                                        void **con_cls);
 
 
class API : public BaseAPI {
 
    public:
 
        API(pLogger     a_logger,
            pConfigFile a_config,
            pChannels   a_channels,
            pVolatile   a_volatile,
            pPersisted  a_persisted,
            pCore       a_core,
            pModelsAPI  a_model);
       ~API();
 
        virtual pChar const id();
 
        StatusCode start    ();
        StatusCode shut_down();
 
        // parsing methods
 
        MHD_StatusCode get_static      (pMHD_Response  &response,
                                        pChar           p_url,
                                        bool            get_it = true);
 
        // deliver http error pages
 
        MHD_Result return_error_message(pMHD_Connection connection,
                                        pChar           p_url,
                                        int             http_status);
 
        // Specific execution methods
 
        MHD_StatusCode http_put    (pChar           p_upload,
                                    size_t          size,
                                    ApiQueryState  &q_state,
                                    int             sequence);
        MHD_StatusCode http_delete (ApiQueryState  &q_state);
        MHD_StatusCode http_get    (pMHD_Response  &response,
                                    ApiQueryState  &q_state);
 
#ifndef CATCH_TEST
    private:
#endif
 
        bool find_myself        ();
        StatusCode load_statics (pChar  p_base_path,
                                 pChar  p_relative_path,
                                 int    rec_level);
        bool expand_url_encoded (pChar  p_buff,
                                 int    buff_size,
                                 pChar  p_url);
 
        pCore       p_core;         
        pModelsAPI  p_model;        
 
        Index       www;            
        int         remove_statics; 
};
class API : public BaseAPI {…};
 
#ifdef CATCH_TEST
 
// Instancing API
// --------------
 
extern API    TT_API;
 
#endif
 
} // namespace jazz_main
 
#endif // ifndef INCLUDED_JAZZ_MAIN_API