एनोटेटेडएसक्यूएल: स्कीमा + सामग्री प्रदाता

अंत में एनोटेटेडएसक्यूएल लाइब्रेरी में होने वाले परिवर्तनों का वर्णन करने के लिए चारों ओर से मिला

घोषणा:
1. प्लगइन में परिवर्तन
2. स्कीमा एनोटेशन में परिवर्तन
3. मेरी समझ में सामग्री प्रदाता क्या है
4. हम योजना के अनुसार सामग्री प्रदाता उत्पन्न करते हैं

1. प्लगिन

प्लगइन अद्यतन साइट

अब यह अपडेट साइट के साथ ग्रहण के लिए एक पूर्ण प्लग-इन है

पथ बनाएं-> लाइब्रेरी-> लाइब्रेरी जोड़ें

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

चित्र, टेबल, दृश्य बनाने के लिए टेम्प्लेट

कोड टेम्प्लेट के रूप में ग्रहण की इतनी अच्छी बात है। एक आरेख, तालिका, दृश्य बनाने के लिए प्लगइन अपने स्वयं के टेम्पलेट जोड़ता है। और इन टेम्प्लेटों को कोड पूरा हो जाता है, जो कि ctrl + space द्वारा दिखाया जाता है

उदाहरण के लिए, Tabl लिखें , क़ीमती बटन दबाएं और तालिका देखें - AnnotatedSQL , का चयन करें और आपके पास तालिका के लिए एक टेम्पलेट है।
मत भूलना: टेम्पलेट को संपादित करने वाले अगले फ़ील्ड पर जाने के लिए, टैब कुंजी दबाएं, और Enter टेम्पलेट को संपादित करना समाप्त कर देगा।

2. योजना में अद्यतन

शायद केवल एक एनोटेशन बदल गया है

शामिल हों

नामित विशेषताएँ:
srcTable -> joinTable
srcColumn -> joinColumn
destTable -> onTableAlias
destColumn -> ऑनकोल्यूम
मुझे उम्मीद है कि यह स्पष्ट हो जाएगा। और याद रखने वाली मुख्य बात यह है कि onTableAlias एक तालिका का नाम नहीं है, लेकिन इस पर एक उपनाम है।

और कई एक बार में जोड़े गए थे:

RawJoin

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

IgnoreColumns

जब हमें तालिका से एक कॉलम का चयन करने की आवश्यकता नहीं होती है, तो हम इसे एक एनोटेशन के साथ चिह्नित करते हैं। , जॉइन , रॉजइन से लागू

RawQuery

कहीं भी मापदंडों के साथ अनुरोध करें। इस चीज़ का आविष्कार सामग्री प्रदाता के लिए किया गया था और यह sql में सीमित दृश्य के कारण है। दृश्य चयन + शामिल है, और फिर जहां लागू किया गया है।
लेकिन अक्सर एक अनुरोध को निष्पादित करना आवश्यक होता है जहां शामिल होने की स्थिति में पैरामीटर पहले से ही उपयोग किया जाना चाहिए। लेकिन इसके लिए, इसका आविष्कार किया गया था, ala sql function। जहां स्वाभाविक रूप से हम सेट मापदंडों का उपयोग करना आवश्यक है ?
प्राप्त sql अनुरोध कहीं भी नहीं मिलता है, यह केवल स्थिर रहता है और इसे URI द्वारा खींचा जा सकता है (मैं आपको बाद में बताऊंगा)

RawQuery को SimpleView जैसे Join, Join और RawJoin का उपयोग करके कॉन्फ़िगर किया जा सकता है ,
या आप SqlQuery एनोटेशन के माध्यम से कच्चे sql का उपयोग कर सकते हैं

@RawQuery(ChatListQuery.QUERY_NAME) public static interface ChatListQuery{ String QUERY_NAME = "chatListQuery"; @SqlQuery String CHAT_LIST_QUERY = " some sql here" } 

3. मेरी समझ में सामग्री प्रदाता क्या है

Android के लिए विकसित होने के अनुभव के आधार पर, सामग्री प्रदाता के पास अतिरिक्त गुण होने चाहिए। और अतिरिक्त मापदंडों को उरी के माध्यम से धकेल दिया जा सकता है, बहुत सारे "खाली स्थान" हैं - टुकड़ा, परिमों सब कुछ यूआरएल में जैसा है। तो यहाँ वही है जो आपको आमतौर पर चाहिए:

कोई-सूचना
जब आप एक प्रदाता में डेटा का एक पैकेट डालते हैं, तो प्रत्येक पंक्ति को डालने के बाद यूआई को सूचित करने की कोई आवश्यकता नहीं है, लेकिन डालने के बाद इसे सूचित करना बेहतर है।

वैकल्पिक सूचना uri
अक्सर एक आवश्यकता होती है जब एक यूटीआई को ज़ोटोटिफ़िट पर निर्भर यूरिया को सूचित करना। उदाहरण के लिए, आपके पास एक उपयोगकर्ता दृश्य है जिसका उपयोग आप सूची को भरने के लिए करते हैं, और इन्सर्ट उपयोगकर्ता तालिका में जाता है और आपको यूआई को देखने से सूचित करने की आवश्यकता है, यह वैकल्पिक यूआरआई है।

सीमा
अनुरोध पर तुच्छ सीमा

4. योजना के अनुसार सामग्री प्रदाता का सृजन

मैंने एनोटेशन के लिए ऑटो-जनरेटेड स्कीम लिखने के बाद, मैंने सोचा: मेरे पास दुनिया पर कब्जा करने, कंटेंट प्रोवाइडर बनाने और अपना जीवन आसान बनाने के लिए सब कुछ है। जल्दी से नहीं कहा। एनोटेशन की एक जोड़ी और आपके पास पूर्ण-प्रदाता प्रदाता है + कुछ उपहार। खैर, यह शुरू हुआ!

सबसे पहले, मुझे यह कहना होगा कि योजना के अनुसार, हम एक सामग्री प्रदाता उत्पन्न करते हैं। प्रदाता एनोटेशन हमें इसमें मदद करेगा।

प्रदाता

नाम - सामग्री प्रदाता के लिए वर्ग का नाम
प्राधिकार - हमें प्रदाता के अधिकार को जानना होगा।
स्कीमाक्लास स्कीमा वर्ग का नाम है। खुला सहायक उत्पन्न होने पर उपयोग किया जाता है।
openHelperClass - आप एक आंतरिक ओपन हेल्पर उत्पन्न करने से इनकार कर सकते हैं और आपका उपयोग करने के लिए मजबूर कर सकते हैं।

 @Schema(className="FManagerSchema", dbName="fmanager.db", dbVersion=6) @Provider(authority="com.gdubina.fmanager.store.FManagerProvider", schemaClass="FManagerSchema", name="FManagerProvider", openHelperClass="CustomOpenHelper") public interface FManagerStore { 

इसलिए, हमने कहा कि हम एक कंटेंट प्रोवाइडर चाहते हैं। आगे क्या है?
मुझे कहना होगा कि हमारी इकाई यूआरआई क्या उपलब्ध होगी - हम उसी नाम के यूआरआई एनोटेशन का उपयोग करते हैं

यूआरआई

हम तालिका, दृश्य या क्वेरी में एक निरंतर पर लटकाते हैं। मुझे URI_CONTENT जैसा कुछ पसंद है।
सभी विशेषताएँ यहां वैकल्पिक हैं, लेकिन वे हैं।
प्रकार - uri प्रकार। जैसा कि हम सामग्री प्रदाता में जानते हैं, यह निर्धारित करने के लिए प्रथागत है कि कई रिकॉर्ड (डीआईआर) या एक (आइटम) यूआरआई द्वारा वापस किए जाते हैं। इस getType विधि को याद रखें? यहाँ भी वही बात है।
onlyQuery - केवल क्वेरी निष्पादन के लिए उपयोग, दृश्य और क्वेरी के लिए उपयोग करने योग्य। यदि आप इन्सर्ट / डिलीट / अपडेट को निष्पादित करने का प्रयास करते हैं, तो यह एक अपवाद फेंक देगा
कॉलम - डिफ़ॉल्ट "_id" है। दरअसल, जब आप parh / # प्रकार के URI का उपयोग करते हैं, तो सामग्री प्रदाता ala _id = uri.getLastPathSegment () का चयन करता है। तो यहाँ आप ओवरराइड कर सकते हैं कि किस फील्ड का चयन करना है
altNotify - uri की एक सूची जिसे प्रमाणित करने की आवश्यकता है

कुछ उदाहरण:
इस तरह से हमें चैंपियनशिप टेबल के साथ काम करने के लिए कंटेंट प्रोवाइडर मिला। सब कुछ उपलब्ध है - प्राप्त करें, डालें, हटाएं, अपडेट करें

 @Table(ChempTable.TABLE_NAME) public static interface ChempTable{ @URI String CONTENT_PATH = "chemps"; String TABLE_NAME = "chemp_table"; @PrimaryKey @Column(type = Type.INTEGER) String ID = "_id"; @Column(type = Type.TEXT) String TITLE = "title"; @Column(type = Type.TEXT) String CHEMP_KEY = "CHEMP_KEY"; } 

और यहां संदेश तालिका का एक टुकड़ा है। जैसा कि हम देख सकते हैं, यहां मेरे पास दो यूआरआई हैं
1. तालिका का उपयोग करने के लिए URI_CONTENT स्वयं
2. किसी विशिष्ट उपयोगकर्ता के संदेशों का चयन करने के लिए URI_MESSAGES_BY_USER, बस यहाँ कॉलम = Message.FROM_ID

 @Table(Message.TABLE_NAME) @PrimaryKey(columns = {Message.USER_ID, Message.ID}) public static interface Message{ @URI(altNotify={MessageChatView.URI_CONTENT, ChatListQuery.URI_CONTENT, URI_RECALC_MESSAGE_PATH}) String URI_CONTENT = "message"; @URI(type=URI.Type.ITEM, altNotify={Message.URI_CONTENT, MessageChatView.URI_CONTENT, ChatListQuery.URI_CONTENT, URI_RECALC_MESSAGE_PATH}, column=Message.FROM_ID) String URI_MESSAGES_BY_USER = "message_by_user"; } 

यह एक साधारण कनेक्शन प्रदाता बनाने के लिए पर्याप्त है। सिर्फ दो एनोटेशन!

लेकिन यह सब नहीं है, अगर तालिका के साथ कार्यों पर कुछ करने की आवश्यकता है तो क्या करें? उदाहरण के लिए, उन्होंने एक उपयोगकर्ता जोड़ा - वे गए और एक अवतार अपलोड किया। बड़े वर्ग में ट्रिगर जैसी कोई चीज होती है - वे कुछ ऐसा ही करते हैं। इसलिए मैंने अपने एनोटेशन को ही ट्रिगर कहा। प्रदाता में एक संरक्षित विधि बनाई जाएगी, जिसे आपको ऑटोगेनेरेटेड क्लास के वारिस में ओवरराइड करना होगा

उत्प्रेरक

यूरी पर लटका दिया जाता है, लेकिन तालिका नाम से मेल खाने पर विधि कॉल होती है
नाम - ट्रिगर का नाम, विधि नाम उत्पन्न करने के लिए उपयोग किया जाता है
कब - जब तालिका के साथ या बाद में कार्रवाई से पहले विधि को कॉल करना है।
टाइप करें - कौन सी क्रियाओं का जवाब देना है - सम्मिलित करें / हटाएं / udapte या एक ही बार में

विधि नाम इस तरह के एक पैटर्न द्वारा उत्पन्न होता है

  on<Name><When>Inserted(ContentValues values){} on<Name><When>Deleted(Uri uri, String selection, String[] selectionArgs){} on<Name><When>Updated(Uri uri, ContentValues values, String selection, String[] selectionArg){} 

यदि आपको कई ट्रिगर्स लटकाए जाने की आवश्यकता है, तो ट्रिगर एनोटेशन का उपयोग करें और इसे ट्रिगर्स से भरें।

एक उदाहरण:

 @Table(User.TABLE_NAME) public static interface User{ @Trigger(type=Trigger.Type.INSERT, name="user", when=When.BEFORE) @URI(altNotify={SuggestionView.URI_CONTENT, MessageChatView.URI_CONTENT, ChatListQuery.URI_CONTENT}) String URI_CONTENT = "user"; 

और यह वही है जो प्रदाता इस मामले में दिखता है

 public class AppProvider extends AppAutoProvider { @Override protected void onUserBeforeInserted(ContentValues values) { ................. } 

सूचना का सही उपयोग कैसे करें?

यदि आप uri और सभी विकल्पों का उच्चारण करना चाहते हैं, तो आपको स्थिर विधि notifyUri(ContentResolver cr, Uri uri) का उपयोग करने की आवश्यकता है

प्रदाता से स्टैटिकली विधि पैक करें

getContentUri(String path) - पथ से हमें URI मिलता है
getContentUriGroupBy(String path, String groupBy) - पथ से हमें समूह समर्थन के लिए URI मिलता है
getContentUri(String path, long id) - URI पथ / # प्राप्त करें
getContentUri(String path, String id) - URI पथ प्राप्त करें #

getContentWithLimitUri(String path, int limit) - पथ + सीमा

getNoNotifyContentUri(String path) - पथ से हमें बिना सूचना के URI मिलता है
getNoNotifyContentUri(String path, long id) - बिना सूचना के URI पथ / # प्राप्त करें

पीएस लाइब्रेरी ने "लड़ाकू" परीक्षणों को पारित कर दिया है और पहले से ही उत्पादन परियोजनाओं में उपयोग किया गया है
व्याकरण और वर्तनी के लिए PSS कृपया किक न करें