README.md

wsjcpp-employees

C++ classes for service-architecture

How to integrate to your project

via wsjcpp:

$ wsjcpp install https://github.com/wsjcpp/wsjcpp-employees:master

or include this files:

• src.wsjcpp/wsjcpp_core/wsjcpp_core.h
• src.wsjcpp/wsjcpp_core/wsjcpp_core.cpp
• src/wsjcpp_employees.h
• src/wsjcpp_employees.cpp

How use this

For init you must call WsjcppEmployees::init({})

Example main func:

#include <wsjcpp_core.h>
#include <wsjcpp_employees.h>

int main(int argc, const char* argv[]) {
    std::string TAG = "MAIN";
    std::string appName = std::string(WSJCPP_NAME);
    std::string appVersion = std::string(WSJCPP_VERSION);
    if (!WsjcppCore::dirExists(".logs")) {
        WsjcppCore::makeDir(".logs");
    }
    WsjcppLog::setPrefixLogFile("wsjcpp-employees");
    WsjcppLog::setLogDirectory(".logs");
    
    // init employees
    if (!WsjcppEmployees::init({})) {
        WsjcppLog::err(TAG, "Could not init employees");
        return -1;
    }
    return 0;
}

Example output:

% ./wsjcpp-employees
2020-03-22 11:32:31.750, 0x0x110c21dc0 [INFO] WJSCppEmployRuntimeGlobalCache: init
2020-03-22 11:32:31.750, 0x0x110c21dc0 [OK] Employees_init: Init WJSCppEmployRuntimeGlobalCache ... OK

Now you can call from any place:

#inluce <wsjcpp_employees.h>

void someFunc() {
    WJSCppEmployRuntimeGlobalCache *pCache = findWsjcppEmploy<WJSCppEmployRuntimeGlobalCache>();
    pCache->set("name", "value");
}

Example of define you employ use a wsjcpp

wsjcpp generate WsjcppEmploy MyImpl

Example of define you employ (simple)

(don't foget add to build)

Example Header your_employ.h:

#ifndef YOUR_EMPLOY_H
#define YOUR_EMPLOY_H

#include <wsjcpp_employees.h>

class YourEmploy : public WsjcppEmployBase {
    public:
        YourEmploy();
        static std::string name() { return "YourEmploy"; }
        virtual bool init() override;
        virtual bool deinit() override;
        void doSomething();
    private:
        std::string TAG;
};

#endif // YOUR_EMPLOY_H

Example source-code your_employ.cpp:

#include "your_employ.h"

REGISTRY_WJSCPP_EMPLOY(YourEmploy)

YourEmploy::YourEmploy()
    : WsjcppEmployBase(YourEmploy::name(), {}) {
    TAG = YourEmploy::name();
}

bool YourEmploy::init() {
    WsjcppLog::info(TAG, "init called");
    return true; 
}

bool YourEmploy::deinit() {
    WsjcppLog::info(TAG, "deinit called");
    return true;
}

void YourEmploy::doSomething() {
    WsjcppLog::info(TAG, "doSomething called");
}

1. For call ::init you must call WsjcppEmployees::init({}) in main function
2. find employ and call you method from any place

#inluce <your_employ.h>

void someFunc() {
    YourEmploy *pYourEmploy = findWsjcppEmploy<YourEmploy>();
    pYourEmploy->doSomething();
}

void main() {
    ...
    WsjcppEmployees::init({});
    someFunc();
}

Initialization employees in order

1. Second employ required init after first

// second - will be init after 
SecondEmploy::SecondEmploy()
    : WsjcppEmployBase(SecondEmploy::name(), {"FirstEmploy"}) {
    TAG = SecondEmploy::name();
}

bool SecondEmploy::init() {
    // will be called second
}

// first employ - will be init every time
FirstEmploy::FirstEmploy()
    : WsjcppEmployBase(FirstEmploy::name(), {}) {
    TAG = FirstEmploy::name();
}

bool SecondEmploy::init() {
    // will be called first
}

Why it can be need? For init some connections or cache data. For example, you wanna load some data from database

UsersEmploy

• after: DatabaseEmploy

• In DatabaseEmploy::init you can check connection to database and do migration database struct
• In UsersEmploy::init you can use DatabaseEmploy for load user's tokens on server start

2. You wanna init fork some employs

Also you can define on init:

WsjcppEmployees::init({"server-start"})

So it will be call "::init" employees only there which has this requirements.