SQLite kullanarak veri tasarrufu sağlayın

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.