बार-बार होने वाले या स्ट्रक्चर्ड डेटा के लिए, डेटा को डेटाबेस में सेव करना सबसे अच्छा रहता है.
जैसे कि संपर्क जानकारी. यह पेज मानता है कि आप
आपको एसक्यूएल डेटाबेस के बारे में जानकारी है. साथ ही, इसकी मदद से
Android पर SQLite डेटाबेस. डेटाबेस इस्तेमाल करने के लिए, आपको जिन एपीआई की ज़रूरत होगी
Android पर, android.database.sqlite
पैकेज में उपलब्ध हैं.
चेतावनी: हालांकि, ये एपीआई ज़्यादा असरदार होते हैं, लेकिन इनका लेवल काफ़ी कम होता है इन्हें इस्तेमाल करने में बहुत समय और मेहनत लगती है:
- रॉ एसक्यूएल क्वेरी के कंपाइल होने में लगने वाले समय की पुष्टि नहीं की जाती. आपके डेटा के तौर पर ग्राफ़ में बदलाव करता है, तो आपको प्रभावित एसक्यूएल क्वेरी को मैन्युअल रूप से अपडेट करना होगा. यह इस प्रक्रिया में ज़्यादा समय लग सकता है और इसमें गड़बड़ी होने की आशंका भी हो सकती है.
- एसक्यूएल क्वेरी को एक-दूसरे से बदलने के लिए, आपको बहुत सारे बॉयलरप्लेट कोड इस्तेमाल करने होंगे की ज़रूरत नहीं होती.
इन वजहों से, हम सुझाव देते हैं कि रूम परसिस्टेंस लाइब्रेरी आपके ऐप्लिकेशन के SQLite में जानकारी ऐक्सेस करने के लिए, एक ऐब्स्ट्रैक्ट लेयर के तौर पर डेटाबेस.
स्कीमा और कॉन्ट्रैक्ट तय करना
SQL डेटाबेस के मुख्य सिद्धांतों में से एक है स्कीमा: औपचारिक डेटाबेस को व्यवस्थित करने के तरीके का एलान. स्कीमा, एसक्यूएल में दिखता है स्टेटमेंट जिन्हें इस्तेमाल करके डेटाबेस बनाया जाता है. यह आपके लिए मददगार हो सकता है एक कंपैनियन क्लास बनाता है, जिसे कॉन्ट्रैक्ट क्लास कहा जाता है, जो साफ़ तौर पर को व्यवस्थित करने और खुद दस्तावेज़ करने के लिए किया जा सकता है.
कॉन्ट्रैक्ट क्लास, कॉन्सटेंट के लिए एक कंटेनर होता है, जो यूआरआई के लिए नाम तय करता है, टेबल, और कॉलम. कॉन्ट्रैक्ट क्लास की मदद से, एक जैसे कॉन्सटेंट का इस्तेमाल किया जा सकता है पैकेज में शामिल सभी अन्य क्लास में शामिल करने का सुझाव देते हैं. इससे आपको कॉलम बदलने की सुविधा मिलती है नाम को एक ही जगह पर रखें और इसे अपने पूरे कोड में लागू करें.
कॉन्ट्रैक्ट क्लास को व्यवस्थित करने का एक अच्छा तरीका यह है कि ऐसी परिभाषाएं रखी जाएं जो वैश्विक स्तर पर आपके पूरे डेटाबेस को क्लास के रूट लेवल पर लागू करता है. फिर, अपने क्लास का इस्तेमाल करें. हर इनर क्लास, उससे जुड़ी टेबल के कॉलम की गिनती करती है.
ध्यान दें: BaseColumns
को लागू करके
इंटरफ़ेस न हो, तो आपकी आंतरिक क्लास एक
कुंजी फ़ील्ड है जिसे _ID
कॉल किया गया है और CursorAdapter
जैसी कुछ Android क्लास में इसके होने की उम्मीद है. ज़रूरी नहीं है, लेकिन इससे डेटाबेस को बेहतर बनाने में मदद मिल सकती है
Android फ़्रेमवर्क के साथ मिलकर काम करने में मदद मिलती है.
उदाहरण के लिए, नीचे दिया गया कॉन्ट्रैक्ट किसी आरएसएस फ़ीड दिखाने वाली सिंगल टेबल:
Kotlin
object FeedReaderContract { // Table contents are grouped together in an anonymous object. object FeedEntry : BaseColumns { const val TABLE_NAME = "entry" const val COLUMN_NAME_TITLE = "title" const val COLUMN_NAME_SUBTITLE = "subtitle" } }
Java
public final class FeedReaderContract { // To prevent someone from accidentally instantiating the contract class, // make the constructor private. private FeedReaderContract() {} /* Inner class that defines the table contents */ public static class FeedEntry implements BaseColumns { public static final String TABLE_NAME = "entry"; public static final String COLUMN_NAME_TITLE = "title"; public static final String COLUMN_NAME_SUBTITLE = "subtitle"; } }
एसक्यूएल हेल्पर का इस्तेमाल करके डेटाबेस बनाना
आपका डेटाबेस कैसा दिखेगा, यह तय करने के बाद आपको कुछ तरीके लागू करने होंगे जो डेटाबेस और टेबल बनाती हैं और उनका रखरखाव करती हैं. यहां कुछ सामान्य उदाहरण दिए गए हैं टेबल बनाने और मिटाने वाले स्टेटमेंट:
Kotlin
private const val SQL_CREATE_ENTRIES = "CREATE TABLE ${FeedEntry.TABLE_NAME} (" + "${BaseColumns._ID} INTEGER PRIMARY KEY," + "${FeedEntry.COLUMN_NAME_TITLE} TEXT," + "${FeedEntry.COLUMN_NAME_SUBTITLE} TEXT)" private const val SQL_DELETE_ENTRIES = "DROP TABLE IF EXISTS ${FeedEntry.TABLE_NAME}"
Java
private static final String SQL_CREATE_ENTRIES = "CREATE TABLE " + FeedEntry.TABLE_NAME + " (" + FeedEntry._ID + " INTEGER PRIMARY KEY," + FeedEntry.COLUMN_NAME_TITLE + " TEXT," + FeedEntry.COLUMN_NAME_SUBTITLE + " TEXT)"; private static final String SQL_DELETE_ENTRIES = "DROP TABLE IF EXISTS " + FeedEntry.TABLE_NAME;
ठीक वैसे ही, जैसे डिवाइस के अंदरूनी डिवाइस पर सेव की गई फ़ाइलें स्टोरेज, Android आपके डेटाबेस को ऐप्लिकेशन के निजी फ़ोल्डर में सेव करता है. आपका डेटा सुरक्षित है, क्योंकि डिफ़ॉल्ट रूप से यह क्षेत्र जिसे दूसरे ऐप्लिकेशन या उपयोगकर्ता ऐक्सेस कर सकते हैं.
SQLiteOpenHelper
क्लास में शामिल है
आपके डेटाबेस को मैनेज करने के लिए एपीआई का सेट.
जब अपने डेटाबेस के रेफ़रंस पाने के लिए इस क्लास का इस्तेमाल किया जाता है, तो सिस्टम
की परफ़ॉर्मेंस
डेटाबेस बनाने और अपडेट करने की लंबे समय तक चलने वाली कार्रवाइयां सिर्फ़ तब
ज़रूरी है और ऐप्लिकेशन शुरू होने के दौरान नहीं. आपको बस कॉल करना है
getWritableDatabase()
या
getReadableDatabase()
.
ध्यान दें: ये लंबे समय तक चल सकते हैं,
पक्का करें कि आप getWritableDatabase()
या getReadableDatabase()
को बैकग्राउंड थ्रेड में कॉल करें.
ज़्यादा जानकारी के लिए, Android पर थ्रेडिंग लेख पढ़ें.
SQLiteOpenHelper
का इस्तेमाल करने के लिए, एक ऐसी सब-क्लास बनाएं जो
onCreate()
को ओवरराइड करता है और
onUpgrade()
कॉलबैक के तरीके. आप
साथ ही, अलग-अलग वर्शन में
onDowngrade()
या
onOpen()
तरीके,
लेकिन ऐसा करना ज़रूरी नहीं है.
उदाहरण के लिए, यहां SQLiteOpenHelper
को लागू करने का तरीका दिखाया गया है
ऊपर दिखाए गए कुछ निर्देशों का इस्तेमाल करता है:
Kotlin
class FeedReaderDbHelper(context: Context) : SQLiteOpenHelper(context, DATABASE_NAME, null, DATABASE_VERSION) { override fun onCreate(db: SQLiteDatabase) { db.execSQL(SQL_CREATE_ENTRIES) } override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) { // This database is only a cache for online data, so its upgrade policy is // to simply to discard the data and start over db.execSQL(SQL_DELETE_ENTRIES) onCreate(db) } override fun onDowngrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) { onUpgrade(db, oldVersion, newVersion) } companion object { // If you change the database schema, you must increment the database version. const val DATABASE_VERSION = 1 const val DATABASE_NAME = "FeedReader.db" } }
Java
public class FeedReaderDbHelper extends SQLiteOpenHelper { // If you change the database schema, you must increment the database version. public static final int DATABASE_VERSION = 1; public static final String DATABASE_NAME = "FeedReader.db"; public FeedReaderDbHelper(Context context) { super(context, DATABASE_NAME, null, DATABASE_VERSION); } public void onCreate(SQLiteDatabase db) { db.execSQL(SQL_CREATE_ENTRIES); } public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { // This database is only a cache for online data, so its upgrade policy is // to simply to discard the data and start over db.execSQL(SQL_DELETE_ENTRIES); onCreate(db); } public void onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion) { onUpgrade(db, oldVersion, newVersion); } }
अपने डेटाबेस तक पहुंचने के लिए, की अपनी सब-क्लास को इंस्टैंशिएट करें
SQLiteOpenHelper
:
Kotlin
val dbHelper = FeedReaderDbHelper(context)
Java
FeedReaderDbHelper dbHelper = new FeedReaderDbHelper(getContext());
जानकारी को किसी डेटाबेस में रखें
ContentValues
को पास करके, डेटाबेस में डेटा डालें
insert()
तरीके का इस्तेमाल करें:
Kotlin
// Gets the data repository in write mode val db = dbHelper.writableDatabase // Create a new map of values, where column names are the keys val values = ContentValues().apply { put(FeedEntry.COLUMN_NAME_TITLE, title) put(FeedEntry.COLUMN_NAME_SUBTITLE, subtitle) } // Insert the new row, returning the primary key value of the new row val newRowId = db?.insert(FeedEntry.TABLE_NAME, null, values)
Java
// Gets the data repository in write mode SQLiteDatabase db = dbHelper.getWritableDatabase(); // Create a new map of values, where column names are the keys ContentValues values = new ContentValues(); values.put(FeedEntry.COLUMN_NAME_TITLE, title); values.put(FeedEntry.COLUMN_NAME_SUBTITLE, subtitle); // Insert the new row, returning the primary key value of the new row long newRowId = db.insert(FeedEntry.TABLE_NAME, null, values);
insert()
के लिए पहला आर्ग्युमेंट
बस टेबल का नाम है.
दूसरे तर्क फ़्रेमवर्क को यह बताता है कि ऐसी स्थिति में क्या किया जाए,
ContentValues
खाली है (यानी, आपने नहीं खाली किया है
put
कोई भी वैल्यू डालें).
अगर किसी कॉलम का नाम बताया जाता है, तो फ़्रेमवर्क एक पंक्ति डालता है और सेट करता है
उस कॉलम की वैल्यू को शून्य कर दें. अगर आपने null
के बारे में बताया है, जैसा कि
कोड सैंपल है, कोई भी वैल्यू न होने पर फ़्रेमवर्क, पंक्ति शामिल नहीं करता.
insert()
तरीका
नई पंक्ति बनाएं या डेटा डालने में कोई गड़बड़ी होने पर यह -1 दिखाएगा. यह हो सकता है
अगर डेटाबेस में पहले से मौजूद डेटा से आपका कोई विवाद है.
डेटाबेस से जानकारी पढ़ना
किसी डेटाबेस से पढ़ने के लिए, query()
तरीके का इस्तेमाल करें. इसके बाद, इसे अपनी चुनी गई शर्तों और पसंदीदा कॉलम में पास करें.
इस तरीके में insert()
के एलिमेंट शामिल होते हैं
और update()
, कॉलम सूची को छोड़कर
डाले जाने वाले डेटा के बजाय, वह डेटा ("प्रोजेक्शन") तय करता है जिसे आपको फ़ेच करना है. नतीजे
आपको क्वेरी का जवाब Cursor
ऑब्जेक्ट में दिया जाता है.
Kotlin
val db = dbHelper.readableDatabase // Define a projection that specifies which columns from the database // you will actually use after this query. val projection = arrayOf(BaseColumns._ID, FeedEntry.COLUMN_NAME_TITLE, FeedEntry.COLUMN_NAME_SUBTITLE) // Filter results WHERE "title" = 'My Title' val selection = "${FeedEntry.COLUMN_NAME_TITLE} = ?" val selectionArgs = arrayOf("My Title") // How you want the results sorted in the resulting Cursor val sortOrder = "${FeedEntry.COLUMN_NAME_SUBTITLE} DESC" val cursor = db.query( FeedEntry.TABLE_NAME, // The table to query projection, // The array of columns to return (pass null to get all) selection, // The columns for the WHERE clause selectionArgs, // The values for the WHERE clause null, // don't group the rows null, // don't filter by row groups sortOrder // The sort order )
Java
SQLiteDatabase db = dbHelper.getReadableDatabase(); // Define a projection that specifies which columns from the database // you will actually use after this query. String[] projection = { BaseColumns._ID, FeedEntry.COLUMN_NAME_TITLE, FeedEntry.COLUMN_NAME_SUBTITLE }; // Filter results WHERE "title" = 'My Title' String selection = FeedEntry.COLUMN_NAME_TITLE + " = ?"; String[] selectionArgs = { "My Title" }; // How you want the results sorted in the resulting Cursor String sortOrder = FeedEntry.COLUMN_NAME_SUBTITLE + " DESC"; Cursor cursor = db.query( FeedEntry.TABLE_NAME, // The table to query projection, // The array of columns to return (pass null to get all) selection, // The columns for the WHERE clause selectionArgs, // The values for the WHERE clause null, // don't group the rows null, // don't filter by row groups sortOrder // The sort order );
तीसरे और चौथे तर्क (selection
और selectionArgs
) ये हैं
WHERE क्लॉज़ बनाने के लिए जोड़ा जाता है. क्योंकि आर्ग्युमेंट को चुने गए विकल्प से अलग दिया जाता है
क्वेरी नहीं करते हैं, तो उन्हें जोड़ने से पहले एस्केप कर दिया जाता है. इससे आपके चुने गए स्टेटमेंट में एसक्यूएल का असर नहीं होता
इंजेक्शन. सभी आर्ग्युमेंट के बारे में ज़्यादा जानकारी पाने के लिए, यह देखें
query()
संदर्भ.
कर्सर की कोई पंक्ति देखने के लिए, Cursor
में से किसी एक मूव का इस्तेमाल करें
विधियों का उपयोग करें, जिन्हें आपको वैल्यू पढ़ना शुरू करने से पहले हमेशा कॉल करना चाहिए. कर्सर इतने समय से शुरू होता है:
स्थिति -1, moveToNext()
को कॉल करने से "पढ़ने की स्थिति" का पता चलता है पूरी तरह कैसे
परिणामों में पहली प्रविष्टि और यह लौटाता है कि कर्सर पहले से ही अंतिम प्रविष्टि से पहले है या नहीं
नतीजा सेट नहीं किया जा सकता. हर पंक्ति के लिए, आप
Cursor
को getString()
या getLong()
जैसे तरीके मिलते हैं. पाने के हर तरीके के लिए,
आपको अपने मनचाहे कॉलम की इंडेक्स पोज़िशन पास करनी होगी, जो आपको
getColumnIndex()
या
getColumnIndexOrThrow()
. पूरा होने पर
नतीजों को फिर से दोहराते हुए, कर्सर पर close()
को कॉल करें
संसाधन रिलीज़ करने में मदद मिलती है.
उदाहरण के लिए, कर्सर में स्टोर किए गए सभी आइटम आईडी को पाने का तरीका नीचे बताया गया है
और उन्हें सूची में जोड़ें:
Kotlin
val itemIds = mutableListOf<Long>() with(cursor) { while (moveToNext()) { val itemId = getLong(getColumnIndexOrThrow(BaseColumns._ID)) itemIds.add(itemId) } } cursor.close()
Java
List itemIds = new ArrayList<>(); while(cursor.moveToNext()) { long itemId = cursor.getLong( cursor.getColumnIndexOrThrow(FeedEntry._ID)); itemIds.add(itemId); } cursor.close();
डेटाबेस से जानकारी मिटाना
टेबल से पंक्तियां मिटाने के लिए, आपको चुनने का ऐसा मानदंड देना होगा जिसमें
delete()
तरीके से पंक्तियों की पहचान करें. कॉन्टेंट बनाने
प्रणाली
query()
तरीका. यह
चुनें. कॉन्टेंट बनाने
क्लॉज़ देखने के लिए कॉलम के बारे में बताता है. साथ ही, आपको कॉलम को जोड़ने की अनुमति भी देता है
टेस्ट. आर्ग्युमेंट, वे वैल्यू होती हैं जिनकी जांच की जाती है. ये वैल्यू, क्लॉज़ से जुड़ी होती हैं.
नतीजे को सामान्य SQL स्टेटमेंट की तरह हैंडल नहीं किया जाता, इसलिए यह
एसक्यूएल इंजेक्शन के लिए पूरी तरह सुरक्षित नहीं है.
Kotlin
// Define 'where' part of query. val selection = "${FeedEntry.COLUMN_NAME_TITLE} LIKE ?" // Specify arguments in placeholder order. val selectionArgs = arrayOf("MyTitle") // Issue SQL statement. val deletedRows = db.delete(FeedEntry.TABLE_NAME, selection, selectionArgs)
Java
// Define 'where' part of query. String selection = FeedEntry.COLUMN_NAME_TITLE + " LIKE ?"; // Specify arguments in placeholder order. String[] selectionArgs = { "MyTitle" }; // Issue SQL statement. int deletedRows = db.delete(FeedEntry.TABLE_NAME, selection, selectionArgs);
delete()
तरीके के लिए रिटर्न वैल्यू
डेटाबेस से मिटाई गई लाइनों की संख्या दिखाता है.
डेटाबेस को अपडेट करना
जब आपको अपने डेटाबेस की वैल्यू के सबसेट में बदलाव करने की ज़रूरत हो, तो
update()
तरीका.
टेबल को अपडेट करने पर, इसका ContentValues
सिंटैक्स जुड़ जाता है
WHERE
सिंटैक्स वाला insert()
delete()
का.
Kotlin
val db = dbHelper.writableDatabase // New value for one column val title = "MyNewTitle" val values = ContentValues().apply { put(FeedEntry.COLUMN_NAME_TITLE, title) } // Which row to update, based on the title val selection = "${FeedEntry.COLUMN_NAME_TITLE} LIKE ?" val selectionArgs = arrayOf("MyOldTitle") val count = db.update( FeedEntry.TABLE_NAME, values, selection, selectionArgs)
Java
SQLiteDatabase db = dbHelper.getWritableDatabase(); // New value for one column String title = "MyNewTitle"; ContentValues values = new ContentValues(); values.put(FeedEntry.COLUMN_NAME_TITLE, title); // Which row to update, based on the title String selection = FeedEntry.COLUMN_NAME_TITLE + " LIKE ?"; String[] selectionArgs = { "MyOldTitle" }; int count = db.update( FeedReaderDbHelper.FeedEntry.TABLE_NAME, values, selection, selectionArgs);
update()
तरीके की रिटर्न वैल्यू है
डेटाबेस में उन पंक्तियों की संख्या जिन पर असर पड़ा है.
डेटाबेस कनेक्शन को कायम रखना
getWritableDatabase()
से
और getReadableDatabase()
डेटाबेस बंद होने पर कॉल करना महंगा होता है, तो आपको अपना डेटाबेस कनेक्शन छोड़ देना चाहिए
खोलें. आम तौर पर, डेटाबेस को बंद करना सबसे अच्छा होता है
कॉल की गतिविधि के onDestroy()
में.
Kotlin
override fun onDestroy() { dbHelper.close() super.onDestroy() }
Java
@Override protected void onDestroy() { dbHelper.close(); super.onDestroy(); }
अपने डेटाबेस को डीबग करना
Android SDK में sqlite3
शेल टूल शामिल है. इसकी मदद से,
SQLite पर टेबल का कॉन्टेंट, SQL के निर्देश चलाएं, और काम के अन्य फ़ंक्शन पूरे करें
डेटाबेस. ज़्यादा जानकारी के लिए, शेल वाले निर्देश जारी करने का तरीका देखें.