ताइज़ेन: पहले चरण (भाग 3)

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

भाग दो

भाग तीन

Tizen SDK कई अंतर्निहित डेटा टूल प्रदान करता है। सरल कार्यों के लिए, जो हमारा है, आप फ़ाइल में साधारण रीड / राइट का उपयोग कर सकते हैं। दस्तावेजों में वर्णित उदाहरणों के साथ, विस्तार से फाइलों के साथ काम करें । लचीलेपन और बड़ी मात्रा में डेटा की आवश्यकता वाले मामलों में, एम्बेडेड SQLite डेटाबेस तक पहुँचने के लिए एक तंत्र है। यह रिकॉर्ड्स की त्वरित खोज और आपकी खरीदारी सूची के सुविधाजनक रीऑर्डरिंग के लिए हमारे लिए उपयोगी है।

डेटाबेस के साथ काम करने के लिए उपकरणों का एक पूरा शस्त्रागार है । Tizen :: Io :: डेटाबेस का उपयोग डेटाबेस के लिए करना है: कनेक्शन, SQL क्वेरी का सीधा निष्पादन, आदि। Tizen :: Io :: DbStatement आपको आसानी से एक क्वेरी बनाने और उसे डेटा संलग्न करने की अनुमति देता है: संख्यात्मक, स्ट्रिंग, बाइनरी - बेशक, SQLite वाक्यविन्यास के संदर्भ में। Tizen :: Io :: DbEnumerator क्वेरी परिणाम से डेटा प्राप्त करने के लिए जिम्मेदार है। यह डेटाबेस के साथ काम करने के लिए न्यूनतम सेट है। ज्यादातर मामलों में, मैं इस विशेष सेट का उपयोग करता हूं, हालांकि, एक अतिरिक्त स्व-लिखित शेल के तहत जो कुछ नियमित संचालन को स्वचालित करता है। Tizen SDK में अतिरिक्त उपकरण भी हैं जो काम की सुविधा प्रदान करते हैं, उदाहरण के लिए: SqlStatementBuilder - आसानी से सरल प्रश्न, डेटा नियंत्रण - अनुप्रयोगों के बीच डेटा विनिमय उत्पन्न करता है , Tizen :: Io :: DataSet , Tizen :: Io - DataRow - मेमोरी में टेबल के साथ काम करने के लिए , आदि।

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

नए डेटाबेस की फ़ाइल डेटा निर्देशिका में संग्रहीत की जाती है, जो कि टिज़ेन प्रोजेक्ट की मूल निर्देशिका है (लेख का पहला भाग देखें)। हमें 2 टेबल चाहिए: एक में हम खरीदारी को स्टोर करेंगे, और दूसरे में - खरीदारी की सूची:





जैसा कि मैंने पहले ही उल्लेख किया है, डेटाबेस के साथ काम करने के लिए अधिकांश परियोजनाओं में मैं 3 मुख्य वर्गों में अपने स्वयं के शेल का उपयोग करता हूं: Tizen :: Io :: डेटाबेस, Tizen :: Io :: DbStatement और Tizen :: Io :: DbEnumerator। डेटाबेस के साथ काम करने के संदर्भ में दस्तावेज़ीकरण में डेटासेट और डेटारॉ वर्गों का उल्लेख नहीं किया गया है, सिवाय इसके कि उनके पास एक रूट नेमस्पेस Tizen :: Io है। यह आश्चर्य की बात नहीं है कि मेरे द्वारा अपने स्वयं के कार्यान्वयन लिखे जाने के बाद वे मेरे द्वारा खोजे गए थे (एक बहाना है!)। जैसा कि यह हो सकता है, वे काम करते हैं, और आप उन्हें v0.3 टैग के तहत कमिट में देख सकते हैं। मैं इस बात पर जोर देना चाहता हूं कि मैंने खुद के लिए शेल लिखा है, और किसी भी तरह से कोड और वास्तुकला की विशेष लालित्य का नाटक नहीं करता है। इसके मुख्य मॉड्यूल को संक्षेप में सूचीबद्ध करें:

• DbRow - एक इंटरफ़ेस जिसका वंशज तालिका पंक्तियों को संक्षिप्त करता है;
• DbDataSet - DbRow सेट के लिए भंडारण;
• DbAccess - डेटाबेस को जोड़ने / डिस्कनेक्ट करने, एकल मान (GetValue विधि) पढ़ने, संपूर्ण तालिकाओं को पढ़ने / लिखने (FillDataSet, UploadDataSet) और मापदंडों के साथ कमांड अनुरोधों को निष्पादित करने के लिए जिम्मेदार (PerformRequest);
• DbQuery - एक वस्तु में एक स्ट्रिंग क्वेरी और इसके मापदंडों को जोड़ती है;
• DbRowBuilder - DbRow कार्यान्वयन बनाने के लिए इंटरफ़ेस, DbDataSet द्वारा उपयोग किया जाता है;
• DbValue - क्षेत्र का सार्वभौमिक मूल्य, जिसका प्रकार निर्माण पर निर्धारित होता है;
• DbRowValue DbRow का एक मानक कार्यान्वयन है; इसका उपयोग तब किया जाता है जब केवल 1 कॉलम को पढ़ने की आवश्यकता होती है।

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

ShoppingListMainForm फॉर्म एक बार आवेदन शुरू होने पर लोड हो जाता है, और जब यह बाहर निकलता है तो बंद हो जाता है, इसलिए डेटाबेस को जोड़ना / डिस्कनेक्ट करना उचित ईवेंट हैंडलर्स में सुविधाजनक है:

result ShoppingListMainForm::OnInitializing(void) { result r = E_SUCCESS; //    … pDb = new DbAccess(); r = pDb->Construct(); if (IsFailed(r)) { AppLogDebug("ERROR: cannot construct DbAccess! [%s]", GetErrorMessage(r)); return r; } String strDbName = "lists1.sqlite"; r = pDb->Connect(strDbName); if (IsFailed(r)) { AppLogDebug("ERROR: cannot connect %S! [%s]", strDbName.GetPointer(), GetErrorMessage(r)); return r; } return r; } 

 result ShoppingListMainForm::OnTerminating(void) { result r = E_SUCCESS; r = pDb->Close(); if (IsFailed(r)) { AppLogDebug("ERROR: cannot close DbAccess! [%s]", GetErrorMessage(r)); return r; } delete pDb; pDb = null; return r; } 

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



ज्यादातर मामलों में, वे बेकार हैं, इसलिए मैं उन्हें बंद कर देता हूं और केवल अपने स्वयं के "डीबग" संदेश छोड़ देता हूं:



हम देखते हैं कि मैंने एक गलती की - गलत फ़ाइल नाम का संकेत दिया। हम list1.sqlite को lists.sllite से बदल देते हैं, और डेटाबेस से कनेक्शन तैयार हो जाता है!

अब खरीदारी सूचियों के नाम पुनः प्राप्त करें। हालांकि निकालने के लिए कुछ भी नहीं है, डेटाबेस खाली है, इसलिए SQLite प्रबंधक में हम सूची तालिका का चयन करते हैं, "ब्राउज़ करें और खोजें" टैब पर जाएं और कुछ परीक्षण मान जोड़ें:



हमारे द्वारा आवश्यक मानों को लोड करने के लिए:

1. DDDataSet टेबल;
2. नई सूची वर्ग सूची तालिका की पंक्तियों को संग्रहीत करने के लिए संरचना है;
3. DbRow से विरासत में मिला नया रोलिस्ट वर्ग - DbDataSet के लिए पंक्ति पहुँच प्रदान करता है;
4. एक वर्ग जो DbRowBuilderInterface को विरासत में देता है - यह DbDataSet स्ट्रिंग के लिए रोलिस्ट ऑब्जेक्ट उत्पन्न करेगा;
5. DbQuery - DbAccess डेटाबेस के लिए SQL क्वेरी को एन्क्रिप्ट करता है।

प्रपत्र ही DbRowBuilderInterface का वारिस होगा। एक नई पंक्ति के रूप में हम रोलिस्ट की वापसी करेंगे। यदि हमें केवल एक कॉलम की आवश्यकता है, तो हम तैयार किए गए DbRowValue वर्ग का उपयोग कर सकते हैं। तालिका बनाते समय, इसके पहचानकर्ता को याद रखना न भूलें theDataSetIdGetLists - आपको यह निर्धारित करने के लिए कि कौन सी पंक्तियाँ किस तालिका से पास करनी हैं:

 void ShoppingListMainForm::GetLists() { DbDataSet theTable; theDataSetIdGetLists = theTable.GetId(); theTable.SetRowBulder(this); String strQueryString = "SELECT * FROM Lists"; DbQuery query; query.queryString = strQueryString; pDb->FillDataSet(query, theTable); int count = theTable.GetRowCount(); int valueInt; String* pvalueText; for (int i=0; i<count; i++) { DbRow* pRow = theTable.GetRow(i); if (pRow) { pRow->GetInt(0, valueInt); pRow->GetText(1, pvalueText); AppLogDebug("%i %S", valueInt, pvalueText->GetPointer()); } else { AppLogDebug("ERROR: pRow is null!"); } } return; } 

 DbRow* ShoppingListMainForm::BuildNewRowN(unsigned int tableId, unsigned int rowIndex, void* content) const { DbRow* pRow = null; if (tableId == theDataSetIdGetLists) { pRow = new RowList(new Content::List()); } return pRow; } 

हम OnInitializing प्रपत्र आरंभीकरण हैंडलर में GetLists विधि कॉल को जोड़ते हैं, प्रोजेक्ट चलाते हैं और लॉग में आईडी और सूची नामों का निरीक्षण करते हैं:

> 1 उपहार
> 2 उत्पाद
> 3 एक बिल्ली के लिए गोला बारूद चलना

इस स्तर पर प्रोजेक्ट कैसा दिखता है - लेबल v0.4 देखें।

अब Tab1 टैब पर ListView में सूचियों के नाम प्रदर्शित करें। ऐसा करने के लिए, ShoppingListTab1 के पास डेटाबेस से डाउनलोड किए गए डेटा तक पहुंच होनी चाहिए। अगर हमारे पास पूर्ण रूप से विकसित एमवीसी है, तो हम सिर्फ मॉडल की ओर रुख करेंगे और हमें अपनी जरूरत का हर सामान ले जाएंगे, अन्यथा हमें एक बैसाखी को गढ़ना होगा:

1. हम सूचक को DbAccess स्थिर बनाते हैं और बाहरी पहुंच के लिए खोलते हैं;
2. डेटा निष्कर्षण तंत्र ShoppingListMainForm से ShoppingListTab1 में स्थानांतरित किया जाता है;
3. हम ShoppingListMainForm से डेटाबेस में कनेक्शन को स्थानांतरित करते हैं :: ShoppingListMainForm की शुरुआत में :: :: प्रारंभ करें ताकि डेटाबेस Tab1 के आरंभ होने से पहले जुड़ा हो।
4. हम सूची के साथ DbDataSet ShoppingListTab1 वर्ग का सदस्य बनाते हैं।

यह निकला, इसे हल्के ढंग से रखने के लिए, बहुत सुंदर नहीं - यह वास्तुकला की उपेक्षा का परिणाम है। जारी रखें: हम सूची दृश्य के लिए डेटा स्रोत के रूप में DbDataSet असाइन करते हैं और अंत में, हम स्क्रीन पर सूचियों के नामों का निरीक्षण करते हैं:



इस स्तर पर प्रोजेक्ट कैसा दिखता है - लेबल v0.5 देखें।

लेख के दूसरे भाग में, सूची आइटम के संदर्भ मेनू पर विचार किया गया था, जहां हमने डिलीट बटन को रखा था। इस घटना के लिए हैंडलर का उपयोग करने का समय है:

 void ShoppingListTab1::OnListViewContextItemStateChanged(Tizen::Ui::Controls::ListView& listView, int index, int elementId, Tizen::Ui::Controls::ListContextItemStatus status) { if (status == LIST_CONTEXT_ITEM_STATUS_SELECTED && elementId == ID_CNTX_BTN_DELETE) { //     RowList* pRow = dynamic_cast<RowList*>(theTableLists.GetRow(index)); if (pRow) { DbQuery theQuery; theQuery.queryString = "DELETE FROM Lists WHERE id = ?"; theQuery.AddParamInt(pRow->pList->id.value); ShoppingListMainForm::pDb->PerformRequest(theQuery); } if (pRow) { DbQuery theQuery; theQuery.queryString = "DELETE FROM Purchases WHERE list_id = ?"; theQuery.AddParamInt(pRow->pList->id.value); ShoppingListMainForm::pDb->PerformRequest(theQuery); } //      theTableLists.RemoveRow(index); //   pListview1->UpdateList(); } } 

डेटाबेस में, सूची को स्वयं और उसकी सभी सामग्री (खरीद) को हटा दें। डेटा स्रोत में परिवर्तन के बाद, आपको सूची दृश्य भी अपडेट करना होगा ताकि स्क्रीन पर परिवर्तन दिखाई दें।

संभावित जाल: डेटाबेस फ़ाइल को अधिलेखित करने के लिए जब आप एप्लिकेशन को फिर से लिखते हैं, तो आपको इसे संशोधित करने की आवश्यकता होती है (या लक्ष्य डिवाइस से एप्लिकेशन को हटा दें)। अन्यथा, पुरानी फ़ाइल लक्ष्य डिवाइस पर रहेगी। यह एप्लिकेशन को जल्दी से तैनात करने के लिए किया जाता है ताकि आपको हर बार मेगाबाइट संसाधन फ़ाइलों को भेजने की आवश्यकता न हो।

कोड में परिवर्तन का अध्ययन करने के लिए आगे का काम अधिक उपयुक्त है।

लेबल v0.6 - एड कमांड के साथ संदर्भ मेनू (OptionMenu) बाएं स्पर्श बटन से जुड़ा हुआ है। यह एक संवाद लाता है जो आपको नए तत्व का नाम दर्ज करने के लिए आमंत्रित करता है। पुष्टि के बाद, संवाद बंद हो जाता है, और डेटाबेस और DbDataSet तालिका में एक नया रिकॉर्ड जोड़ा जाता है।

लेबल v0.7 - खरीद के साथ कार्यान्वित कार्य। टैब 1 टैब पर एक सूची का चयन टैब 2 टैब की ओर जाता है, जहां इस सूची के तत्व प्रदर्शित होते हैं। उन्हें संपादित किया जा सकता है: जोड़ना, हटाना, पूरा करना। पूरी खरीद को सूची के अंत में प्रदर्शित किया जाता है।

लेबल v0.8 - खोज कमांड को संदर्भ मेनू में जोड़ा गया है। खोज एक अलग पैनल में की जाती है, यह सूचियों के नाम और खरीदारी के नाम दोनों को खोजती है। खोज परिणाम का चयन करने से उचित टैब पर संक्रमण होता है (और यदि आवश्यक हो, तो वांछित आइटम पर स्क्रॉल करना)।

लेबल v0.9 - हम सुंदरता लाते हैं : हम अनुशंसित रंग पैलेट और फ़ॉन्ट आकारों का उपयोग करके बटन, मेनू, पैनल को रंग देते हैं । ग्रंथों का स्थानीयकरण जोड़ें (रूसी, अंग्रेजी)।



अंत में, v1.0 अंतिम स्पर्श है, अर्थात्, जब आप एप्लिकेशन से बाहर निकलते हैं, तो VACUUM कमांड के साथ डेटाबेस को कंप्रेस करते हैं।

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