Flutter ile SQLite Kullanımı: Yerel Veritabanı Yönetimi Rehberi

Mobil uygulama geliştirme sürecinde, verileri kalıcı olarak saklamak ve yönetmek önemli bir gereksinimdir. Flutter, bu ihtiyacı karşılamak için çeşitli yöntemler sunar. Bunlardan biri de SQLite veritabanıdır. SQLite, hafif, sunucusuz ve yerel bir veritabanı çözümüdür. Bu makalede, Flutter uygulamalarında SQLite’ı nasıl kullanabileceğinizi adım adım inceleyeceğiz. Başlangıç seviyesinden ileri seviyeye kadar, SQLite’ın temel kavramlarını, kurulumunu, kullanımını ve optimizasyonunu ele alacağız.

İçindekiler

• SQLite’a Giriş
• Neden SQLite Kullanmalısınız?
• Flutter’da SQLite Kurulumu
• Veritabanı Oluşturma ve Bağlantı Kurma
• Tablo Oluşturma
• CRUD İşlemleri (Oluşturma, Okuma, Güncelleme, Silme)
• Gelişmiş Sorgulama Teknikleri
• Performansı Artırma İpuçları
• Hata Yönetimi ve Hata Ayıklama
• Örnek Proje: Basit Bir Not Uygulaması
• Sonuç

SQLite’a Giriş

SQLite, gömülü sistemlerde ve mobil cihazlarda yaygın olarak kullanılan, C ile yazılmış, ilişkisel bir veritabanı yönetim sistemidir (RDBMS). Verileri tek bir dosyada saklar, bu da onu taşınabilir ve kolayca yönetilebilir kılar. Sunucuya ihtiyaç duymadığı için, kaynak kısıtlı cihazlar için ideal bir çözümdür. Flutter ile geliştirilen uygulamalarda da sıklıkla tercih edilir.

Neden SQLite Kullanmalısınız?

SQLite kullanmanın birçok avantajı vardır:

• Hafif ve Sunucusuz: Sunucu kurulumu gerektirmez, bu da kurulumu ve yapılandırmayı kolaylaştırır.
• Taşınabilirlik: Veritabanı tek bir dosyada saklandığı için, uygulamalar arasında kolayca taşınabilir.
• Verimlilik: Küçük boyutuna rağmen, birçok uygulama için yeterli performansı sunar.
• Ücretsiz ve Açık Kaynak: Herhangi bir lisans ücreti ödemeden kullanabilirsiniz.
• Flutter Entegrasyonu: Flutter, SQLite ile kolay entegrasyon için gerekli araçları ve kütüphaneleri sunar.

Flutter’da SQLite Kurulumu

Flutter projenizde SQLite kullanabilmek için öncelikle gerekli paketleri eklemeniz gerekir. sqflite ve path_provider paketleri, SQLite ile çalışmak için en sık kullanılan paketlerdir. sqflite paketi, SQLite veritabanı işlemlerini gerçekleştirmenizi sağlar. path_provider paketi ise, uygulamanızın veritabanı dosyasını saklayabileceği uygun bir dizini bulmanıza yardımcı olur.

pubspec.yaml dosyanıza aşağıdaki bağımlılıkları ekleyin:

dependencies:
  sqflite: ^2.3.0
  path_provider: ^2.1.0

Daha sonra terminalinizde flutter pub get komutunu çalıştırarak paketleri yükleyin.

Veritabanı Oluşturma ve Bağlantı Kurma

SQLite kullanmaya başlamak için öncelikle bir veritabanı oluşturmanız ve bağlantı kurmanız gerekir. Aşağıdaki kod örneği, bir veritabanı oluşturmayı ve bağlantı kurmayı gösterir:

import 'package:sqflite/sqflite.dart';
import 'package:path/path.dart';
import 'package:path_provider/path_provider.dart';

Future<Database> initDatabase() async {
  final documentsDirectory = await getApplicationDocumentsDirectory();
  final path = join(documentsDirectory.path, "my_database.db");

  return openDatabase(
    path,
    version: 1,
    onCreate: (Database db, int version) async {
      await db.execute(
        'CREATE TABLE notes (id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT, content TEXT)',
      );
    },
  );
}

Bu kodda, öncelikle gerekli paketleri import ediyoruz. Ardından, initDatabase() fonksiyonu, veritabanı dosyasının yolunu belirler ve openDatabase() fonksiyonunu kullanarak veritabanını açar. Eğer veritabanı yoksa, onCreate fonksiyonu çalışır ve veritabanını oluşturur. Bu örnekte, notes adında bir tablo oluşturuyoruz.

Tablo Oluşturma

Veritabanı oluşturduktan sonra, verilerinizi saklamak için tablolar oluşturmanız gerekir. Tablolar, verilerinizi düzenli bir şekilde saklamanızı sağlar. Her tablo, belirli bir veri türünü temsil eden sütunlardan oluşur. Yukarıdaki örnekte, notes tablosunu oluşturduk. Bu tablo, id, title ve content adında üç sütundan oluşur.

id sütunu, notların benzersiz kimliklerini saklar. INTEGER PRIMARY KEY AUTOINCREMENT ifadesi, bu sütunun birincil anahtar olduğunu ve otomatik olarak artan bir tamsayı değeri alacağını belirtir. title sütunu, notların başlıklarını saklar. TEXT ifadesi, bu sütunun metin verilerini saklayacağını belirtir. content sütunu, notların içeriğini saklar. TEXT ifadesi, bu sütunun metin verilerini saklayacağını belirtir.

CRUD İşlemleri (Oluşturma, Okuma, Güncelleme, Silme)

CRUD, veritabanı işlemlerinin temelini oluşturan dört temel işlemdir: Oluşturma (Create), Okuma (Read), Güncelleme (Update) ve Silme (Delete). Bu işlemler, veritabanındaki verileri yönetmek için kullanılır.

Oluşturma (Create)

Yeni bir not oluşturmak için aşağıdaki kodu kullanabilirsiniz:

Future<int> insertNote(String title, String content) async {
  final db = await initDatabase();
  return await db.insert(
    'notes',
    {
      'title': title,
      'content': content,
    },
    conflictAlgorithm: ConflictAlgorithm.replace,
  );
}

Bu kodda, insertNote() fonksiyonu, title ve content parametrelerini alır ve bu verileri notes tablosuna ekler. conflictAlgorithm: ConflictAlgorithm.replace ifadesi, aynı birincil anahtara sahip bir kayıt varsa, mevcut kaydın üzerine yazılacağını belirtir.

Okuma (Read)

Tüm notları okumak için aşağıdaki kodu kullanabilirsiniz:

Future<List<Map<String, dynamic>>> getNotes() async {
  final db = await initDatabase();
  return await db.query('notes');
}

Bu kodda, getNotes() fonksiyonu, notes tablosundaki tüm kayıtları okur ve bir liste olarak döndürür.

Güncelleme (Update)

Mevcut bir notu güncellemek için aşağıdaki kodu kullanabilirsiniz:

Future<int> updateNote(int id, String title, String content) async {
  final db = await initDatabase();
  return await db.update(
    'notes',
    {
      'title': title,
      'content': content,
    },
    where: 'id = ?',
    whereArgs: [id],
  );
}

Bu kodda, updateNote() fonksiyonu, id, title ve content parametrelerini alır ve belirtilen id değerine sahip notu günceller. where: 'id = ?' ve whereArgs: [id] ifadeleri, hangi kaydın güncelleneceğini belirtir.

Silme (Delete)

Mevcut bir notu silmek için aşağıdaki kodu kullanabilirsiniz:

Future<int> deleteNote(int id) async {
  final db = await initDatabase();
  return await db.delete(
    'notes',
    where: 'id = ?',
    whereArgs: [id],
  );
}

Bu kodda, deleteNote() fonksiyonu, id parametresini alır ve belirtilen id değerine sahip notu siler. where: 'id = ?' ve whereArgs: [id] ifadeleri, hangi kaydın silineceğini belirtir.

Gelişmiş Sorgulama Teknikleri

SQLite, verilerinizi daha etkili bir şekilde sorgulamanızı sağlayan çeşitli gelişmiş sorgulama teknikleri sunar. Örneğin, belirli bir başlığa sahip notları bulmak, belirli bir tarih aralığında oluşturulan notları bulmak veya notları belirli bir sıralamaya göre sıralamak mümkündür.

Örneğin, belirli bir başlığa sahip notları bulmak için aşağıdaki kodu kullanabilirsiniz:

Future<List<Map<String, dynamic>>> getNotesByTitle(String title) async {
  final db = await initDatabase();
  return await db.query(
    'notes',
    where: 'title LIKE ?',
    whereArgs: ['%$title%'],
  );
}

Bu kodda, getNotesByTitle() fonksiyonu, title parametresini alır ve başlığında belirtilen metni içeren notları bulur. where: 'title LIKE ?' ve whereArgs: ['%$title%'] ifadeleri, hangi kayıtların bulunacağını belirtir. LIKE operatörü, metin eşleşmesi için kullanılır. % karakteri, herhangi bir sayıda karakteri temsil eder.

Performansı Artırma İpuçları

SQLite’ın performansı, veritabanının boyutu, sorguların karmaşıklığı ve cihazın donanımı gibi çeşitli faktörlerden etkilenebilir. SQLite’ın performansını artırmak için aşağıdaki ipuçlarını kullanabilirsiniz:

• İndeksleme: Sık kullanılan sütunlara indeks eklemek, sorgu performansını önemli ölçüde artırabilir.
• Toplu İşlemler: Birden fazla veritabanı işlemini tek bir işlemde gerçekleştirmek, performansı artırabilir.
• Veritabanı Optimizasyonu: Düzenli olarak veritabanını optimize etmek, performansı artırabilir.
• Sorgu Optimizasyonu: Sorguları optimize etmek, performansı artırabilir. Örneğin, gereksiz sütunları seçmekten kaçının ve mümkün olduğunca WHERE ifadesini kullanın.

Hata Yönetimi ve Hata Ayıklama

Veritabanı işlemleri sırasında hatalarla karşılaşmak mümkündür. Bu hataları yönetmek ve hata ayıklamak, uygulamanızın kararlılığını sağlamak için önemlidir. Flutter’da SQLite kullanırken, hataları yakalamak ve kullanıcıya anlamlı mesajlar göstermek için try-catch bloklarını kullanabilirsiniz.

Örneğin:

try {
  await insertNote('Başlık', 'İçerik');
} catch (e) {
  print('Hata oluştu: $e');
  // Kullanıcıya hata mesajı göster
}

Ayrıca, SQLite’ın hata kodlarını ve mesajlarını inceleyerek, hataların nedenini belirleyebilir ve uygun çözümler üretebilirsiniz.

Örnek Proje: Basit Bir Not Uygulaması

Bu bölümde, Flutter ve SQLite kullanarak basit bir not uygulaması geliştireceğiz. Bu uygulama, not oluşturma, notları listeleme, notları güncelleme ve notları silme işlemlerini gerçekleştirecek.

(Buraya uygulamanın kodları eklenebilir)

Sonuç

Bu makalede, Flutter uygulamalarında SQLite’ı nasıl kullanabileceğinizi ayrıntılı olarak inceledik. SQLite, mobil uygulamalar için güçlü ve esnek bir yerel veritabanı çözümü sunar. Doğru kullanıldığında, uygulamanızın performansını ve kullanıcı deneyimini önemli ölçüde artırabilir. Umarız bu rehber, Flutter projelerinizde SQLite kullanımına başlamanız için size yardımcı olmuştur. Flutter SQLite entegrasyonu sayesinde, yerel veri depolama ihtiyaçlarınızı kolayca karşılayabilirsiniz.