libjson rpc cpp

لقد قمت بإنشاء تطبيق C ++ 17 جديد فقط-> JSON-RPC-CXX.

يتقن

Libjson-RPC-CPP

يوفر هذا الإطار دعم Cross Platform JSON-RPC (استدعاء الإجراءات عن بُعد) لـ C ++. إنه متوافق تمامًا مع JSON-RPC 2.0 و 1.0.

5 أسباب وجيهة لاستخدام Libjson-RPC-CPP في مشروع RPC التالي

• Full JSON-RPC 2.0 و JSON-RPC 1.0 دعم العميل والخادم.
• JSONRPCSTUB-أداة تنشئ فئات كعب لتطبيقات عميل JSON-RPC وخادمك.
• جاهز لاستخدام خادم HTTP + TCP والعميل لتوفير واجهات بسيطة لتطبيق JSON-RPC الخاص بك.
• Cross Platform Build Support for Linux و OS X.
• سوبر ليبرالي معهد ماساتشوستس للتكنولوجيا.

أسباب وجيهة أخرى لاستخدام Libjson-RPC-CPP

• من السهل استخدام نظام بناء منصة Cmake Cross.
• بنية نظيفة وبسيطة ، مما يجعل من السهل تمديده.
• تم اختباره بشكل مستمر تحت MacOS ، وتوزيعات Linux المختلفة.
• الاختبار الآلي باستخدام make test .
• أمثلة مفيدة المقدمة. EG XBMC عن بُعد باستخدام جزء عميل JSON-RPC ومولد كعب.
• يدعم Studgenerator حاليًا C ++ و JavaScript و Python.

ملخص

تثبيت الإطار

Debian (Stretch) و Ubuntu (15.10 أو أحدث)

sudo apt-get install libjsonrpccpp-dev libjsonrpccpp-tools

فيدورا

sudo dnf install libjson-rpc-cpp-devel libjson-rpc-cpp-tools

قوس لينكس

بالنسبة للقوس Linux ، يوجد PKGBUILD المقدم في AUR.

sudo aura -A libjson-rpc-cpp

Gentoo Linux

sudo emerge dev-cpp/libjson-rpc-cpp

ماك OS X.

لنظام التشغيل X ، تتوفر حزمة المشروب:

brew install libjson-rpc-cpp

النوافذ

هناك حزمة جاهزة لاستخدام الحزمة المترجمة هنا. فقط تنزيل تنفيذ المثبت exe.

بناء من المصدر

تثبيت التبعيات

• libcurl
• libmicrohttpd
• libjsoncpp
• libargtable
• cmake
• libhiredis
• يمسك

يونيكس

بالنسبة لأنظمة Debian و Arch GNU/Linux ، تتوفر جميع التبعيات عبر مدير الحزمة. بالنسبة لنظام التشغيل X ، تتوفر جميع التبعيات في المشروب

يبني

git clone https://github.com/cinemast/libjson-rpc-cpp.git
mkdir -p libjson-rpc-cpp/build
cd libjson-rpc-cpp/build
cmake .. && make
sudo make install
sudo ldconfig          # only required for linux

هذا كل شيء!

إذا لم تكن راضيًا عنها ، فما عليك سوى إلغاء تثبيت نظامك (داخل البناء على الدليل):

sudo make uninstall

خيارات البناء:

يجب أن يكون التكوين الافتراضي جيدًا بالنسبة لمعظم الأنظمة ، ولكن هنا تتوفر أعلام التجميع:

• -DCOMPILE_TESTS=NO يعطل مجموعة اختبار الوحدة.
• -DCOMPILE_STUBGEN=NO يعطل بناء القفل.
• -DCOMPILE_EXAMPLES=NO توجد أمثلة.
• -DHTTP_SERVER=NO تعطيل خادم الويب libmicrohttpd.
• -DHTTP_CLIENT=NO تعطيل عميل Curl.
• -DREDIS_SERVER=NO تعطيل موصل خادم Redis.
• -DREDIS_CLIENT=NO تعطيل موصل عميل redis.
• -DUNIX_DOMAIN_SOCKET_SERVER=YES ، تمكين موصل خادم مقبس UNIX.
• -DUNIX_DOMAIN_SOCKET_CLIENT=YES ، تمكين موصل عميل مقبس Domain UNIX.
• -DFILE_DESCRIPTOR_SERVER=NO تعطيل موصل خادم واصف الملف.
• -DFILE_DESCRIPTOR_CLIENT=NO تعطيل موصل عميل واصف الملف.
• -DTCP_SOCKET_SERVER=NO تعطيل موصل خادم Socket TCP.
• -DTCP_SOCKET_CLIENT=NO تعطيل موصل عميل Socket TCP.

باستخدام الإطار

سيُظهر هذا المثال الطريقة أبطأ لإنشاء خادم وعميل RPC. إذا كنت بحاجة إلى الخادم فقط ، فتجاهل الخطوة 4. إذا كنت بحاجة إلى العميل فقط ، فتجاهل الخطوة 3. يمكنك العثور على جميع موارد هذه العينة في دليل src/examples لهذا المستودع.

الخطوة 1: كتابة ملف المواصفات

[
	{
		"name" : " sayHello " ,
		"params" : {
			"name" : " Peter "
		},
		"returns" : " Hello Peter "
	},
	{
		"name" : " notifyServer "
	}
]

يتم تعريف نوع قيمة الإرجاع أو المعلمة بواسطة الحرفي المخصص لها. سوف تستخدم كعب الرعب الذي تم إنشاؤه نوع "الإرجاع" للتحقق من استجابة. في هذا المثال ، يمكنك معرفة كيفية تحديد الأساليب والإخطارات.

الخطوة 2: إنشاء كعب العميل والخادم

استدعاء jsonrpcstub:

jsonrpcstub spec.json --cpp-server=AbstractStubServer --cpp-client=StubClient
mkdir -p gen
mv abstractstubserver.h gen
mv stubclient.h gen

هذا يولد AbstractStubServer وفئة StubClient وينقلهم إلى المجلد gen .

الخطوة 3: تنفيذ كعب الخادم التجريدي

تمديد كعب الخادم التجريدي وتنفيذ جميع الطرق الافتراضية الخالصة (التجريدية) المحددة في spec.json .

انظر SRC/أمثلة/كوبسير

في الوظيفة الرئيسية ، يتم إنشاء خادم ملموس وبدأ. هذا كل شيء للخادم. يمكن لأي عميل متوافق مع JSON-RPC 2.0 الاتصال بالخادم الخاص بك.

تجميع الخادم مع:

g++ stubserver.cpp -ljsoncpp -lmicrohttpd -ljsonrpccpp-common -ljsonrpccpp-server -o sampleserver

الخطوة 4: إنشاء تطبيق العميل

انظر SRC/أمثلة/stubClient.cpp

تجميع العميل مع:

g++ stubclient.cpp -ljsoncpp -lcurl -ljsonrpccpp-common -ljsonrpccpp-client -o sampleclient

مساهمات

يرجى إلقاء نظرة على المساهمة

يمكنك أيضا التبرع عبر

Changelogs

يمكن العثور على changelogs هنا.

توافق API

نحن نبذل قصارى جهدنا للحفاظ على استقرار API/ABI ، لمنع المشاكل عند تحديث هذا الإطار. يمكن العثور على تقرير التوافق هنا.

رخصة

هذا الإطار مرخص تحت معهد ماساتشوستس للتكنولوجيا. جميع هذه التبعيات من المكتبات مرخصة بموجب التراخيص المتوافقة مع MIT.

مراجع

• مركز أبحاث ناسا أميس: استخدمه للحصول على معلومات حالة الطائرات من محاكاة للطائرات.
• طابعة Laseshark 3D: تستخدم للتحكم في البرامج الثابتة للطابعة ثلاثية الأبعاد.
• CPP-ethereum: تطبيقات C ++ لعملة تشفير Ethereum.
• Mage-SDK-CPP: محرك لعبة.
• Bitcodin: منصة ترميز الفيديو القابل للتطوير السحابي.
• WGSLIB: مكتبة الويب الإلكترونية على شبكة الإنترنت.
• Bitcoin-API-CPP: واجهة C ++ إلى Bitcoin.
• خادم محتوى NIT DASH: تدفق Adaptive ديناميكي عبر خادم HTTP.

إذا استخدمت هذه المكتبة ووجدتها مفيدة ، فسأكون سعيدًا جدًا إذا أخبرتني بذلك.