Cours React Native · Module 9: Stockage des données

expo-sqlite - Base de données

2 min de lecture ·
Dans cette leçon3

Pour des données relationnelles complexes, utilise SQLite !

Installation

npx expo install expo-sqlite

Opérations de base

import * as SQLite from 'expo-sqlite';

// Ouvrir/créer la base de données
const db = await SQLite.openDatabaseAsync('atlantis.db');

// Créer une table
await db.execAsync(`
  CREATE TABLE IF NOT EXISTS treasures (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    value INTEGER DEFAULT 0,
    found_at TEXT
  );
`);

// INSERT
await db.runAsync(
  'INSERT INTO treasures (name, value) VALUES (?, ?)',
  ['Golden Pearl', 500]
);

// SELECT tous
const treasures = await db.getAllAsync<{ id: number; name: string; value: number }>(
  'SELECT * FROM treasures'
);

// SELECT un seul
const treasure = await db.getFirstAsync<{ name: string }>(
  'SELECT name FROM treasures WHERE id = ?',
  [1]
);

// UPDATE
await db.runAsync(
  'UPDATE treasures SET value = ? WHERE id = ?',
  [1000, 1]
);

// DELETE
await db.runAsync('DELETE FROM treasures WHERE id = ?', [1]);

Service de base de données

class TreasureDB {
  private db: SQLite.SQLiteDatabase | null = null;

  async init() {
    this.db = await SQLite.openDatabaseAsync('atlantis.db');
    await this.db.execAsync(`
      CREATE TABLE IF NOT EXISTS treasures (
        id INTEGER PRIMARY KEY AUTOINCREMENT,
        name TEXT NOT NULL,
        value INTEGER DEFAULT 0,
        rarity TEXT DEFAULT 'common'
      );
    `);
  }

  async getAll() {
    return this.db?.getAllAsync('SELECT * FROM treasures ORDER BY value DESC');
  }

  async create(name: string, value: number, rarity: string) {
    const result = await this.db?.runAsync(
      'INSERT INTO treasures (name, value, rarity) VALUES (?, ?, ?)',
      [name, value, rarity]
    );
    return result?.lastInsertRowId;
  }

  async delete(id: number) {
    await this.db?.runAsync('DELETE FROM treasures WHERE id = ?', [id]);
  }
}

export const treasureDB = new TreasureDB();
Code de cette leçon : App.tsx
import React, { useEffect, useState } from 'react';
import { View, Text, FlatList, StyleSheet } from 'react-native';
import * as SQLite from 'expo-sqlite';

type Treasure = { id: number; name: string; value: number };

// Service de base de données pour les trésors de l'Atlantide
class TreasureDB {
  private db: SQLite.SQLiteDatabase | null = null;

  async init() {
    this.db = await SQLite.openDatabaseAsync('atlantis.db');
    // TODO : créer la table via this.db.execAsync avec la requête :
    //   CREATE TABLE IF NOT EXISTS treasures (
    //     id INTEGER PRIMARY KEY AUTOINCREMENT,
    //     name TEXT NOT NULL,
    //     value INTEGER DEFAULT 0
    //   );

  }

  async create(name: string, value: number) {
    // TODO : insérer une ligne via this.db.runAsync avec les paramètres (?, ?) :
    //   'INSERT INTO treasures (name, value) VALUES (?, ?)', [name, value]

  }

  async getAll(): Promise<Treasure[]> {
    // TODO : retourner toutes les lignes via this.db.getAllAsync<Treasure>(
    //   'SELECT * FROM treasures ORDER BY value DESC')
    return [];
  }
}

const treasureDB = new TreasureDB();

export default function App() {
  const [treasures, setTreasures] = useState<Treasure[]>([]);

  useEffect(() => {
    (async () => {
      await treasureDB.init();
      await treasureDB.create('Perle Dorée', 500);
      setTreasures(await treasureDB.getAll());
    })();
  }, []);

  return (
    <View style={styles.container}>
      <Text style={styles.title}>Trésors de l'Atlantide</Text>
      <FlatList
        data={treasures}
        keyExtractor={(item) => String(item.id)}
        renderItem={({ item }) => (
          <Text style={styles.item}>{item.name} - {item.value}</Text>
        )}
      />
    </View>
  );
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    padding: 20,
    paddingTop: 60,
    backgroundColor: '#1a5276',
  },
  title: {
    fontSize: 22,
    color: '#fff',
    fontWeight: '700',
    marginBottom: 16,
  },
  item: {
    fontSize: 16,
    color: '#aed6f1',
    paddingVertical: 8,
  },
});

Entrées de la documentation utilisées dans cette leçon

Tu as repéré une erreur dans cette leçon ?

Teste tes connaissances

Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.

  1. 1. Comment installer expo-sqlite ?

  2. 2. Quand utiliser execAsync plutôt que runAsync ?

Voici 2 des 6 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Tri horizontal

    Ordonne l'ouverture de la base de données :

  • Tri vertical

    Ordonne la création de la table :

  • Clique dans l'ordre

    Clique sur les éléments de l'INSERT :

  • Éditeur de code

    Complète le code du Database Service.

  1. QuestionInstaller SQLite
  2. Remets dans l'ordreopenDatabaseAsync
  3. QuestionexecAsync
  4. Remets dans l'ordreCREATE TABLE
  5. QuestiongetAllAsync
  6. QuestiongetFirstAsync
  7. Clique dans l'ordrerunAsync INSERT
  8. QuestionParamètres de requête
  9. QuestionlastInsertRowId
  10. Exercice de codeTreasureDB
  11. Projet à envoyerProjet : Storage
  12. VidéoRésumé du module

Articles utiles