សេវាមីក្រូនៅក្នុង C ++ ។ រឿងប្រឌិត ឬការពិត?

នៅក្នុងអត្ថបទនេះខ្ញុំនឹងនិយាយអំពីរបៀបដែលខ្ញុំបង្កើតគំរូ (cookiecutter) និងរៀបចំបរិស្ថានសម្រាប់ការសរសេរសេវា REST API នៅក្នុង C++ ដោយប្រើ docker/docker-compose និងកម្មវិធីគ្រប់គ្រងកញ្ចប់ conan ។

ក្នុងអំឡុងពេល hackathon បន្ទាប់ ដែលខ្ញុំបានចូលរួមជាអ្នកអភិវឌ្ឍន៍កម្មវិធីខាងក្រោយ សំណួរបានកើតឡើងអំពីអ្វីដែលត្រូវប្រើដើម្បីសរសេរសេវាកម្មមីក្រូបន្ទាប់។ អ្វីៗ​ដែល​បាន​សរសេរ​រហូត​មក​ដល់​ពេល​នេះ គឺ​សរសេរ​ដោយ​ខ្ញុំ និង​ខ្ញុំ សមមិត្ត នៅក្នុង Python ចាប់តាំងពីសហសេវិករបស់ខ្ញុំជាអ្នកជំនាញក្នុងវិស័យនេះ និងបង្កើតកម្មវិធីខាងក្រោយប្រកបដោយវិជ្ជាជីវៈ ខណៈពេលដែលខ្ញុំជាទូទៅជាអ្នកបង្កើតប្រព័ន្ធបង្កប់ និងសរសេរនៅក្នុង C++ ដ៏អស្ចារ្យ និងគួរឱ្យខ្លាច ហើយខ្ញុំទើបតែរៀន Python នៅសាកលវិទ្យាល័យ។

ដូច្នេះ យើងត្រូវប្រឈមមុខនឹងភារកិច្ចនៃការសរសេរសេវាកម្មដែលមានបន្ទុកខ្ពស់ ដែលជាភារកិច្ចចម្បងគឺត្រូវដំណើរការទិន្នន័យដែលមកដល់វាជាមុន ហើយសរសេរវាទៅក្នុងមូលដ្ឋានទិន្នន័យ។ ហើយបន្ទាប់ពីការបែកផ្សែងមួយទៀត មិត្តម្នាក់បានស្នើឱ្យខ្ញុំក្នុងនាមជាអ្នកអភិវឌ្ឍន៍ C++ សរសេរសេវាកម្មនេះដោយប្រើអ្នកជំនាញ។ ដោយលើកហេតុផលនេះគឺថាវានឹងកាន់តែលឿន ផលិតភាពកាន់តែច្រើន ហើយជាទូទៅ គណៈវិនិច្ឆ័យនឹងរីករាយជាមួយនឹងរបៀបដែលយើងដឹងពីរបៀបគ្រប់គ្រងធនធានរបស់ក្រុម។ ដែលខ្ញុំបានឆ្លើយថា ខ្ញុំមិនដែលធ្វើរឿងបែបនេះនៅក្នុង C++ ហើយអាចចំណាយពេល 20+ ម៉ោងដែលនៅសល់ដើម្បីស្វែងរក ចងក្រង និងភ្ជាប់បណ្ណាល័យដែលសមរម្យបានយ៉ាងងាយស្រួល។ និយាយ​ឲ្យ​ចំ​ទៅ ខ្ញុំ​បាន​ចឹក។ នោះហើយជាអ្វីដែលយើងបានសម្រេចចិត្ត ហើយបានបញ្ចប់គ្រប់យ៉ាងដោយស្ងប់ស្ងាត់នៅក្នុង Python។

ឥឡូវនេះ ក្នុងអំឡុងពេលបង្ខំខ្លួនឯងឱ្យនៅដាច់ដោយឡែក ខ្ញុំបានសម្រេចចិត្តរកវិធីសរសេរសេវាកម្មនៅក្នុង C++ ។ រឿងដំបូងដែលត្រូវធ្វើគឺសម្រេចចិត្តលើបណ្ណាល័យដែលសមរម្យ។ ជម្រើសរបស់ខ្ញុំបានធ្លាក់ចុះ pocoចាប់តាំងពីវាត្រូវបានសរសេរក្នុងរចនាប័ទ្មតម្រង់ទិសវត្ថុ ហើយថែមទាំងមានអំនួតតាមរយៈឯកសារធម្មតា។ ដូចគ្នានេះផងដែរ, សំណួរបានកើតឡើងអំពីការជ្រើសរើសប្រព័ន្ធការជួបប្រជុំគ្នា។ រហូតមកដល់ចំណុចនេះ ខ្ញុំបានធ្វើការតែជាមួយ Visual Studio, IAR និង makefiles ទទេប៉ុណ្ណោះ។ ហើយ​គ្មាន​ប្រព័ន្ធ​ទាំង​នេះ​ទាក់​ទង​នឹង​ខ្ញុំ​ទេ ព្រោះ​ខ្ញុំ​មាន​គម្រោង​ដំណើរការ​សេវាកម្ម​ទាំង​មូល​ក្នុង​កុងតឺន័រ docker។ បន្ទាប់មកខ្ញុំបានសម្រេចចិត្តព្យាយាមស្វែងរក cmake និងកម្មវិធីគ្រប់គ្រងកញ្ចប់ដែលគួរឱ្យចាប់អារម្មណ៍ កោណ. កម្មវិធីគ្រប់គ្រងកញ្ចប់នេះអនុញ្ញាតឱ្យអ្នកចុះឈ្មោះភាពអាស្រ័យទាំងអស់នៅក្នុងឯកសារមួយ។

conanfile.txt
[ទាមទារ] poco/1.9.3
libpq/11.5

[ម៉ាស៊ីនភ្លើង] ស៊ីម៉ាក់

ហើយជាមួយនឹងពាក្យបញ្ជាសាមញ្ញ "conan install ." ដំឡើងបណ្ណាល័យចាំបាច់។ តាមធម្មជាតិ វាក៏ចាំបាច់ដើម្បីធ្វើការផ្លាស់ប្តូរផងដែរ។

CMakeLists.txt

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

បន្ទាប់ពីនោះមក ខ្ញុំចាប់ផ្តើមស្វែងរកបណ្ណាល័យដើម្បីធ្វើការជាមួយ PostgreSQL ព្រោះវាជាកន្លែងមួយដែលខ្ញុំមានបទពិសោធន៍តិចតួចក្នុងការធ្វើការជាមួយ ហើយវាក៏ជាសេវាកម្ម Python របស់យើងធ្វើអន្តរកម្មជាមួយផងដែរ។ ហើយតើអ្នកដឹងពីអ្វីដែលខ្ញុំបានរៀនទេ? វាស្ថិតនៅក្នុង POCO! ប៉ុន្តែ conan មិនដឹងថាវាស្ថិតនៅក្នុង POCO ហើយមិនដឹងពីរបៀបបង្កើតវាទេ មានឯកសារកំណត់រចនាសម្ព័ន្ធហួសសម័យនៅក្នុងឃ្លាំង (ខ្ញុំបានសរសេររួចហើយអំពីកំហុសនេះទៅកាន់អ្នកបង្កើត POCO)។ នេះមានន័យថាអ្នកនឹងត្រូវរកមើលបណ្ណាល័យមួយផ្សេងទៀត។

ហើយបន្ទាប់មកជម្រើសរបស់ខ្ញុំបានធ្លាក់ទៅលើបណ្ណាល័យដែលមិនសូវពេញនិយម libpg. ហើយខ្ញុំមានសំណាងមិនគួរឱ្យជឿ វាមាននៅក្នុង conan រួចហើយ ហើយថែមទាំងត្រូវបានប្រមូលផ្តុំ និងប្រមូលផ្តុំ។

ជំហានបន្ទាប់គឺត្រូវសរសេរគំរូសេវាកម្មដែលអាចដំណើរការសំណើ។
យើងត្រូវតែទទួលមរតក TemplateServerApp របស់យើងពី Poco::Util::ServerApplication ហើយបដិសេធវិធីសាស្ត្រសំខាន់។

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 សាមញ្ញដូចជាការបង្កើតតារាងមានវិធីសាស្រ្តមួយ។ ប្រតិបត្តិSQL(). សម្រាប់សំណួរដែលស្មុគ្រស្មាញ ឬការទាញយកទិន្នន័យ អ្នកនឹងត្រូវទទួលបានការតភ្ជាប់តាមរយៈ 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 ផងដែរ។

.NS

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

អ្នកអាចមើលកូដទាំងអស់នៅ github ។

ហើយឥឡូវនេះមកដល់ដំណាក់កាលចុងក្រោយនៃការសរសេរ dockerfile និង docker-compose.yml ។ និយាយឱ្យត្រង់ទៅ វាបានចំណាយពេលភាគច្រើន ហើយមិនត្រឹមតែដោយសារតែខ្ញុំជាក្មេងនោះទេ ព្រោះវាចាំបាច់ក្នុងការកសាងបណ្ណាល័យឡើងវិញរាល់ពេល ប៉ុន្តែដោយសារតែបញ្ហារបស់ conan ។ ជាឧទាហរណ៍ ដើម្បីឱ្យ conan ទាញយក ដំឡើង និងបង្កើតភាពអាស្រ័យចាំបាច់ វាមិនគ្រប់គ្រាន់សម្រាប់វាក្នុងការទាញយក "conan install ." វាក៏ត្រូវឆ្លងកាត់ប៉ារ៉ាម៉ែត្រ -s compiler.libcxx=libstdc++11 បើមិនដូច្នេះទេ អ្នកប្រថុយនឹងការទទួលកំហុសជាច្រើននៅដំណាក់កាលភ្ជាប់កម្មវិធីរបស់អ្នក។ ខ្ញុំបានជាប់គាំងជាមួយនឹងកំហុសនេះអស់រយៈពេលជាច្រើនម៉ោង ហើយខ្ញុំសង្ឃឹមថាអត្ថបទនេះនឹងជួយមនុស្សផ្សេងទៀតដោះស្រាយបញ្ហានេះក្នុងរយៈពេលតិច។

បន្ទាប់មក បន្ទាប់ពីសរសេរ docker-compose.yml តាមដំបូន្មានរបស់មិត្តខ្ញុំ ខ្ញុំបានបន្ថែមការគាំទ្រ អ្នកកាត់ខូឃី ហើយឥឡូវនេះ អ្នកអាចទទួលបានខ្លួនអ្នកនូវគំរូពេញលេញសម្រាប់សេវាកម្ម REST API នៅក្នុង C ++ ជាមួយនឹងបរិយាកាសផ្ទាល់ខ្លួន និងដំឡើង PostgreSQL ដោយគ្រាន់តែបញ្ចូល "cookiecutter" ទៅក្នុងកុងសូល។ https://github.com/KovalevVasiliy/cpp_rest_api_template.git" ហើយបន្ទាប់មក "docker-compose up-build" ។

ខ្ញុំសង្ឃឹមថាគំរូនេះនឹងជួយអ្នកចាប់ផ្តើមដំបូងនៅលើផ្លូវលំបាករបស់ពួកគេក្នុងការអភិវឌ្ឍន៍កម្មវិធី REST API ជាភាសាដ៏អស្ចារ្យ និងមានថាមពល ប៉ុន្តែជាភាសាដែលច្របូកច្របល់ដូចជា C ++ ជាដើម។
ដូចគ្នានេះផងដែរ ខ្ញុំសូមផ្តល់អនុសាសន៍ឱ្យអាននៅទីនេះ នេះ អត្ថបទ។ វាពន្យល់លម្អិតបន្ថែមទៀតអំពីរបៀបធ្វើការជាមួយ POCO និងសរសេរសេវាកម្ម REST API ផ្ទាល់ខ្លួនរបស់អ្នក។

ប្រភព: www.habr.com