Integration af SQLite-databaser
Integrer SQLite-databaser i Deres Flutter-app ved hjælp af `sqflite`-pakken til struktureret og relationel datalagring.
Integration af SQLite-databaser er en gratis Mobiludvikling med Flutter-lektion på CoddyKit. Dette er lektion 2 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i Mobiludvikling med Flutter, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Mobiludvikling med Flutter-kurset indeholder 4 lektioner i alt.
Lagring af data med SQLite
Velkommen! I denne lektion lærer du, hvordan du integrerer en lokal database i din Flutter-app ved hjælp af SQLite.
SQLite er en letvægts, serverløs, selvstændig og transaktionel relationel databasemotor. Den er perfekt til at gemme strukturerede data direkte på brugerens enhed uden behov for en separat serverproces.
Klargøring af `sqflite`
For at bruge SQLite i Flutter benytter vi den populære pakke sqflite. Den leverer en robust grænseflade til SQLite-databaser.
Tilføj først pakken (sammen med path_provider og path til håndtering af databasefiler) til din pubspec.yaml-fil under dependencies:
dependencies:flutter:sdk: fluttersqflite: ^2.3.0path_provider: ^2.1.1path: ^1.8.3
Kør flutter pub get i din terminal, når du har tilføjet dem.
Hjælpeklasse til databasen
Det er god praksis at oprette en dedikeret "helper"-klasse til at håndtere dine databasehandlinger. Det samler logikken til at åbne, oprette og udføre forespørgsler.
Denne klasse håndterer typisk:
- Initialisering og åbning af databaseforbindelsen.
- Oprettelse af tabeller, første gang databasen åbnes.
- Levering af én enkelt instans (singleton) af databasen til hele applikationen.
- Abstrahering af direkte SQL-forespørgsler.
Initialisering af databasen
Lad os begynde at opbygge vores DatabaseHelper. Funktionen openDatabase er central. Den modtager stien til databasefilen og et onCreate-callback til den indledende opsætning.
Sådan åbner eller opretter du din database:
import 'package:sqflite/sqflite.dart';
import 'package:path/path.dart';
// NOTE: getDatabasesPath() requires Flutter context.
// This main method is for demonstration.
// In a real Flutter app, _initDatabase would be called
// from a StatefulWidget or similar.
class DatabaseHelper {
static final DatabaseHelper _instance = DatabaseHelper._internal();
static Database? _database;
factory DatabaseHelper() {
return _instance;
}
DatabaseHelper._internal();
Future<Database> get database async {
if (_database != null) return _database!;
_database = await _initDatabase();
return _database!;
}
Future<Database> _initDatabase() async {
// Get the default databases location for the platform
String path = await getDatabasesPath();
String dbPath = join(path, 'item_database.db');
return await openDatabase(
dbPath,
version: 1,
onCreate: (db, version) {
// Table creation logic will go here
print('Database created or opened.');
},
);
}
}
void main() async {
// This main is illustrative. sqflite operations need a
// running Flutter app context to fully function (e.g. for getDatabasesPath).
// When run in a Flutter app, DatabaseHelper().database
// would ensure the DB is initialized.
print('DatabaseHelper class defined.');
}
Oprettelse af din første tabel
Inde i onCreate-callbacket for _initDatabase definerer vi vores databaseskema ved hjælp af standard-SQL. Lad os oprette en simpel items-tabel.
Hvert element har et id (primærnøgle), et name (tekst) og en quantity (heltal).
import 'package:sqflite/sqflite.dart';
import 'package:path/path.dart';
class DatabaseHelper {
static final DatabaseHelper _instance = DatabaseHelper._internal();
static Database? _database;
factory DatabaseHelper() { return _instance; }
DatabaseHelper._internal();
Future<Database> get database async { if (_database != null) return _database!; _database = await _initDatabase(); return _database!; }
Future<Database> _initDatabase() async {
String path = await getDatabasesPath();
String dbPath = join(path, 'item_database.db');
return await openDatabase(dbPath, version: 1,
onCreate: (db, version) async {
// SQL to create the items table
await db.execute(
'''
CREATE TABLE items(
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT,
quantity INTEGER
)
'''
);
print('Table "items" created successfully.');
},
);
}
}
void main() async {
// This main is illustrative. In a Flutter app,
// calling DatabaseHelper().database would trigger
// _initDatabase and the onCreate callback.
print('Database helper configured for table creation.');
}
Oprettelse af en datamodel
Hvis du nemt vil arbejde med dataposter fra databasen, skal du definere en Dart-klasse, der afspejler tabellens struktur. Det hjælper med at kortlægge data mellem Dart-objekter og databasens rækker (som typisk repræsenteres som Map).
Her er vores Item-model med toMap()- og fromMap()-metoder:
class Item {
final int? id;
final String name;
final int quantity;
Item({this.id, required this.name, required this.quantity});
// Convert an Item into a Map. Keys must match DB column names.
Map<String, dynamic> toMap() {
return {
'id': id,
'name': name,
'quantity': quantity,
};
}
// Create an Item object from a Map (database row).
static Item fromMap(Map<String, dynamic> map) {
return Item(
id: map['id'],
name: map['name'],
quantity: map['quantity'],
);
}
@override
String toString() {
return 'Item(id: $id, name: $name, quantity: $quantity)';
}
}
void main() {
final myItem = Item(id: 1, name: 'Apple', quantity: 5);
print('Created Item: ${myItem.toString()}');
print('Converted to Map: ${myItem.toMap()}');
final itemMap = {'id': 2, 'name': 'Banana', 'quantity': 3};
final itemFromMap = Item.fromMap(itemMap);
print('Item from Map: ${itemFromMap.toString()}');
}
Indsættelse af data
Lad os nu tilføje en metode til vores DatabaseHelper, så vi kan indsætte nye elementer. Metoden insert modtager tabelnavnet og et Map (fra vores Item.toMap()).
Den returnerer id for den nyligt indsatte række.
import 'package:sqflite/sqflite.dart';
import 'package:path/path.dart';
// Item class (from previous scene, for self-containment)
class Item {
final int? id; final String name; final int quantity;
Item({this.id, required this.name, required this.quantity});
Map<String, dynamic> toMap() { return {'id': id, 'name': name, 'quantity': quantity}; }
static Item fromMap(Map<String, dynamic> map) { return Item(id: map['id'], name: map['name'], quantity: map['quantity']); }
@override
String toString() { return 'Item(id: $id, name: $name, quantity: $quantity)'; }
}
class DatabaseHelper {
static final DatabaseHelper _instance = DatabaseHelper._internal();
static Database? _database;
factory DatabaseHelper() { return _instance; }
DatabaseHelper._internal();
Future<Database> get database async { if (_database != null) return _database!; _database = await _initDatabase(); return _database!; }
Future<Database> _initDatabase() async {
String path = await getDatabasesPath();
String dbPath = join(path, 'item_database.db');
return await openDatabase(dbPath, version: 1,
onCreate: (db, version) async {
await db.execute('''
CREATE TABLE items(id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, quantity INTEGER)
''');
},
);
}
Future<int> insertItem(Item item) async {
final db = await database;
return await db.insert(
'items',
item.toMap(),
conflictAlgorithm: ConflictAlgorithm.replace, // Replace if ID exists
);
}
}
void main() async {
// Illustrative main. In a Flutter app, you'd call:
// final dbHelper = DatabaseHelper();
// final newItem = Item(name: 'Milk', quantity: 2);
// int id = await dbHelper.insertItem(newItem);
// print('Inserted item with id: $id');
print('Item insertion logic defined in DatabaseHelper.');
}
Forespørgsler på data
Brug metoden query til at læse data. Den returnerer en List, som du derefter konverterer tilbage til dine Dart-Item-objekter ved hjælp af Item.fromMap().
Du kan forespørge efter alle elementer eller bestemte elementer ved hjælp af where-klausuler.
import 'package:sqflite/sqflite.dart';
import 'package:path/path.dart';
// Item class (for self-containment)
class Item {
final int? id; final String name; final int quantity;
Item({this.id, required this.name, required this.quantity});
Map<String, dynamic> toMap() { return {'id': id, 'name': name, 'quantity': quantity}; }
static Item fromMap(Map<String, dynamic> map) { return Item(id: map['id'], name: map['name'], quantity: map['quantity']); }
@override
String toString() { return 'Item(id: $id, name: $name, quantity: $quantity)'; }
}
class DatabaseHelper {
static final DatabaseHelper _instance = DatabaseHelper._internal();
static Database? _database;
factory DatabaseHelper() { return _instance; }
DatabaseHelper._internal();
Future<Database> get database async { if (_database != null) return _database!; _database = await _initDatabase(); return _database!; }
Future<Database> _initDatabase() async {
String path = await getDatabasesPath();
String dbPath = join(path, 'item_database.db');
return await openDatabase(dbPath, version: 1,
onCreate: (db, version) async {
await db.execute('''
CREATE TABLE items(id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, quantity INTEGER)
''');
},
);
}
Future<List<Item>> getItems() async {
final db = await database;
// Query all the items from the table
final List<Map<String, dynamic>> maps = await db.query('items');
// Convert the List<Map<String, dynamic>> into a List<Item>.
return List.generate(maps.length, (i) {
return Item.fromMap(maps[i]);
});
}
}
void main() async {
// Illustrative main. In a Flutter app, you'd call:
// final dbHelper = DatabaseHelper();
// await dbHelper.insertItem(Item(name: 'Bread', quantity: 1));
// final items = await dbHelper.getItems();
// print('Retrieved items: $items');
print('Item query logic defined in DatabaseHelper.');
}
Opdatering af data
Brug metoden update til at ændre en eksisterende post. Du angiver tabelnavnet, de nye data som et Map og en where-klausul for at angive, hvilke poster der skal opdateres.
Brug altid whereArgs sammen med pladsholdere (?) til at overføre værdier sikkert og forhindre SQL-injektion.
import 'package:sqflite/sqflite.dart';
import 'package:path/path.dart';
// Item class (for self-containment)
class Item {
final int? id; final String name; final int quantity;
Item({this.id, required this.name, required this.quantity});
Map<String, dynamic> toMap() { return {'id': id, 'name': name, 'quantity': quantity}; }
static Item fromMap(Map<String, dynamic> map) { return Item(id: map['id'], name: map['name'], quantity: map['quantity']); }
@override
String toString() { return 'Item(id: $id, name: $name, quantity: $quantity)'; }
}
class DatabaseHelper {
static final DatabaseHelper _instance = DatabaseHelper._internal();
static Database? _database;
factory DatabaseHelper() { return _instance; }
DatabaseHelper._internal();
Future<Database> get database async { if (_database != null) return _database!; _database = await _initDatabase(); return _database!; }
Future<Database> _initDatabase() async {
String path = await getDatabasesPath();
String dbPath = join(path, 'item_database.db');
return await openDatabase(dbPath, version: 1,
onCreate: (db, version) async {
await db.execute('''
CREATE TABLE items(id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, quantity INTEGER)
''');
},
);
}
Future<int> updateItem(Item item) async {
final db = await database;
return await db.update(
'items',
item.toMap(),
where: 'id = ?', // Specify which item to update
whereArgs: [item.id],
);
}
}
void main() async {
// Illustrative main. In a Flutter app, you'd call:
// final dbHelper = DatabaseHelper();
// // Assume item with id 1 exists
// var updatedItem = Item(id: 1, name: 'Milk', quantity: 3);
// int count = await dbHelper.updateItem(updatedItem);
// print('Updated $count item(s).');
print('Item update logic defined in DatabaseHelper.');
}
Sletning af data
Brug metoden delete til at fjerne poster fra din database. Ligesom ved update angiver du tabelnavnet og en where-klausul med whereArgs for at angive, hvilke poster der skal fjernes.
Denne metode returnerer antallet af slettede rækker.
import 'package:sqflite/sqflite.dart';
import 'package:path/path.dart';
// Item class (for self-containment)
class Item {
final int? id; final String name; final int quantity;
Item({this.id, required this.name, required this.quantity});
Map<String, dynamic> toMap() { return {'id': id, 'name': name, 'quantity': quantity}; }
static Item fromMap(Map<String, dynamic> map) { return Item(id: map['id'], name: map['name'], quantity: map['quantity']); }
@override
String toString() { return 'Item(id: $id, name: $name, quantity: $quantity)'; }
}
class DatabaseHelper {
static final DatabaseHelper _instance = DatabaseHelper._internal();
static Database? _database;
factory DatabaseHelper() { return _instance; }
DatabaseHelper._internal();
Future<Database> get database async { if (_database != null) return _database!; _database = await _initDatabase(); return _database!; }
Future<Database> _initDatabase() async {
String path = await getDatabasesPath();
String dbPath = join(path, 'item_database.db');
return await openDatabase(dbPath, version: 1,
onCreate: (db, version) async {
await db.execute('''
CREATE TABLE items(id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, quantity INTEGER)
''');
},
);
}
Future<int> deleteItem(int id) async {
final db = await database;
return await db.delete(
'items',
where: 'id = ?',
whereArgs: [id],
);
}
}
void main() async {
// Illustrative main. In a Flutter app, you'd call:
// final dbHelper = DatabaseHelper();
// // Assume item with id 1 exists
// int count = await dbHelper.deleteItem(1);
// print('Deleted $count item(s).');
print('Item deletion logic defined in DatabaseHelper.');
}
Quiz om SQLite-handlinger
Forestil dig en items-tabel med kolonnerne id (INTEGER), name (TEXT) og quantity (INTEGER).
Hvilken sqflite-metode vil du bruge til at hente alle elementer, hvor antallet er større end 10?
Opsamling: SQLite og `sqflite`
Godt gået! Du har lært det grundlæggende i at integrere SQLite i din Flutter-app ved hjælp af pakken sqflite.
Vigtige pointer:
- SQLite er en letvægts, lokal, relationel database.
- Pakken
sqfliteleverer Dart-API'er til SQLite. - En
DatabaseHelper-klasse samler databasehandlinger som oprettelse, åbning og administration af tabeller. - Du kan udføre standardhandlingerne CRUD (Create, Read, Update, Delete) ved hjælp af metoderne
insert,query,updateogdelete. - Brug af en datamodelklasse (som
Item) gør det nemmere at kortlægge data mellem Dart-objekter og databasens rækker.
Dette er vigtig viden, når du skal bygge robuste Flutter-apps med lokal, vedvarende datalagring!
Lær Dart med en AI-underviser — gratis
Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.
- Kurser
- 22
- Lektioner
- 88
Ofte stillede spørgsmål
Er lektionen “Integration af SQLite-databaser” gratis?
Ja — alle 3 lektioner i læringssporet Mobiludvikling med Flutter, inklusive “Integration af SQLite-databaser”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Mobiludvikling med Flutter-kurset indeholder 4 lektioner i alt.
Hvad lærer jeg i “Integration af SQLite-databaser”?
Integrer SQLite-databaser i Deres Flutter-app ved hjælp af `sqflite`-pakken til struktureret og relationel datalagring. Du øver dig i Mobiludvikling med Flutter med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.
Skal jeg have erfaring for at begynde på Mobiludvikling med Flutter?
Der kræves ingen tidligere erfaring. Mobiludvikling med Flutter på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 2 af 4.
Hvor lang tid tager lektionen “Integration af SQLite-databaser”?
De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.
Kan jeg skrive og køre kode i denne Mobiludvikling med Flutter-lektion?
Ja. Alle Mobiludvikling med Flutter-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.
Alle lektioner i dette kursus
- Shared Preferences til data
- Integration af SQLite-databaser
- Filhåndteringsoperationer
- Hive og lokal NoSQL-lagring