C++ এ মাইক্রোসার্ভিস। কল্পকাহিনী নাকি বাস্তবতা?

এই নিবন্ধে আমি কীভাবে একটি টেমপ্লেট (কুকিকাটার) তৈরি করেছি এবং ডকার/ডকার-কম্পোজ এবং কোনান প্যাকেজ ম্যানেজার ব্যবহার করে C++ এ একটি REST API পরিষেবা লেখার জন্য একটি পরিবেশ সেট আপ করেছি সে সম্পর্কে কথা বলব।

পরবর্তী হ্যাকাথনের সময়, যেটিতে আমি ব্যাকএন্ড ডেভেলপার হিসেবে অংশগ্রহণ করেছিলাম, পরবর্তী মাইক্রোসার্ভিস লিখতে কী ব্যবহার করতে হবে তা নিয়ে প্রশ্ন উঠেছিল। এ পর্যন্ত যা কিছু লেখা হয়েছে সবই আমার এবং আমার লেখা কমরেড পাইথনে, যেহেতু আমার সহকর্মী এই ক্ষেত্রে একজন বিশেষজ্ঞ ছিলেন এবং পেশাদারভাবে ব্যাকএন্ড তৈরি করেছিলেন, যখন আমি সাধারণত একটি এমবেডেড সিস্টেম বিকাশকারী ছিলাম এবং দুর্দান্ত এবং ভয়ঙ্কর C++ এ লিখতাম, এবং আমি বিশ্ববিদ্যালয়ে পাইথন শিখেছি।

সুতরাং, আমরা একটি উচ্চ-লোড পরিষেবা লেখার কাজটির মুখোমুখি হয়েছিলাম, যার প্রধান কাজ ছিল এটিতে আসা ডেটাকে প্রিপ্রসেস করা এবং এটি ডাটাবেসে লেখা। এবং আরেকটি ধোঁয়া বিরতির পরে, একজন বন্ধু পরামর্শ দিয়েছিল যে আমি, একজন C++ বিকাশকারী হিসাবে, পেশাদারদের ব্যবহার করে এই পরিষেবাটি লিখি। এই যুক্তি হল যে এটি দ্রুততর, আরও উত্পাদনশীল হবে এবং সাধারণভাবে, আমরা কীভাবে দলের সংস্থানগুলি পরিচালনা করতে জানি তা নিয়ে জুরিরা আনন্দিত হবে। যার উত্তরে আমি বলেছিলাম যে আমি C++ তে এমন কিছু করিনি এবং বাকি 20+ ঘন্টা সহজে উপযুক্ত লাইব্রেরি অনুসন্ধান, সংকলন এবং লিঙ্ক করার জন্য ব্যয় করতে পারি। সহজ কথায়, আমি চিকেন আউট. এটিই আমরা সিদ্ধান্ত নিয়েছি এবং শান্তভাবে পাইথনে সবকিছু সম্পন্ন করেছি।

এখন, জোরপূর্বক স্ব-বিচ্ছিন্নতার সময়, আমি সি++ এ পরিষেবাগুলি কীভাবে লিখতে হয় তা নির্ধারণ করার সিদ্ধান্ত নিয়েছি। প্রথম জিনিসটি একটি উপযুক্ত গ্রন্থাগারের বিষয়ে সিদ্ধান্ত নেওয়া হয়েছিল। আমার পছন্দ পড়ে গেল Poco, যেহেতু এটি একটি অবজেক্ট-ওরিয়েন্টেড শৈলীতে লেখা হয়েছিল এবং স্বাভাবিক ডকুমেন্টেশনের গর্বও করেছিল। এছাড়াও, একটি সমাবেশ পদ্ধতি নির্বাচন সম্পর্কে প্রশ্ন উঠেছে। এই বিন্দু পর্যন্ত আমি শুধুমাত্র ভিজ্যুয়াল স্টুডিও, আইএআর এবং বেয়ার মেকফাইল নিয়ে কাজ করেছি। এবং এই সিস্টেমগুলির কোনওটিই আমার কাছে আবেদন করেনি, যেহেতু আমি পুরো পরিষেবাটি একটি ডকার কন্টেইনারে চালানোর পরিকল্পনা করেছি। তারপর আমি 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 ক্লাসের উত্তরাধিকারী হতে হবে এবং মূল পদ্ধতিকে ওভাররাইড করতে হবে।

টেমপ্লেট সার্ভার অ্যাপ

#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;
}

প্রধান পদ্ধতিতে আমাদের অবশ্যই পরামিতিগুলি সেট করতে হবে: পোর্ট, থ্রেডের সংখ্যা এবং সারির আকার। এবং সবচেয়ে গুরুত্বপূর্ণ, আগত অনুরোধের জন্য আপনাকে অবশ্যই একটি হ্যান্ডলার নির্দিষ্ট করতে হবে। এটি একটি কারখানা তৈরি করে করা হয়

TemplateRequestHandler Factory

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 এর সাথে কাজ করার জন্য আমি একটি ক্লাস টেমপ্লেটও তৈরি করেছি। সহজ এসকিউএল সঞ্চালন করার জন্য, যেমন একটি টেবিল তৈরি, একটি পদ্ধতি আছে এক্সিকিউট এসকিউএল(). আরও জটিল প্রশ্ন বা ডেটা পুনরুদ্ধারের জন্য, আপনাকে এর মাধ্যমে একটি সংযোগ পেতে হবে সংযোগ পান() এবং 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 install" ডাউনলোড করার জন্য এটি যথেষ্ট নয়, এটিকে -s compiler.libcxx=libstdc++11 প্যারামিটারও পাস করতে হবে, অন্যথায় আপনার আবেদনের লিঙ্ক করার পর্যায়ে আপনার একগুচ্ছ ত্রুটি হওয়ার ঝুঁকি রয়েছে। আমি কয়েক ঘন্টা ধরে এই ত্রুটির সাথে আটকে আছি এবং আমি আশা করি এই নিবন্ধটি অন্য লোকেদেরকে কম সময়ে এই সমস্যাটি সমাধান করতে সহায়তা করবে৷

এরপর, docker-compose.yml লেখার পর, আমার বন্ধুর পরামর্শে, আমি সমর্থন যোগ করেছি মিষ্টি বিস্কিট কাটার যন্ত্র এবং এখন আপনি C++-এ একটি REST API পরিষেবার জন্য একটি পূর্ণাঙ্গ টেমপ্লেট পেতে পারেন, একটি কাস্টমাইজড পরিবেশ সহ, এবং PostgreSQL ইনস্টল করা, কেবল কনসোলে "কুকিকাটার" প্রবেশ করে https://github.com/KovalevVasiliy/cpp_rest_api_template.git" এবং তারপর "ডকার-কম্পোজ আপ -বিল্ড"।

আমি আশা করি এই টেমপ্লেটটি নতুনদেরকে তাদের দুর্দান্ত এবং শক্তিশালী, কিন্তু C++ এর মতো আনাড়ি ভাষায় REST API অ্যাপ্লিকেশন তৈরির কঠিন পথে সাহায্য করবে।
এছাড়াও, আমি এখানে পড়ার সুপারিশ করছি এই নিবন্ধ এটি আরও বিস্তারিতভাবে ব্যাখ্যা করে কিভাবে POCO এর সাথে কাজ করতে হয় এবং আপনার নিজের REST API পরিষেবা লিখতে হয়।

উত্স: www.habr.com