QHessian: Qt और Hessian

लेख में Qt लाइब्रेरी स्टैक पर हेसियन बाइनरी वेब प्रोटोकॉल के कार्यान्वयन को शामिल किया गया है। सी ++ लक्ष्य मंच।



हेसियन एक बाइनरी वेब प्रोटोकॉल है जो उपयोगी वेब सेवाओं को बनाने के लिए डिज़ाइन किया गया है (दूसरे शब्दों में, यह बात आपको बताएगी कि किसी भी एप्लिकेशन से आपकी विंडो के बाहर का मौसम कैसा है)। हेसियन का विकास काऊको टेक्नोलॉजी, इंक। कंपनी ने जावा, पायथन और एक्शनस्क्रिप्ट के लिए प्रोटोकॉल कार्यान्वयन भी विकसित किया। तृतीय-पक्ष कंपनियों ने लगभग सभी प्रोग्रामिंग भाषाओं (C ++, C #, Perl, PHP, Ruby, Objective-C, D, Erlang) के लिए कार्यान्वयन विकसित किया है।

मान लीजिए कि हमारे पास सर्वर पर सेब की एक टोकरी है। और हम ग्राहक के अनुरोध पर उसे एक सेब देना चाहते हैं। यह वह जगह है जहाँ हेसियन हमारी मदद करेगा।

सर्वर पर, हम सेवा इंटरफ़ेस (जावा में सर्वर) बनाते हैं:

public interface FruitService {
Apple getNextApple();
}

* This source code was highlighted with Source Code Highlighter .

हम ग्राहक (C ++) पर एक समान श्रेणी बनाते हैं:

class FruitService {
public :
Apple getNextApple();
}

* This source code was highlighted with Source Code Highlighter .

जब getNextApple () विधि क्लाइंट पर कॉल की जाती है, तो हेसियन कार्यान्वयन सर्वर (एक समान सर्वर विधि के लिए) से अनुरोध करता है और ग्राहक को परिणाम देता है। हेसियन हमें नेटवर्क के माध्यम से सेब पहुंचाने के लिए प्रतिबद्ध है। वास्तव में, यह सर्वर पर डेटा को क्रमबद्ध करता है और क्लाइंट पर इसे डिसेर्बलाइज करता है। एक सेब को बाइट सरणी में बदलना, इसे एक नेटवर्क पर स्थानांतरित करना, और एक सरणी से सेब को पुनर्स्थापित करना हेसियन कार्य है। बाकी आपका काम है।

क्यूटी
क्यूटी एक रूपरेखा के रूप में व्यापक रूप से जाना जाता है और शायद ही इसे पेश करने की आवश्यकता है। मैं केवल ध्यान देता हूं कि हम क्यूटी सी ++ के लिए हेसियन प्रोटोकॉल के कार्यान्वयन के बारे में बात करेंगे।

सामान्य तौर पर, C ++ के तहत प्रोटोकॉल के कई कार्यान्वयन (मैं 2 खोजने में कामयाब रहे):

• हेसियन सीपीपी
• hessianorb

हेसियन सीपीपी और हेसियनोरब महान परियोजनाएं हैं और वे काफी कार्यात्मक हैं। प्रारंभ में, मैंने अपने विकास के लिए हेसियनोरब का उपयोग किया - यह कोड पीढ़ी का समर्थन करता है, अर्थात। आपको एक टीम के साथ अपनी सभी सेवाओं के लिए C ++ प्रॉक्सी बनाने की अनुमति देता है (दो घंटे की तैयारी के बाद)।

दुर्भाग्य से, दोनों कार्यान्वयन आपको क्यूटी वातावरण में विदेशी दिखने वाले कोड बनाने के लिए मजबूर करते हैं। उन्हें एक अतिरिक्त पुस्तकालय स्टैक की आवश्यकता है: हेसियन सीपीपी - एसएसएलपीपी, हेसियोनर्ब - सीईआरएल। यह तथ्य, निश्चित रूप से, क्रॉस-प्लेटफॉर्म विकास को जटिल बनाता है। जाहिर है, नेटवर्क डेटा ट्रांसफर के लिए इन पुस्तकालयों की जरूरत होती है, लेकिन नेटवर्क के साथ काम करने के लिए Qt की अपनी एक परत है और मैं इसका इस्तेमाल करना चाहता था। इसके अलावा, दोनों कार्यान्वयन सर्वर के साथ बातचीत करते समय निष्पादन प्रवाह को अवरुद्ध करते हैं, जबकि क्यूटी नेटवर्क परत अतुल्यकालिक है।

इस प्रकार , मेरा लक्ष्य QNetworkAccessManager और इसके अतुल्यकालिक प्रकृति के उपयोग के आधार पर एक प्रोटोकॉल कार्यान्वयन बनाना था।

QHessian

QHessian (इसके बाद qh) एक हेसियन प्रोटोकॉल कार्यान्वयन है जो तीसरे पक्ष के पुस्तकालयों का उपयोग नहीं करता है। दूसरे शब्दों में, Qt लाइब्रेरी स्टैक इस कार्यान्वयन के साथ काम करने के लिए पर्याप्त है।

जैसा कि मैंने पहले उल्लेख किया है, हेसियन का लक्ष्य क्रमबद्ध करना है, नेटवर्क पर संचार करना और डेटा को डीरियलाइज़ करना है। QNetworkAccessManager नेटवर्क पर संचरण का ध्यान रखता है। हेसियन 2.0 सीरियलाइजेशन प्रोटोकॉल के अनुसार डेटा क्रमबद्ध और deserialized है। दस्तावेज़ में कहा गया है कि प्रोटोकॉल कार्यान्वयन में सक्षम होना चाहिए:

• कच्चे बाइनरी डेटा को पढ़ें / लिखें
• पढ़ने / लिखने बूलियन
• 64-बिट मिलीसेकंड तिथि पढ़ें / लिखें
• 64-बिट डबल पढ़ें / लिखें
• 32-बिट इंट पढ़ें / लिखें
• 64-बिट लंबा पढ़ें / लिखें
• null पढ़ें / लिखें
• UTF8- एन्कोडेड स्ट्रिंग पढ़ें / लिखें
• सूचियों और सरणियों को पढ़ें / लिखें
• मानचित्रों और शब्दकोशों को पढ़ें / लिखें
• वस्तुओं को पढ़ें / लिखें
• साझा और परिपत्र वस्तु संदर्भों के लिए रेफरी पढ़ें / लिखें
• ऑब्जेक्ट / लिस्ट रेफरेंस मैप पढ़ें / लिखें
• कक्षा परिभाषा संदर्भ मानचित्र पढ़ें / लिखें
• पढ़ने / लिखने के प्रकार (वर्ग नाम) संदर्भ नक्शा

इस आवश्यकता को लागू करने के लिए, qh अपने स्वयं के प्रकार पदानुक्रम का उपयोग करता है:

• अशक्त मान पढ़ें / लिखें
• बूलियन पढ़ने / लिखने बूल
• पूर्णांक 32-बिट संख्या (qint32) पढ़ें / लिखें
• 64-बिट संख्या (qint64) को लंबे समय तक पढ़ना / लिखना
• 64-बिट IEEE 754 गैर-पूर्णांक (वास्तविक) डबल रीड / राइट
• स्ट्रिंग पढ़ना / लिखना UTF-8 स्ट्रिंग (QString)
• दिनांक समय पढ़ने / लिखने की तिथि (QDateTime)
• बाइट पढ़ने / लिखने बाइट सरणी (QByteArray)
• BeginCollection संग्रह की शुरुआत को पढ़ें / लिखें
• EndCollection Read / Write End Collection
• StartMap प्रारंभ मानचित्र पढ़ें / लिखें
• HasMoreMap केवल पढ़ने के लिए - नक्शे के अंत की जाँच करें
• एंडपॉइंट मैप के एंड को पढ़ें / लिखें
• BeginObject वस्तु की शुरुआत को पढ़ता / लिखता है
• एंड ऑबजेक्ट ऑब्जेक्ट के पढ़ने / लिखने का अंत
• रेफरी पढ़ें / लिखें वस्तु संदर्भ

क्यूएच के साथ काम करने वाले तंत्र मानक इनपुट / आउटपुट धाराओं के साथ काम करने के लिए तंत्र की प्रतिलिपि बनाते हैं। यानी पठन " >> " ऑपरेटर का उपयोग करके किया जाता है, और क्रमशः लेखन, " << " ऑपरेटर का उपयोग करके किया जाता है। पढ़ना एक विशेष QHessianReturnParser ऑब्जेक्ट (सर्वर प्रतिक्रिया पार्सर) से किया जाता है। और रिकॉर्ड QHessianMethodCall ऑब्जेक्ट (सर्वर पर भेजने के लिए डेटा तैयार करना) में है।

उदाहरण के लिए, नमूना सर्वर विधि (पूर्णांक, स्ट्रिंग, तिथि) को कॉल करने के लिए, आपको कोड निष्पादित करना होगा:

{
using namespace QHessian:: in ;
QHessian::QHessianMethodCall call( "sample" );
call << Long(55) << String (“”) << DateTime (QDateTime::currentDateTime ());
call.invoke(networkManager,
QUrl(“http: //serviceUrl”), //
myQObject, // QObject,
SLOT(reply()), //
SLOT(error( int , const QString&))); //
}

* This source code was highlighted with Source Code Highlighter .

यह कोड नमूना पद्धति को पैरामीटर 55, वसीली, वर्तमान समय के साथ कॉल करेगा। सर्वर की प्रतिक्रिया myQObject ऑब्जेक्ट के त्रुटि स्लॉट में, myQObject ऑब्जेक्ट के उत्तर () स्लॉट में संसाधित की जाएगी, या। आपको याद दिला दूं कि कॉल ब्लॉक नहीं हो रही है, अर्थात मल्टीथ्रेडिंग के साथ भाप की आवश्यकता नहीं है।

कल्पना करें कि हमारी सेवा केवल वस्तु com.googlecode.AnswerObject में दिए गए डेटा को वापस करती है। तब उत्तर स्लॉट में प्रतिक्रिया को संसाधित करना इस तरह दिखेगा:

void MyQObject::reply() {
using namespace QHessian:: out ;

qint32 long ;
QString string ;
QDateTime dateTime;

QHessian::QHessianReturnParser& parser =
*(QHessian::QHessianReturnParser*) QObject::sender();

parser >> BeginObject(“com.googlecode.AnswerObject”)
>> Long( long )
>> String ( String )
>> DateTime (dateTime)
>> EndObject();

parser.deleteLater();
}

* This source code was highlighted with Source Code Highlighter .

निष्पादन के बाद, लंबे समय तक मूल्य 55 होगा, स्ट्रिंग - वासिली, डेटाइम - प्रेषित समय।

QHessian संग्रह (सरणियाँ, सूचियाँ, साहचर्य सरणियाँ, आदि) का समर्थन करता है।
यह सर्वर प्रतिक्रिया से बहुभुज वर्ग पढ़ सकता है:

{
using namespace QHessian:: out ;

QHessian::QHessianReturnParser& parser =
*(QHessian::QHessianReturnParser*) QObject::sender();

qint32 pointCount;

parser >> BeginObject( "Polygon" );
parser >> BeginCollection(“points”, pointCount);

for ( int i=0; i<pointCount; ++i) {
qint32 x, y;
parser >> Integer(x) >> Integer(y);
}

parser >> EndCollection();
parser >> EndObject();
parser.deleteLater();
}

* This source code was highlighted with Source Code Highlighter .

इस कोड में:

• बिगबोज ("बहुभुज"); - बहुभुज वर्ग के साथ एक वस्तु खोलें;
• बिगुलियनशन ("अंक", पॉइंटकाउंट); - संग्रह खोलें और अपनी लंबाई पॉइंटकाउंट में डालें;
• लूप के लिए हम बिंदुओं के पदों को पढ़ते हैं;
• EndCollection (); - संग्रह बंद करें;
• एंडऑब्जेक्ट (); - वस्तु को बंद करें।

यह भी संभव है कि हम ऑब्जेक्ट के प्रकार को नहीं जानते हैं, उदाहरण के लिए, सर्वर एक अप्रकाशित सूची सूची <? ज्योमेट्री का विस्तार> इस मामले में, आपको विशेष पिंगिंग () पद्धति का उपयोग करने की आवश्यकता है, जो यह निर्धारित करती है कि क्या स्ट्रीम से पढ़ने का वांछित संचालन करना संभव है (एक उदाहरण परियोजना वेबसाइट पर है)।

निष्कर्ष
मेरा मानना ​​है कि प्रोटोकॉल का पूरी तरह उपयुक्त कार्यान्वयन निकला है, जिसका उपयोग वास्तविक अनुप्रयोगों में किया जा सकता है।

प्लसस में शामिल हैं:

• पूरी तरह से क्यूटी पर आधारित, अर्थात तीसरे पक्ष के पुस्तकालयों को जोड़ने की कोई आवश्यकता नहीं है।
• अतुल्यकालिक प्रकृति।
• यह क्लाइंट एप्लिकेशन में पूर्ण सर्वर ऑब्जेक्ट मॉडल के पुनर्निर्माण की आवश्यकता नहीं है (यानी, केवल वही पढ़ें जो आपको चाहिए)।
• परीक्षण किया गया - कैचो टेक्नोलॉजी, इंक द्वारा प्रस्तावित सभी परीक्षणों को पास करता है। प्लस अपने स्वयं के परीक्षण ढेर।
• प्रयोग करने में आसान (यह मुझे लगता है)।

विपक्ष द्वारा:

• Qh में कोड जनरेशन का अभाव है। हेसियनोरब के साथ मेरे अनुभव ने मुझे आश्वस्त किया कि कोड पीढ़ी उतनी उपयोगी नहीं है जितना लगता है। सबसे पहले: पर्यावरण अक्सर बदलता रहता है और आपको लगातार कोड जनरेशन करना पड़ता है, जो कि हेसियनबोर में उतना आसान नहीं है जितना हम चाहेंगे; और दूसरी बात: बहुत से अनावश्यक अनावश्यक कोड दिखाई देते हैं (संपूर्ण ऑब्जेक्ट मॉडल उत्पन्न होता है, लेकिन इसकी अक्सर आवश्यकता नहीं होती है)। हालांकि, qh बहुत निम्न-स्तर का निकला, और एक महान इच्छा के साथ, एक कोड पीढ़ी तंत्र विकसित किया जा सकता है।
• आपको सर्वर प्रतिक्रिया की संरचना को जानना होगा।

संदर्भ:
हेसियन: http://hessian.caucho.com
QHessian: http://code.google.com/p/qhessian
QHessian FAQ: http://code.google.com/p/qhessian/wiki/FAQ
QHessian QA: http://code.google.com/p/qhessian/wiki/QHessian_QA

आपका धन्यवाद

==
परियोजना को विकसित करने और लेख लिखने में मदद के लिए सर्गेई बिजिन को धन्यवाद।

UPD: ब्लॉग