🛀🏿 🤸🏼 📫 हम अपने ओआरएम को एंड्रॉइड के लिए कैनस्टा और सीनोराइट्स के साथ लिखते हैं 🛵 👨🏿‍🤝‍👨🏾 👩🏿‍🏫

प्रविष्टि

एंड्रॉइड के लिए मेरे आवेदन को लिखने का विचार धूप थाईलैंड में आराम के पांचवें दिन मेरे पास आया था। मैं विवरण में नहीं जाऊंगा कि वास्तव में मुझे इसके लिए क्या संकेत मिला, मैंने आवेदन के लिए कैसे और क्या योजना बनाई (बस लेख उस बारे में नहीं है)। हालाँकि, यह विचार दृढ़ था और मेरे प्रवास के छठे दिन, होटल में मुफ्त इंटरनेट का उपयोग करते हुए, मैंने MySql को एक लैपटॉप पर डाउनलोड किया, सिर्फ फिल्में देखने और कैमरे से तस्वीरें लेने के लिए लिया।
मैंने शुरू किया, आपने इसका अनुमान लगाया, एक संबंधपरक मॉडल के साथ।
काम कठिन हो गया, लेकिन मॉडल के साथ कुछ महीनों के बाद मैं समाप्त हो गया और एंड्रॉइड विकास के जंगल में आ गया। इससे पहले, मोबाइल प्लेटफ़ॉर्म के लिए, मैंने केवल .Net कॉम्पैक्ट फ्रेमवर्क पर लिखा था, लेकिन जब से मैं जावा फर्स्टहैंड से परिचित था, बटन के साथ एक सरल रूप में रखना मुश्किल नहीं था। ऑब्जेक्ट मॉडल, जैसा कि अपेक्षित था, किसी भी तरह की कठिनाइयों का कारण नहीं बना, और मैंने, खुशी से यह अनुमान लगाया कि मेरा परीक्षण डेटा डिवाइस के आंत्रों में कहीं दूर उड़ जाएगा, एंड्रॉइड डेवलपर्स वेबसाइट पर डेटा स्टोरेज अनुभाग खोला। डेटाबेस का उपयोग करने वाले अनुभाग को संपूर्ण नहीं कहा जा सकता है, हालांकि, इसमें सभी एपीआई संदर्भ शामिल हैं, और मैंने अपना SQLiteOpenHelper वारिस लिखना शुरू कर दिया। कुछ सफल परीक्षणों के बाद, एंटिटी फ्रेमवर्क द्वारा खराब कर दिए जाने के बाद, मैंने महसूस किया कि कुछ प्रकार के ऑर्म का उपयोग करना अच्छा होगा, क्योंकि मेरे पास एक दर्जन से अधिक संस्थाएं हैं। ग्रेट एंड टेरिबल " एंड्रॉइड ऑरम " में संचालित होने के बाद, मुझे इस लेख की पहली कड़ी मिली, और स्टैकवर्वरफ्लो पर कुछ उपयोगी। कुल तीन ऑर्म्स टाइप किए हैं, मैंने प्रयोग के बारे में निर्धारित किया है।

प्रयोगों

पहला परीक्षण ऑर्मलाइट का था ।

OrmLite

सिद्धांत रूप में, एक अच्छा कार्यान्वयन, एनोटेशन का उपयोग। मुझे DatabaseHelper में onCreate और onUpgrad का क्रियान्वयन भी पसंद आया और इसे मेरी स्मृति की गहराई में कहीं याद किया गया। लेकिन! प्रत्येक इकाई के लिए एक अतिरिक्त वर्ग बनाने के लिए <% EntityName%> DAO - धन्यवाद! आप अंत में एक बनाने की कोशिश कर सकते हैं जो संस्थाओं के आधार वर्ग से जुड़ा हुआ है, लेकिन इससे केवल अधिक समस्याएं होंगी।

GreenDAO

मैंने प्रलेखन में हेडिंग " डेटा मॉडल और कोड जनरेशन " को आगे नहीं पढ़ा। हो सकता है कि यह दृष्टिकोण मेरे लिए पूरी तरह से स्पष्ट नहीं है और इसके अपने फायदे हैं, लेकिन, विशेषताओं के लिए उपयोग होने के कारण, मैं घोषणाओं का अधिक उपयोग करना पसंद करता हूं।

ActiveAndroid

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

संबंधपरक मॉडल

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

/** *  */ public class Car { /** *  */ private CarType type; /** *   */ private int enginePower; /** * -  */ private int doorsCount; }

और " ट्रक " इकाई को विरासत में मिली

 /** * */ public class Truck extends Car{ /** *  ,   . */ private boolean isTipper; }

सामान्यतया, orm को तालिका बनाने के लिए यह क्वेरी उत्पन्न करनी चाहिए:

 CREATE TABLE car (id INTEGER PRIMARY KEY, type INTEGER REFERENCE car_type(id), engine_power INTEGER, doors_count INTEGER, is_tipper INTEGER);

मैंने एक बार PostgreSQL में तालिकाओं की विरासत से प्रभावित होकर यह मॉडल बनाया था:

 CREATE TABLE car (id INTEGER PRIMARY KEY, type INTEGER REFERENCES car_type(id), engine_power INTEGER, doors_count INTEGER); CREATE TABLE truck (id INTEGER REFERENCES car(id) ON DELETE CASCADE, is_tipper INTEGER);

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

संकल्पना

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

कार्यान्वयन

एनोटेशन

मेरे पास केवल दो सार हैं:

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

तथ्य

फिर से हम एक उदाहरण से उन पर विचार करेंगे:

 public class BaseEntity extends OrmEntity { @Column(primaryKey = true, inherited = true) private Long id; } @Table(name = “car_type”, cashedList = true) public class CarType extends BaseEntity { @Column private String code; } @Table(rightJoinTo = {Truck.class}) public class Car extends BaseEntity { @Column(name = “car_type”) private CarType type; @Column private List<Wheel> wheels; @Column(name = “engine_power”) private int enginePower; @Column(name = “doors_count”) private int doorsCount; } @Table public class Wheel extends BaseEntity { @Column(name = “car_id”) private Car car; @Column private String manufacturer; } @Table(leftJoinTo = Car.class) public class Truck extends Car { @Column(name = “is_tipper”) private boolean isTipper; }

हेल्पर ओरमलाइट के समान हेल्पर के कार्य के परिणामस्वरूप, हमें निम्नलिखित प्रश्न मिलते हैं:

 CREATE TABLE car_type (id INTEGER PRIMARY KEY, code TEXT); CREATE TABLE car (id INTEGER PRIMARY KEY, car_type REFERENCES car_type (id), engine_power INTEGER, doors_count INTEGER); CREATE TABLE wheel (id INTEGER PRIMARY KEY, car_id INTEGER REFERENCES car (id), manufacturer TEXT); CREATE TABLE truck (car_id REFERENCES car (id), is_tipper INTEGER);

ओरम पर अधिक

OrmEntity वर्ग में एक संरक्षित स्थैतिक विधि है:

 protected static <T extends OrmEntity> List<T> getAllEntities (Class<T> entityClass)

उदाहरण के लिए, CarType क्लास में, हम निम्नलिखित विधि को लागू करते हैं:

 public static List<CarType> getAllEntities() { return getAllEntities(CarTpe.class); }

OrmEntity में भी संरक्षित परिवर्तन और हटाने के तरीके हैं। BaseEntity बेस क्लास में , मैं बदलाव छिपाता हूं, और इसे डालने और अपडेट के माध्यम से, अच्छी तरह से, विशुद्ध रूप से सुंदरता के लिए।

जाँच और सीमाएँ

एक इकाई के पास प्राइमरीके लेबल वाला फ़ील्ड होना चाहिए। यह टाइप लॉन्ग का होना चाहिए (अर्थात L ong , ताकि शुरू में id null हो और ओम ओम बदलाव को समझ सके कि यह क्या है, डालें या अपडेट करें )।
यदि कॉलम लेबल वाला फ़ील्ड OrmEntity से विरासत में मिली संस्थाओं के एक वर्ग के साथ टाइप सूची का है, तो इस वर्ग में कॉलम के रूप में लेबल वाली प्रथम श्रेणी का फ़ील्ड होना चाहिए।
यदि स्तंभ लेबल वाला फ़ील्ड OrmEntity से विरासत में मिला हुआ प्रकार का है, तो इस प्रकार के पास प्राथमिक फ़ील्ड के साथ कॉलम लेबल वाला फ़ील्ड होना चाहिए।
यदि क्लास को लेफ्ट जॉइन्टो के साथ टेबल के साथ चिह्नित किया जाता है , तो लेफ्टजॉइन्टो में निर्दिष्ट क्लास को राइटजॉइन्टो में टेबल के साथ चिह्नित किया जाना चाहिए, जिसमें प्रथम श्रेणी जोड़ी जाती है।
सभी विफल चेक एक अपवाद फेंकते हैं।

निष्कर्ष

फिलहाल, ऑरम अभी खत्म नहीं हुआ है, और मैं इसे विकसित कर रहा हूं जैसे मुझे जरूरत है। अब int , Long , double , String , Drawable के प्रकार समर्थित हैं। रास्ते में दस्तावेज़ ।
संदर्भों पर कार्रवाई से, जबकि केवल DELETE है , इसका उपयोग CASCADE और SET NULL, और बाकी बनाने के लिए किया जा सकता है।
LeftJoinTo - जबकि यह पूरी तरह से काम नहीं कर रहा है, अब मैं इसे पूरा कर रहा हूं।
जैसे ही मैंने अपना सबकुछ खत्म कर लिया और मैंने कल्पना की और कोड को कंघी कर लिया, मैं GitHub पर लाइब्रेरी पोस्ट कर दूंगा।

हम अपने ओआरएम को एंड्रॉइड के लिए कैनस्टा और सीनोराइट्स के साथ लिखते हैं