C++ मा माइक्रोसेवाहरू। काल्पनिक वा वास्तविकता?

यस लेखमा म कसरी टेम्प्लेट (कुकीकटर) सिर्जना गर्छु र डकर/डकर-कम्पोज र कोनान प्याकेज प्रबन्धक प्रयोग गरेर C++ मा REST API सेवा लेख्नको लागि वातावरण सेटअप गर्ने बारे कुरा गर्नेछु।

अर्को ह्याकाथनको दौडान, जसमा मैले ब्याकएन्ड विकासकर्ताको रूपमा भाग लिएको थिएँ, अर्को माइक्रोसर्भिस लेख्न के प्रयोग गर्ने भन्ने प्रश्न उठ्यो। अहिले सम्म जे लेखिएको छ, त्यो मेरो र मेरो नै हो कामरेड पाइथनमा, किनकि मेरो सहकर्मी यस क्षेत्रमा विशेषज्ञ थिए र व्यावसायिक रूपमा ब्याकएन्डहरू विकसित गरे, जबकि म सामान्यतया एम्बेडेड प्रणाली विकासकर्ता थिएँ र ठूलो र भयानक C++ मा लेखेको थिएँ, र मैले भर्खर विश्वविद्यालयमा पाइथन सिके।

त्यसोभए, हामीले उच्च-लोड सेवा लेख्ने कार्यको सामना गर्‍यौं, जसको मुख्य कार्य भनेको यसमा आउने डाटालाई पूर्वप्रक्रिया गर्नु र डाटाबेसमा लेख्नु थियो। र अर्को धुवाँ ब्रेक पछि, एक साथीले सुझाव दिए कि म, एक C++ विकासकर्ताको रूपमा, पेशेवरहरू प्रयोग गरेर यो सेवा लेख्नुहोस्। यो तर्क गर्नु यो छ कि यो छिटो, अधिक उत्पादक हुनेछ, र सामान्यतया, जूरी हामी कसरी टोलीका स्रोतहरू व्यवस्थापन गर्ने भनेर जान्दछौं भनेर खुशी हुनेछ। जसको जवाफमा मैले C++ मा त्यस्ता कुराहरू कहिल्यै गरेको थिइनँ र बाँकी २०+ घण्टा उपयुक्त पुस्तकालयहरू खोज्न, कम्पाइल गर्न र लिङ्क गर्न सजिलै खर्च गर्न सक्छु। सरल भाषामा भन्नुपर्दा, म कुखुरा बाहिर। त्यो हामीले निर्णय गर्यौं र शान्तपूर्वक पाइथनमा सबै कुरा पूरा गर्यौं।

अब, जबरजस्ती आत्म-अलगावको समयमा, मैले C++ मा सेवाहरू कसरी लेख्ने भनेर पत्ता लगाउने निर्णय गरें। पहिलो कुरा उपयुक्त पुस्तकालयको निर्णय थियो। मेरो रोजाईमा पर्यो Poco, किनकि यो वस्तु-उन्मुख शैलीमा लेखिएको थियो र सामान्य कागजातको घमण्ड पनि गर्यो। साथै, विधानसभा प्रणाली छनोटमा प्रश्न उठ्यो। यस बिन्दु सम्म मैले भिजुअल स्टुडियो, IAR र बेयर मेकफाइलहरूमा मात्र काम गरेको छु। र यी मध्ये कुनै पनि प्रणालीले मलाई अपील गरेन, किनकि मैले सम्पूर्ण सेवा डकर कन्टेनरमा चलाउने योजना बनाएको थिएँ। त्यसपछि मैले cmake र एक रोचक प्याकेज प्रबन्धक पत्ता लगाउन प्रयास गर्ने निर्णय गरे Conan। यो प्याकेज प्रबन्धकले तपाईंलाई एक फाइलमा सबै निर्भरताहरू दर्ता गर्न अनुमति दिन्छ

conanfile.txt
[आवश्यक छ]poco/1.9.3
libpq/11.5

[जेनरेटर] cmake

र एक साधारण आदेश संग "conan install ।" आवश्यक पुस्तकालयहरू स्थापना गर्नुहोस्। स्वाभाविक रूपमा, यसमा परिवर्तनहरू पनि आवश्यक थियो

CMakeLists.txt

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

त्यस पछि, मैले PostgreSQL सँग काम गर्नको लागि एउटा पुस्तकालय खोज्न थाले, किनकि यो एउटा थियो जसमा मैले काम गर्ने अनुभव कम गरेको थिएँ, र यो हाम्रो पाइथन सेवाहरूसँग अन्तर्क्रिया गरिएको थियो। अनि मैले के सिकेको छु थाहा छ? यो POCO मा छ! तर कोननलाई थाहा छैन कि यो POCO मा छ र यसलाई कसरी बनाउने भनेर थाहा छैन; त्यहाँ भण्डारमा पुरानो कन्फिगरेसन फाइल छ (मैले पहिले नै POCO को सिर्जनाकर्ताहरूलाई यस त्रुटिको बारेमा लेखेको छु)। यसको मतलब तपाईंले अर्को पुस्तकालय खोज्नुपर्नेछ।

र त्यसपछि मेरो छनौट कम लोकप्रिय पुस्तकालयमा पर्यो libpg। र म अविश्वसनीय रूपमा भाग्यशाली थिएँ, यो पहिले नै कोननमा थियो र भेला र भेला भईरहेको थियो।

अर्को चरण अनुरोधहरू प्रक्रिया गर्न सक्ने सेवा टेम्प्लेट लेख्नु थियो।
हामीले 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()। थप जटिल प्रश्नहरू वा डाटा पुन: प्राप्तिको लागि, तपाईंले मार्फत जडान प्राप्त गर्नुपर्नेछ जडान प्राप्त गर्नुहोस्() र 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 फाइल सिर्जना र कन्फिगर गर्न आवश्यक छ।

एनएस

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" र त्यसपछि "डकर-कम्पोज अप -बिल्ड"।

मलाई आशा छ कि यस टेम्प्लेटले शुरुवातकर्ताहरूलाई उनीहरूको REST API अनुप्रयोगहरू उत्कृष्ट र शक्तिशाली, तर C++ जस्ता अनाड़ी भाषामा विकास गर्ने कठिन मार्गमा मद्दत गर्नेछ।
साथै, म यहाँ पढ्न सिफारिस गर्दछु यो लेख। यसले POCO सँग कसरी काम गर्ने र तपाईंको आफ्नै REST API सेवा लेख्ने बारे थप विवरण दिन्छ।

स्रोत: www.habr.com