C++ ရှိ မိုက်ခရိုဝန်ဆောင်မှုများ။ စိတ်ကူးယဉ်လား ဒါမှမဟုတ် လက်တွေ့လား။

ဤဆောင်းပါးတွင် docker/docker-compose နှင့် conan ပက်ကေ့ဂျ်မန်နေဂျာကို အသုံးပြု၍ C++ တွင် REST API ဝန်ဆောင်မှုကိုရေးသားရန်အတွက် ပုံစံပလိတ်တစ်ခု (cookiecutter) ကို ဖန်တီးပုံအကြောင်း ပြောပြပါမည်။

နောက်တစ်ကြိမ် ဟက်ကာသွန်တွင် ကျွန်ုပ်သည် နောက်ခံဆော့ဖ်ဝဲရေးသားသူအဖြစ် ပါဝင်ခဲ့ရာတွင် နောက်ထပ် မိုက်ခရိုဆားဗစ်ကို ရေးရန် ဘာကိုအသုံးပြုရမည်နည်း။ အခုထိ ရေးထားသမျှက ငါနဲ့ ငါ့ဘာသာရေးထားတာ သွေးသောက် Python တွင်၊ ကျွန်ုပ်၏လုပ်ဖော်ကိုင်ဖက်သည် ဤနယ်ပယ်တွင်ကျွမ်းကျင်သူဖြစ်ပြီး ကျွမ်းကျင်စွာတီထွင်ထားသော backends ဖြစ်သောကြောင့်၊ ကျွန်ုပ်သည် ယေဘူယျအားဖြင့် embedded systems developer တစ်ဦးဖြစ်ပြီး အလွန်ကြောက်မက်ဖွယ်ကောင်းသော C++ ဖြင့် ရေးသားခဲ့ပြီး၊ တက္ကသိုလ်တွင် Python ကို သင်ယူခဲ့သည်။

ထို့ကြောင့်၊ ကျွန်ုပ်တို့သည် high-load service ကိုရေးသားရန်တာဝန်နှင့်ရင်ဆိုင်ခဲ့ရသည်၊ ယင်း၏အဓိကတာဝန်မှာ၎င်းသို့လာမည့်ဒေတာကိုကြိုတင်လုပ်ဆောင်ပြီးဒေတာဘေ့စ်သို့ရေးရန်ဖြစ်သည်။ နောက်ထပ် ဆေးလိပ်ဖြတ်ပြီးနောက် သူငယ်ချင်းတစ်ယောက်က C++ developer တစ်ယောက်အနေနဲ့ အားသာချက်တွေကို အသုံးပြုပြီး ဒီဝန်ဆောင်မှုကိုရေးဖို့ အကြံပြုခဲ့ပါတယ်။ ယင်းကို စောဒကတက်ရခြင်းမှာ ၎င်းသည် ပိုမိုမြန်ဆန်၊ ပိုမိုအကျိုးဖြစ်ထွန်းစေမည်ဖြစ်ရာ ယေဘုယျအားဖြင့် ဂျူရီလူကြီးများသည် အဖွဲ့၏အရင်းအမြစ်များကို စီမံခန့်ခွဲနည်းကို ကျွန်ုပ်တို့သိထားပုံနှင့်ပတ်သက်၍ ဝမ်းမြောက်ဝမ်းသာဖြစ်ပါမည်။ ကျွန်ုပ်သည် C++ တွင် ထိုသို့သော အရာများကို တစ်ခါမျှ မလုပ်ဖူးကြောင်းနှင့် ကျန်ရှိသော နာရီပေါင်း 20+ ကို သင့်လျော်သော စာကြည့်တိုက်များကို ရှာဖွေခြင်း၊ စုစည်းခြင်းနှင့် ချိတ်ဆက်ခြင်းအတွက် လွယ်ကူစွာ မြှုပ်နှံနိုင်သည်ဟု ဖြေကြားခဲ့သည်။ ရိုးရိုးရှင်းရှင်းပြောရရင် ကျွန်တော် လန့်သွားတယ်။ အဲဒါကို ကျွန်တော်တို့ ဆုံးဖြတ်ပြီး Python မှာ အရာအားလုံးကို အေးအေးဆေးဆေး ပြီးသွားပါပြီ။

ယခု၊ အတင်းအကြပ် သီးသန့်ခွဲထုတ်နေချိန်အတွင်း C++ တွင် ဝန်ဆောင်မှုများကို မည်သို့ရေးရမည်ကို အဖြေရှာရန် ဆုံးဖြတ်ခဲ့သည်။ ပထမဆုံးလုပ်ရမှာက သင့်တော်တဲ့ စာကြည့်တိုက်တစ်ခုကို ဆုံးဖြတ်ပါ။ ကျွန်တော့်ရဲ့ ရွေးချယ်မှု ကျသွားခဲ့တယ်။ POCOအရာဝတ္ထု-ဆန်သောပုံစံဖြင့် ရေးသားထားသောကြောင့် သာမန်စာရွက်စာတမ်းများကိုလည်း ကြွားဝါထားသည်။ ထို့အပြင် စည်းဝေးပွဲစနစ်ရွေးချယ်ခြင်းနှင့်ပတ်သက်ပြီး မေးခွန်းထုတ်စရာဖြစ်လာသည်။ ယခုအချိန်အထိ ကျွန်ုပ်သည် Visual Studio၊ IAR နှင့် bare makefiles တို့နှင့်သာ အလုပ်လုပ်ပါသည်။ Docker container တွင် ဝန်ဆောင်မှုတစ်ခုလုံးကို လုပ်ဆောင်ရန် စီစဉ်ထားသောကြောင့် ဤစနစ်များထဲမှ တစ်ခုမျှ ကျွန်ုပ်အား အယူခံဝင်ခြင်းမရှိပါ။ နောက်တော့ ကျွန်တော် cmake နဲ့ စိတ်ဝင်စားစရာကောင်းတဲ့ package manager ကို ရှာကြည့်ဖို့ ဆုံးဖြတ်လိုက်တယ်။ Conan. ဤပက်ကေ့ဂျ်မန်နေဂျာက သင့်အား ဖိုင်တစ်ခုတည်းတွင် မှီခိုမှုအားလုံးကို စာရင်းသွင်းခွင့်ပြုထားသည်။

conanfile.txt
[လိုအပ်သည်] poco/1.9.3
libpq/11.5

[မီးစက်များ] cmake

ရိုးရှင်းသော command ဖြင့် "conan install ." လိုအပ်သောစာကြည့်တိုက်များကို install လုပ်ပါ။ သဘာဝအတိုင်း ပြုပြင်ပြောင်းလဲရန်လည်း လိုအပ်ပါသည်။

CMakeLists.txt

include(build/conanbuildinfo.cmake)
conan_basic_setup()
target_link_libraries(<target_name> ${CONAN_LIBS})

အဲဒီနောက်မှာတော့ PostgreSQL နဲ့ အလုပ်လုပ်ဖို့ စာကြည့်တိုက်တစ်ခုကို စတင်ရှာဖွေခဲ့တယ်၊ အဲဒါက ကျွန်တော်နဲ့ အလုပ်တွဲလုပ်ရတဲ့ အတွေ့အကြုံနည်းတဲ့အတွက်ကြောင့်ပဲ၊ အဲဒါက ကျွန်ုပ်တို့ရဲ့ Python ဝန်ဆောင်မှုတွေနဲ့ အပြန်အလှန်အကျိုးပြုတဲ့ တစ်ခုလည်း ဖြစ်ပါတယ်။ ငါသင်ယူခဲ့တာကို မင်းသိလား။ POCO တွင်ရှိသည်။ သို့သော် conan သည် POCO တွင်ရှိကြောင်းနှင့် ၎င်းကို မည်သို့တည်ဆောက်ရမည်ကို မသိပါ; repository တွင် ခေတ်မမီတော့သော ဖွဲ့စည်းမှုပုံစံဖိုင်တစ်ခု ရှိသည် (POCO ဖန်တီးသူများထံ ဤအမှားအကြောင်း ကျွန်ုပ်ရေးပြီးပြီ)။ ဆိုလိုသည်မှာ သင်သည် အခြားစာကြည့်တိုက်တစ်ခုကို ရှာဖွေရမည်ဟု ဆိုလိုသည်။

ထို့နောက်တွင် ကျွန်ုပ်၏ရွေးချယ်မှုသည် လူကြိုက်နည်းသော စာကြည့်တိုက်တွင် ကျသွားသည်။ libpg. ပြီးတော့ ကျွန်တော် မယုံနိုင်လောက်အောင် ကံကောင်းခဲ့ပါတယ်၊ အဲဒါက conan မှာရှိနေပြီဖြစ်ပြီး စုဝေးပြီး စုစည်းနေသေးတယ်။

နောက်တစ်ဆင့်မှာ တောင်းဆိုမှုများကို လုပ်ဆောင်နိုင်သည့် ဝန်ဆောင်မှုပုံစံတစ်ခုကို ရေးရန်ဖြစ်သည်။
ကျွန်ုပ်တို့သည် Poco::Util::ServerApplication မှ ကျွန်ုပ်တို့၏ TemplateServerApp အတန်းကို အမွေရမည်ဖြစ်ပြီး ပင်မနည်းလမ်းကို အစားထိုးရပါမည်။

TemplateServerApp

#pragma once

#include <string>
#include <vector>
#include <Poco/Util/ServerApplication.h>

class TemplateServerApp : public Poco::Util::ServerApplication
{
    protected:
        int main(const std::vector<std::string> &);
};

int TemplateServerApp::main(const vector<string> &)
{
    HTTPServerParams* pParams = new HTTPServerParams;

    pParams->setMaxQueued(100);
    pParams->setMaxThreads(16);

    HTTPServer s(new TemplateRequestHandlerFactory, ServerSocket(8000), pParams);

    s.start();
    cerr << "Server started" << endl;

    waitForTerminationRequest();  // wait for CTRL-C or kill

    cerr << "Shutting down..." << endl;
    s.stop();

    return Application::EXIT_OK;
}

ပင်မနည်းလမ်းတွင် ကျွန်ုပ်တို့သည် ပို့တ်၊ စာတွဲအရေအတွက်နှင့် တန်းစီအရွယ်အစားကို သတ်မှတ်ရပါမည်။ အရေးအကြီးဆုံးကတော့၊ ဝင်လာတဲ့တောင်းဆိုမှုတွေအတွက် ကိုင်တွယ်သူကို သတ်မှတ်ရပါမယ်။ ဒါကို စက်ရုံတစ်ခု ဖန်တီးပြီး လုပ်တယ်။

TemplateRequestHandlerFactory

class TemplateRequestHandlerFactory : public HTTPRequestHandlerFactory
{
public:
    virtual HTTPRequestHandler* createRequestHandler(const HTTPServerRequest & request)
    {
        return new TemplateServerAppHandler;
    }
};

ကျွန်တော့်ကိစ္စမှာ၊ TemplateServerAppHandler သည် အချိန်တိုင်း တူညီသောကိုင်တွယ်သူကို ဖန်တီးပေးသည်။ ဤနေရာတွင် ကျွန်ုပ်တို့၏ လုပ်ငန်းဆိုင်ရာ ယုတ္တိကို ထားရှိနိုင်ပါသည်။

TemplateServerAppHandler

class TemplateServerAppHandler : public HTTPRequestHandler
{
public:
    void handleRequest(HTTPServerRequest &req, HTTPServerResponse &resp)
    {
        URI uri(req.getURI());
        string method = req.getMethod();

        cerr << "URI: " << uri.toString() << endl;
        cerr << "Method: " << req.getMethod() << endl;

        StringTokenizer tokenizer(uri.getPath(), "/", StringTokenizer::TOK_TRIM);
        HTMLForm form(req,req.stream());

        if(!method.compare("POST"))
        {
            cerr << "POST" << endl;
        }
        else if(!method.compare("PUT"))
        {
            cerr << "PUT" << endl;
        }
        else if(!method.compare("DELETE"))
        {
            cerr << "DELETE" << endl;
        }

        resp.setStatus(HTTPResponse::HTTP_OK);
        resp.setContentType("application/json");
        ostream& out = resp.send();

        out << "{"hello":"heh"}" << endl;
        out.flush();
    }
};

PostgreSQL နှင့်အလုပ်လုပ်ရန် အတန်းပုံစံကိုလည်း ဖန်တီးခဲ့သည်။ ဇယားတစ်ခုဖန်တီးခြင်းကဲ့သို့သောရိုးရှင်းသော SQL ကိုလုပ်ဆောင်ရန်နည်းလမ်းတစ်ခုရှိသည်။ ExecuteSQL(). ပိုမိုရှုပ်ထွေးသောမေးမြန်းမှုများ သို့မဟုတ် ဒေတာပြန်လည်ရယူရန်အတွက်၊ သင်သည် တစ်ဆင့်ခံချိတ်ဆက်မှုကို ရယူရမည်ဖြစ်သည်။ GetConnection() နှင့် libpg API ကိုသုံးပါ။ (ဖြစ်ကောင်းဖြစ်နိုင် ဒီမတရားမှုကို နောက်မှ ပြင်ပေးပါ့မယ်)။

ဒေတာဘေ့စ

#pragma once

#include <memory>
#include <mutex>
#include <libpq-fe.h>

class Database
{
public:
    Database();
    std::shared_ptr<PGconn> GetConnection() const;
    bool ExecuteSQL(const std::string& sql);

private:
    void establish_connection();
    void LoadEnvVariables();

    std::string m_dbhost;
    int         m_dbport;
    std::string m_dbname;
    std::string m_dbuser;
    std::string m_dbpass;

    std::shared_ptr<PGconn>  m_connection;
};

ဒေတာဘေ့စ်သို့ ချိတ်ဆက်ခြင်းအတွက် ကန့်သတ်ဘောင်အားလုံးကို ပတ်ဝန်းကျင်မှ ယူဆောင်သွားသောကြောင့် .env ဖိုင်ကို ဖန်တီးပြီး ပြင်ဆင်သတ်မှတ်ရန် လိုအပ်ပါသည်။

.env

DATABASE_NAME=template
DATABASE_USER=user
DATABASE_PASSWORD=password
DATABASE_HOST=postgres
DATABASE_PORT=5432

ကုဒ်တွေအားလုံးကို ကြည့်နိုင်ပါတယ်။ github

ယခုတွင် dockerfile နှင့် docker-compose.yml ကိုရေးသားခြင်း၏နောက်ဆုံးအဆင့်ရောက်လာသည်။ ရိုးရိုးသားသားပြောရလျှင် ဤအရာသည် အချိန်အများစုယူခဲ့ရသည်၊ ကျွန်ုပ်သည် လူဆိုးတစ်ဦးဖြစ်သောကြောင့်သာမက၊ စာကြည့်တိုက်များကို အချိန်တိုင်းပြန်လည်တည်ဆောက်ရန် လိုအပ်သောကြောင့်၊ ကိုနန်၏ချို့ယွင်းချက်များကြောင့်ဖြစ်သည်။ ဥပမာအားဖြင့်၊ conan ကို ဒေါင်းလုဒ်လုပ်ရန်၊ ထည့်သွင်းရန်နှင့် လိုအပ်သော မှီခိုမှုများကို တည်ဆောက်ရန်အတွက် "conan install" ကို ဒေါင်းလုဒ်လုပ်ရန် ၎င်းသည် မလုံလောက်ပါ၊ သို့မဟုတ်ပါက -s compiler.libcxx=libstdc++11 ဘောင်ကို ကျော်သွားရန်လိုအပ်ပါသည်။ သင့်လျှောက်လွှာကို ချိတ်ဆက်သည့်အဆင့်တွင် အမှားအယွင်းများစွာကို သင်ရနိုင်ခြေရှိသည်။ ဒီအမှားကို နာရီအတော်ကြာအောင် ပိတ်မိနေခဲ့ပြီး ဒီဆောင်းပါးက တခြားလူတွေကို ဒီပြဿနာကို အချိန်တိုအတွင်း ဖြေရှင်းနိုင်လိမ့်မယ်လို့ မျှော်လင့်ပါတယ်။

ထို့နောက်၊ docker-compose.yml ကိုရေးပြီးနောက်၊ ကျွန်ုပ်၏သူငယ်ချင်း၏အကြံပေးချက်အရ၊ ကျွန်ုပ်သည် ပံ့ပိုးကူညီမှုအား ထပ်လောင်းထည့်လိုက်ပါသည်။ ကွတ်ကီးညှပ် ယခု သင်သည် C++ ရှိ REST API ဝန်ဆောင်မှုအတွက် ပြီးပြည့်စုံသော နမူနာပုံစံကို စိတ်ကြိုက်ပတ်ဝန်းကျင်တစ်ခုနှင့် PostgreSQL ထည့်သွင်းထားပြီး၊ ကွန်ဆိုးလ်ထဲသို့ "ကွတ်ကီးကွတ်ကိရိယာ" ကိုထည့်ရုံဖြင့် သင့်ကိုယ်သင် ရနိုင်ပါပြီ။ https://github.com/KovalevVasiliy/cpp_rest_api_template.git“ ထို့နောက် “docker-compose up —build”။

ကြီးကျယ်ပြီး အစွမ်းထက်သော်လည်း C++ ကဲ့သို့ မိုက်ရိုင်းသောဘာသာစကားဖြင့် REST API အပလီကေးရှင်းများ ပြုစုပျိုးထောင်ရန် ခက်ခဲသောလမ်းကြောင်းပေါ်တွင် ဤပုံစံပလိတ်သည် စတင်သူများအတွက် ကူညီပေးလိမ့်မည်ဟု မျှော်လင့်ပါသည်။
ထို့အပြင် ဤနေရာတွင် ဖတ်ရှုရန် အထူးအကြံပြုလိုပါသည်။ ဤ ဆောင်းပါး။ ၎င်းသည် POCO နှင့် မည်သို့အလုပ်လုပ်ပုံနှင့် သင်၏ကိုယ်ပိုင် REST API ဝန်ဆောင်မှုကို ရေးသားနည်းကို အသေးစိတ်ရှင်းပြထားသည်။

source: www.habr.com