बेस्ट एसक्यूएल बिल्डर - एंड्रॉइड पर jOOQ का उपयोग करें

बेस्ट SQL बिल्डर। Android पर jOOQ का उपयोग करना

परिचय

Android एप्लिकेशन विकसित करते समय, मुख्य भंडारण के रूप में SQLite डेटाबेस का उपयोग करना काफी स्वाभाविक है। आमतौर पर, मोबाइल उपकरणों पर डेटाबेस में बहुत ही सरल योजनाएं होती हैं और 10-15 टेबल होते हैं। लगभग किसी भी SQL बिल्डर, ORM, या यहां तक ​​कि नंगे SQLite API ऐसे मामलों के लिए उपयुक्त है।

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

सब कुछ ठीक हो जाएगा, लेकिन

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

अगला, मान लें कि हमने सभी आवश्यक कक्षाएं बनाई हैं। हम अभी उन्हें एंड्रॉइड प्रोजेक्ट में कॉपी नहीं कर पाएंगे - अतिरिक्त निर्भरता की आवश्यकता होगी, जिनमें से पहली javax एनोटेशन पर है। दो विकल्प, दोनों सामान्य। या तो पुस्तकालय जोड़ें (org.glassfish: javax.annotation), या - अद्भुत टूल का उपयोग करें - खोजें और गुंजाइश में बदलें।

और ऐसा लगता है कि सब कुछ ठीक है, सभी प्रीसेट किए जाते हैं, कक्षाओं को कॉपी किया जाता है और परियोजना में आयात किया जाता है। शायद आप एप्लिकेशन को लॉन्च भी कर सकते हैं, और एक मौका है कि यह काम करेगा। यदि आपको Android API स्तर <24 का समर्थन करना आवश्यक है - तो मूर्ख मत बनो, यह हमारी यात्रा का अंत नहीं है। तथ्य यह है कि ओपन-सोर्स संस्करण में फिलहाल jOOQ कई मायनों में जावा 8 का उपयोग करता है, जो कि आप जानते हैं, एंड्रॉइड पर बहुत ही सशर्त रूप से दोस्त हैं। इस समस्या को भी दो तरीकों से हल किया जा सकता है: या तो jOOQ खरीदें, समर्थन के लिए लिखें और फाड़कर जावा 6 या जावा 7 (वे नेटवर्क पर लेखों को देखते हुए) के लिए पूछें, या यदि आप, मेरी तरह, तो एक कठिन नहीं है पुस्तकालय के सभी नवीनतम नवाचारों के साथ-साथ भुगतान करने की इच्छा, अर्थात् दूसरा तरीका। jOOQ ने जावा 8 में इतनी देर पहले प्रवास शुरू किया था। माइग्रेशन से पहले अंतिम संस्करण 3.6.0 है, जिसका अर्थ है कि हम जनरेटर groovy version = '3.6.0' साथ जनरेटर का उपयोग कर सकते हैं और उपकरणों के पुराने संस्करणों का समर्थन कर सकते हैं।

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

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

कोड जनरेशन

JOOQ प्लगइन सेटअप इस तरह दिखेगा:

 buildScript { repositories { mavenCentral() } dependencies { classpath "nu.studer:gradle-jooq-plugin:$jooq_plugin_version" } } apply plugin: 'nu.studer.jooq' dependencies { jooqRuntime "org.xerial:sqlite-jdbc:$xerial_version" } jooq { version = '3.6.0' edition = 'OSS' dev(sourceSets.main) { jdbc { driver = 'org.sqlite.JDBC' url = 'jdbc:sqlite:/Path/To/Database/database.db3' } generator { name = 'org.jooq.util.DefaultGenerator' strategy { name = 'org.jooq.util.DefaultGeneratorStrategy' } database { name = 'org.jooq.util.sqlite.SQLiteDatabase' } generate { relations = true deprecated = false records = true immutablePojos = true fluentSetters = true } target { packageName = 'com.example.mypackage.data.database' } } } } 

एंड्रॉयड

आवश्यक निर्भरताएँ:

 implementation "org.jooq:jooq:$jooq_version" implementation "org.sqldroid:sqldroid:$sqldroid_version" implementation "org.glassfish:javax.annotation:$javax_annotations_version" 

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

 class DatabaseAdapter(private val context: Context) : SQLiteOpenHelper(context, DATABASE_NAME, null, DATABASE_VERSION) { companion object { private const val DATABASE_NAME = "database" private const val DATABASE_VERSION = 1 @JvmStatic private val OPEN_OPTIONS = mapOf( "cache" to "shared", "journal_mode" to "WAL", "synchronous" to "ON", "foreign_keys" to "ON") } val connectionLock: ReentrantLock = ReentrantLock(true) val configuration: Configuration by lazy(mode = LazyThreadSafetyMode.NONE) { connectionLock.withLock { // ensure the database exists, // all upgrades are performed, // and connection is ready to be set val database = context.openOrCreateDatabase( DATABASE_NAME, Context.MODE_PRIVATE, null) if (database.isOpen) { database.close() } // register SQLDroid driver to be used for establishing connections // with our database DriverManager.registerDriver( Class.forName("org.sqldroid.SQLDroidDriver") .newInstance() as Driver) DefaultConfiguration() .set(SQLiteSource( context, OPEN_OPTIONS, "database", arrayOf("databases"))) .set(SQLDialect.SQLITE) } } override fun onCreate(db: SQLiteDatabase) { // acquire monitor until the database connection is created // this is important as otherwise transactions might be tryingg to run // concurrently that will lead to crashes connectionLock.withLock { // TODO: Create tables } } override fun onOpen(db: SQLiteDatabase) { // acquire monitor until the database connection is established // this is important as otherwise transactions might be tryingg to run // concurrently that will lead to crashes connectionLock.withLock { super.onOpen(db) } } override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) { // acquire monitor until the database is upgraded // this is important as otherwise transactions might be tryingg to run // concurrently that will lead to crashes connectionLock.withLock { } } infix inline fun <reified T> transaction(noinline f: (Configuration) -> T): Observable<T> = Observable.create { emitter -> val tryResult = Try { connectionLock.withLock { DSL.using(configuration).transactionResult(f) } } when (tryResult) { is Try.Success -> { emitter.onNext(tryResult.value) emitter.onComplete() } is Try.Failure -> { emitter.onError(tryResult.exception) } } } fun invalidate() { connectionLock.withLock { // TODO: Drop tables, vacuum and create tables } } private class SQLiteSource(val context: Context, val options: Map<String, String>, val database: String, val fragments: Array<out String>): DroidDataSource() { override fun getConnection(): Connection = openConnection(options) private fun openConnection(options: Map<String, String> = emptyMap()): Connection { return DriverManager.getConnection(StringBuilder().apply { append("jdbc:sqldroid:") append(context.applicationInfo.dataDir) append("/") append(buildFragments(fragments)) append(database) append("?") append(buildOptions(options)) }.toString()) } private fun buildFragments(fragments: Array<out String>) = when (fragments.isEmpty()) { true -> "" false -> "${fragments.joinToString("/")}/" } private fun buildOptions(options: Map<String, String>) = options.mapTo(mutableListOf<String>()) { entry -> "${entry.key}=${entry.value}" } .joinToString(separator = "&") } } 

UPD: जोड़ा गया mode = LazyThreadSafetyMode.NONE आलसी इनिशियलाइज़ेशन के लिए, धन्यवाद konstantin_berkow

एक निष्कर्ष के बजाय

जैसा कि यह निकला, एंड्रॉइड में jOOQ स्थापित करना ऐसी जटिल प्रक्रिया नहीं है। यह एक बार करने के लिए पर्याप्त है, और फिर आप सुरक्षित रूप से पुरानी परियोजनाओं से कॉपी-पेस्ट कर सकते हैं।

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