Android में एपीआई बेसिक्स

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

परिचय

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

डेटा संरचना

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

संपर्क तालिका कुल संपर्कों को संग्रहीत करती है, इस तालिका में प्रत्येक रिकॉर्ड उपयोगकर्ता संपर्क (एकल इकाई) का प्रतिनिधित्व करता है - raw_contacts तालिका से एक या अधिक कच्चे (कच्चे) संपर्कों का एक संघ। जैसा कि आप आरेख में देख सकते हैं, इन तालिकाओं के बीच संबंध एक से कई (1-एन) है। Raw_contacts तालिका में एक प्रविष्टि एक तथाकथित कच्चा संपर्क है। एंड्रॉइड भाषा में एक कच्चा संपर्क, एक विशिष्ट संपर्क के लिए एक विशिष्ट डेटा सेट का मतलब है। लेकिन मुख्य डेटा स्वयं इस तालिका में संग्रहीत नहीं है, इसे डेटा तालिका में संग्रहीत किया जाता है, और रॉ_ कॉन्टैक्ट्स और डेटा के बीच का संबंध भी एक से कई होता है। डेटा टेबल डेटा को सीधे स्टोर करता है। इसके अलावा, इस तालिका की प्रत्येक पंक्ति संपर्क के लिए एक निश्चित प्रकार के डेटा का एक सेट है। पंक्ति में किस प्रकार का डेटा संग्रहीत किया जाता है यह mimetype_id कॉलम द्वारा निर्धारित किया जाता है, जिसमें mimetype तालिका में परिभाषित डेटा प्रकारों की आईडी होती है (उदाहरण के लिए, vnd.android.cursor.item / name, vnd.android.cursor.item / photo)। अब हम सब कुछ और अधिक विस्तार से और उदाहरणों के साथ समझेंगे।

हम संपर्कों के साथ काम करते हैं

ठीक है, मान लें कि हम एक संपर्क जोड़ना चाहते हैं (रॉबर्ट स्मिथ, मोबाइल। 11-22-33), हम यह कैसे करते हैं? जाहिर है, हम स्वयं संपर्क तालिका में कोई संपर्क नहीं जोड़ सकते, क्योंकि सिस्टम स्वयं इसी तालिका को समान रॉ_ कॉन्टैक्ट्स को जोड़कर बनाता है। सिस्टम मुख्य रूप से नाम (समान नाम, उपनाम इत्यादि) द्वारा संपर्कों की पहचान निर्धारित करता है, लेकिन अन्य मानदंडों द्वारा भी, वास्तव में उन्हें कैसे और कैसे प्रबंधित किया जाए, दस्तावेज देखें। यही है, अगर हम अपने रॉबर्ट (रॉबर्ट स्मिथ) के रॉ_ कॉन्टैक्ट को जोड़ते हैं और इसे vnd.cursor.android.item / फोन प्रकार के डेटा के साथ जोड़ते हैं, और फिर हमें "समान" मिलता है, सिस्टम के लिए, रॉबर्ट स्मिथ vnd.cursor प्रकार के डेटा से जुड़ा हुआ है। .android.item / ईमेल और vnd.cursor.android.item / फोटो जैसे डेटा के साथ एक और है, तो हम एक फोटो, मोबाइल और ईमेल के साथ संपर्क में एक रॉबर्ट स्मिथ होगा।

अब इसे कोड में शिफ्ट करने का प्रयास करते हैं। तालिकाओं और उनके क्षेत्रों के लिए, जैसा कि मैंने कहा, कॉन्टैक्टकॉन्ट्रैक्ट क्लास और इसके आंतरिक वर्ग और इंटरफेस जिम्मेदार हैं। उदाहरण के लिए, raw_contacts तालिका का इंटरफ़ेस ContactsContract.RawContacts वर्ग है, और डेटा तालिका के पीछे, ContactsContract.Data वर्ग है। अपने स्थिरांक का अध्ययन करते समय सावधान रहें - स्तंभों के लिए इंटरफेस - केवल लेबल को पढ़ने / लिखने और पढ़ने पर ध्यान दें।

ऊपर से यह निम्नानुसार है कि शुरुआत के लिए, हमें एक कच्चा संपर्क जोड़ना होगा, और फिर इसे डेटा से बांधना होगा। आप इस तरह एक खाली संपर्क जोड़ सकते हैं:

import android.provider.ContactsContract; Uri rawContactUri = getContentResolver().insert(ContactsContract.RawContacts.CONTENT_URI, new ContentValues()); 

संपर्कों में आपको एक खाली (अज्ञात) संपर्क देखना चाहिए, किसी चीज से जुड़ा नहीं। उसे एक नाम जोड़ें। ऐसा करने के लिए, हमें अपने नए संपर्क को उसकी आईडी का उपयोग करके नए डेटा के साथ जोड़ना होगा, जिसे पिछले अनुरोध से प्राप्त किया जा सकता है। डेटा टेबल के क्षेत्रों के लिए मुख्य इंटरफेस कंटेनर क्लास कॉन्टैक्टकॉन्ट्रैक्ट.कोमोनडॉटकाइंड और इसके आंतरिक वर्गों और इंटरफेस में निहित हैं। उदाहरण के लिए, अब हमें जरूरत है
संपर्कContract.CommonDataKinds.StrucruredName वर्ग जिसमें स्थिरांक होते हैं हमें नाम जोड़ने की आवश्यकता होती है, साथ ही उस प्रकार का MIME स्थिरांक जिसे हम अपने क्षेत्र को डेटा तालिका में चिह्नित करते हैं।

 /*  id   */ long rawContactId = ContentUris.parseId(rawContactUri); ContentValues values = new ContentValues(); /*      */ values.put(Data.RAW_CONTACT_ID, rawContactId); /*  MIMETYPE    */ values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE); /*     */ values.put(StructuredName.DISPLAY_NAME, "Robert Smith"); getContentResolver().insert(Data.CONTENT_URI, values); 

यदि हम इस तरह से संपर्क जोड़ते हैं, तो रॉबर्ट स्मिथ संपर्क सूची में दिखाई देगा। अब हम आगे बढ़ते हैं, हमारे संपर्क में एक टेलीफोन भी जोड़ते हैं। ऐसा करने के लिए, हमें ContactsContract.CommonDataKinds.Phone वर्ग की आवश्यकता है, जो फ़ोन नंबर डेटा के लिए इंटरफ़ेस है।

 values.clear(); values.put(Data.RAW_CONTACT_ID, rawContactId); /*   –   */ values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE); /*   */ values.put(Phone.NUMBER, "11-22-33"); /*  –  */ values.put(Phone.TYPE, Phone.TYPE_MOBILE); getContentResolver().insert(Data.CONTENT_URI, values); 

अब संपर्कों में हमारे पास रॉबर्ट स्मिथ हैं जिन्हें आप कॉल कर सकते हैं। लेकिन कई प्रश्नों में इस तरह से एक संपर्क और डेटा जोड़ना महंगा और महंगा है। इसलिए, एक वर्ग ContentProviderOperation है , जो आपको एक क्वेरी बनाने की अनुमति देता है जो एक लेनदेन में हमारे सभी कार्यों का प्रदर्शन करेगा। वे इसका उपयोग करने की सलाह देते हैं। यह है कि हम ContentProviderOperation का उपयोग करके अपने रॉबर्ट को कैसे जोड़ सकते हैं।

 ArrayList<ContentProviderOperation> op = new ArrayList<ContentProviderOperation>(); /*    */ op.add(ContentProviderOperation.newInsert(RawContacts.CONTENT_URI) .withValue(RawContacts.ACCOUNT_TYPE, null) .withValue(RawContacts.ACCOUNT_NAME, null) .build()); /*    */ op.add(ContentProviderOperation.newInsert(Data.CONTENT_URI) .withValueBackReference(Data.RAW_CONTACT_ID, 0) .withValue(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE) .withValue(StructuredName.DISPLAY_NAME, "Robert Smith") .build()); /*    */ op.add(ContentProviderOperation.newInsert(Data.CONTENT_URI) .withValueBackReference(Data.RAW_CONTACT_ID, 0) .withValue(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE) .withValue(Phone.NUMBER, "11-22-33") .withValue(Phone.TYPE, Phone.TYPE_MOBILE) .build()); try { getContentResolver().applyBatch(ContactsContract.AUTHORITY, op); } catch (Exception e) { Log.e("Exception: ", e.getMessage()); } 

यह है कि आप Android में संपर्क कैसे जोड़ सकते हैं। ContentProviderOperation के उपयोग से सावधान रहें, एक अनुरोध के रूप में जो बहुत बड़ा है उसे पूरा होने में लंबा समय लग सकता है। सामान्य तौर पर, सभी ऑपरेशनों को एक अलग स्ट्रीम में सबसे अच्छा प्रदर्शन किया जाता है, क्योंकि उपयोगकर्ता, उदाहरण के लिए, एक कमजोर फोन और कई संपर्क हो सकते हैं।

अन्यथा, अन्य सभी संचालन सामान्य तरीके से किए जाते हैं, उन प्रदाताओं का उपयोग करना जो आपको चाहिए, कुछ आरक्षण के साथ। उदाहरण के लिए, कॉन्टैक्ट टेबल से किसी कॉन्टैक्ट को डिलीट करने से इससे जुड़े सभी रॉ_कनेक्ट्स डिलीट हो जाएंगे, आदि।

तो आप संपर्क में हमारे रॉबर्ट को खोजने की कोशिश कर सकते हैं:

 Cursor c = getContentResolver().query( Contacts.CONTENT_URI, new String[] {Contacts._ID}, Contacts.DISPLAY_NAME + " = 'Robert Smith'", null, null); if(c.getCount() > 0) { /*  */ } else { /*   */ } 

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