Verileri bir veritabanına kaydetmek, iletişim bilgileri gibi tekrarlanan veya yapılandırılmış veriler için idealdir. Bu sayfada, genel olarak SQL veritabanlarına aşina olduğunuz varsayılır ve Android'de SQLite veritabanlarını kullanmaya başlamanıza yardımcı olunur. Android'de veritabanı kullanmak için gereken API'ler android.database.sqlite paketinde bulunur.
Dikkat: Bu API'ler güçlü olsa da oldukça alt düzeydedir ve kullanmak için çok fazla zaman ve çaba gerekir:
- Ham SQL sorgularının derleme zamanı doğrulaması yoktur. Veri grafiğiniz değiştikçe etkilenen SQL sorgularını manuel olarak güncellemeniz gerekir. Bu süreç zaman alabilir ve hataya açık olabilir.
- SQL sorguları ile veri nesneleri arasında dönüştürme yapmak için çok sayıda ortak metin kodu kullanmanız gerekir.
Bu nedenlerle, uygulamanızın SQLite veritabanlarındaki bilgilere erişmek için soyutlama katmanı olarak Room kalıcılık kitaplığını kullanmanızı kesinlikle öneririz.
Şema ve sözleşme tanımlama
SQL veritabanlarının temel ilkelerinden biri şemadır. Şema, veritabanının nasıl düzenlendiğinin resmi bir beyanıdır. Şema, veritabanınızı oluşturmak için kullandığınız SQL ifadelerine yansıtılır. Şemanızın düzenini sistematik ve kendi kendini belgeleyen bir şekilde açıkça belirten, ilişkili sınıf olarak bilinen bir yardımcı sınıf oluşturmak faydalı olabilir.
İlişkili sınıf; URI'ler, tablolar ve sütunlar için adları tanımlayan sabitlerin yer aldığı bir kapsayıcıdır. İlişkili sınıf, aynı paketteki diğer tüm sınıflarda aynı sabitleri kullanmanıza olanak tanır. Bu sayede, bir sütun adını tek bir yerde değiştirip kodunuzun tamamına uygulayabilirsiniz.
İlişkili sınıfı düzenlemenin iyi bir yolu, tüm veritabanınız için genel olan tanımları sınıfın kök düzeyine yerleştirmektir. Ardından her tablo için bir iç sınıf oluşturun. Her iç sınıf, ilgili tablonun sütunlarını listeler.
Not: BaseColumns arayüzünü uygulayarak iç sınıfınız, CursorAdapter gibi bazı Android sınıflarının sahip olmasını beklediği _ID adlı bir birincil anahtar alanını devralabilir. Zorunlu olmasa da bu, veritabanınızın Android çerçevesiyle uyumlu bir şekilde çalışmasına yardımcı olabilir.
Örneğin, aşağıdaki sözleşme, bir RSS özet akışını temsil eden tek bir tablonun tablo adını ve sütun adlarını tanımlar:
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"; } }
SQL yardımcı sınıfı kullanarak veritabanı oluşturma
Veritabanınızın nasıl görüneceğini tanımladıktan sonra veritabanını ve tabloları oluşturan ve yöneten yöntemleri uygulamanız gerekir. Tablo oluşturup silen bazı tipik ifadeler şunlardır:
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, cihazın dahili depolama alanına kaydettiğiniz dosyalar gibi veritabanınızı da uygulamanızın özel klasöründe saklar. Bu alana varsayılan olarak diğer uygulamalar veya kullanıcılar erişemediği için verileriniz güvendedir.
SQLiteOpenHelper sınıfı, veritabanınızı yönetmek için kullanışlı bir API grubu içerir.
Veritabanınıza referanslar almak için bu sınıfı kullandığınızda sistem, veritabanını oluşturma ve güncelleme gibi uzun sürebilecek işlemleri yalnızca gerektiğinde gerçekleştirir, uygulama başlatılırken gerçekleştirmez. getWritableDatabase() veya
getReadableDatabase() numaralı telefonu aramanız yeterlidir.
Not: Uzun sürebileceğinden getWritableDatabase() veya getReadableDatabase() yöntemini arka plan iş parçacığında çağırdığınızdan emin olun.
Daha fazla bilgi için Android'de iş parçacığı oluşturma başlıklı makaleyi inceleyin.
SQLiteOpenHelper sınıfını kullanmak için onCreate() ve onUpgrade() geri çağırma yöntemlerini geçersiz kılan bir alt sınıf oluşturun. onDowngrade() veya onOpen() yöntemlerini de uygulamak isteyebilirsiniz ancak bunlar zorunlu değildir.
Örneğin, yukarıda gösterilen komutlardan bazılarını kullanan bir SQLiteOpenHelper uygulaması aşağıda verilmiştir:
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); } }
Veritabanınıza erişmek için SQLiteOpenHelper alt sınıfınızı örneklendirin:
Kotlin
val dbHelper = FeedReaderDbHelper(context)
Java
FeedReaderDbHelper dbHelper = new FeedReaderDbHelper(getContext());
Bilgileri bir veritabanına ekleme
insert() yöntemine bir ContentValues nesnesi ileterek veritabanına veri ekleyin:
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() için ilk bağımsız değişken, tablo adıdır.
İkinci bağımsız değişken, ContentValues boşsa (yani herhangi bir değer put) çerçeveye ne yapması gerektiğini söyler.
Bir sütunun adını belirtirseniz çerçeve bir satır ekler ve bu sütunun değerini null olarak ayarlar. Bu kod örneğinde olduğu gibi null değerini belirtirseniz çerçeve, değer olmadığında satır eklemez.
insert() yöntemleri, yeni oluşturulan satırın kimliğini döndürür veya veri eklenirken hata oluştuysa -1 değerini döndürür. Bu durum, veritabanındaki mevcut verilerle çakışma olduğunda ortaya çıkabilir.
Veritabanından bilgi okuma
Bir veritabanından okuma yapmak için query() yöntemini kullanın ve seçim ölçütlerinizi ve istediğiniz sütunları iletin.
Bu yöntem, insert() ve update() öğelerini birleştirir. Ancak sütun listesi, eklenecek veriler yerine getirmek istediğiniz verileri ("projeksiyon") tanımlar. Sorgunun sonuçları size Cursor nesnesi olarak döndürülür.
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 );
Üçüncü ve dördüncü bağımsız değişkenler (selection ve selectionArgs), bir WHERE ifadesi oluşturmak için birleştirilir. Bağımsız değişkenler seçim sorgusundan ayrı olarak sağlandığından, birleştirilmeden önce kaçış karakteri eklenir. Bu sayede seçim ifadeleriniz SQL yerleştirme saldırılarına karşı korumalı hale gelir. Tüm bağımsız değişkenler hakkında daha fazla bilgi için query() referansına bakın.
İmleçteki bir satıra bakmak için Cursor taşıma yöntemlerinden birini kullanın. Değerleri okumaya başlamadan önce her zaman bu yöntemlerden birini çağırmanız gerekir. İmleç -1 konumunda başladığından, moveToNext() çağrıldığında "okuma konumu" sonuçlardaki ilk girişe yerleştirilir ve imlecin sonuç kümesindeki son girişi geçip geçmediği döndürülür. Her satır için Cursor alma yöntemlerinden birini (ör. getString() veya getLong()) çağırarak bir sütunun değerini okuyabilirsiniz. Her bir alma yöntemi için istediğiniz sütunun dizin konumunu iletmeniz gerekir. Bu konumu getColumnIndex() veya getColumnIndexOrThrow() yöntemini çağırarak öğrenebilirsiniz. Sonuçlar arasında gezinme işlemi tamamlandığında imleçte close() yöntemini çağırarak kaynaklarını serbest bırakın.
Örneğin, aşağıdaki kodda bir imleçte depolanan tüm öğe kimliklerinin nasıl alınacağı ve bir listeye nasıl ekleneceği gösterilmektedir:
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();
Veritabanından bilgi silme
Bir tablodan satır silmek için delete() yöntemine satırları tanımlayan seçim ölçütleri sağlamanız gerekir. Mekanizma, query() yönteminin seçim bağımsız değişkenleriyle aynı şekilde çalışır. Seçim spesifikasyonunu bir seçim yan tümcesine ve seçim bağımsız değişkenlerine böler. The
clause defines the columns to look at, and also lets you combine column
tests. Bağımsız değişkenler, yan tümceye bağlı olan ve test edilecek değerlerdir.
Sonuç, normal bir SQL ifadesiyle aynı şekilde işlenmediğinden SQL yerleştirme saldırılarına karşı korumalıdır.
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() yönteminin döndürdüğü değer, veritabanından silinen satır sayısını gösterir.
Veritabanı güncelleme
Veritabanı değerlerinizin bir alt kümesini değiştirmeniz gerektiğinde update() yöntemini kullanın.
Tabloyu güncellemek, insert()'nin ContentValues söz dizimini delete()'nin WHERE söz dizimiyle birleştirir.
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() yönteminin döndürdüğü değer,
veritabanında etkilenen satır sayısıdır.
Veritabanı bağlantısı kalıcı hale getiriliyor
Veritabanı kapalıyken getWritableDatabase() ve getReadableDatabase() yöntemlerini çağırmak maliyetli olduğundan veritabanı bağlantınızı, erişmeniz gereken süre boyunca açık bırakmanız gerekir. Genellikle veritabanını, çağıran etkinliğin onDestroy() yönteminde kapatmak en iyisidir.
Kotlin
override fun onDestroy() { dbHelper.close() super.onDestroy() }
Java
@Override protected void onDestroy() { dbHelper.close(); super.onDestroy(); }
Veritabanınızda hata ayıklama
Android SDK'da, SQLite veritabanlarında tablo içeriklerine göz atmanıza, SQL komutları çalıştırmanıza ve diğer faydalı işlevleri gerçekleştirmenize olanak tanıyan bir sqlite3 kabuk aracı bulunur. Daha fazla bilgi için kabuk komutları verme başlıklı makaleyi inceleyin.