[CC] [DBAPI] databaseClient.dart

// Importa bibliotecas.
import 'dart:async';
import 'package:path/path.dart';
import 'package:sqflite/sqflite.dart';
import '../models/dog.dart';

class DatabaseClient {
  // Objeto da classe database que será utilizado para comunicar com o BD.
  Database _db;

  // Método responsável por abrir a conexão com o BD e solicitara criação da
  // tabela na primeira execução.
  Future open() async {
    // Tenta executar a operação.
    try {
      String dbPath = join(await getDatabasesPath(), 'database.db');
      _db = await openDatabase(dbPath, version: 1, onCreate: this._create);
    }
    // Caso não consiga lança erro.
    catch (error) {
      throw Exception('Falha ao abrir o BD!');
    }
  }

  // Método responsável pro executar SQL para criar a tabela.
  Future _create(Database db, int version) async {
    // Tenta executar a operação.
    try {
      await db.execute("""
            CREATE TABLE dogs (
              id TEXT PRIMARY KEY,
              name TEXT,
              age INTEGER
            )""");
    }
    // Caso não consiga lança erro.
    catch (error) {
      throw Exception('Falha ao criar tabela no BD!');
    }
  }

  // Método responsável por inserir uma lista de objetos Dog no BD.
  Future insertDogs(List<Dog> dogs) async {
    // Tenta executar a operação.
    try {
      // Percorre cada elemento da lista recebida e chama método insert.
      await Future.forEach(dogs, (dog) async {
        await _db.insert('dogs', dog.toMap(),
            conflictAlgorithm: ConflictAlgorithm.replace);
      });
    }
    // Caso não consiga lança erro.
    catch (error) {
      throw Exception('Falha ao inserir lista de dados no BD!');
    }
  }

  // Método responsável por inserir um único objeto da classe Dog.
  Future insertDog(Dog dog) async {
    // Tenta executar a operação.
    try {
      // Chama método insert informando o objeto recebido, convertido para Map (JSON).
      await _db.insert('dogs', dog.toMap(),
          conflictAlgorithm: ConflictAlgorithm.replace);
    }
    // Caso não consiga lança erro.
    catch (error) {
      throw Exception('Falha ao inserir dado no BD!');
    }
  }

  // Método responsável por, dado um id, retornar um objeto Dog com os dados salvos
  // no banco para tal id.
  Future<Dog> getDog(String id) async {
    // Tenta executar a operação.
    try {
      final List<Map<String, dynamic>> maps =
          await _db.query('dogs', where: "id = ?", whereArgs: [id], limit: 1);

      // Se encontrou o registro retorna o objeto encontrado.
      if (maps.length > 0) {
        return Dog.fromMap(maps[0]);
      }
      // Caso não tenha econtrado retorna null.
      else {
        return null;
      }
    }
    // Caso não consiga lança erro.
    catch (error) {
      throw Exception('Falha ao obter dado no BD!');
    }
  }

  // Método responsável por obter uma lista com todos os dados armazenados no BD.
  Future<List<Dog>> getDogs() async {
    // Tenta executar a operação.
    try {
      final List<Map<String, dynamic>> maps = await _db.query('dogs');
      return List.generate(maps.length, (i) {
        return Dog.fromMap(maps[i]);
      });
    }
    // Caso não consiga lança erro.
    catch (error) {
      throw Exception('Falha ao obter lista de dados no BD!');
    }
  }

  // Método responsável por atualizar os dados de um registro no BD.
  Future updateDog(Dog dog) async {
    // Tenta executar a operação.
    try {
      _db.update(
        'dogs',
        dog.toMap(),
        where: "id = ?",
        whereArgs: [dog.id],
      );
    }
    // Caso não consiga lança erro.
    catch (error) {
      throw Exception('Falha ao atualizar dado no BD!');
    }
  }

  // Método responsável por deletar um registro do BD, dado um id.
  Future deleteDog(String id) async {
    // Tenta executar a operação.
    try {
      await _db.delete('dogs', where: "id = ?", whereArgs: [id]);
    }
    // Caso não consiga lança erro.
    catch (error) {
      throw Exception('Falha ao deletar dado no BD!');
    }
  }

  // Método responsável por executar SQL para remover todos os registros
  // da tabela Dogs.
  Future deleteAllDogs() async {
    // Tenta executar a operação.
    try {
      await _db.execute("""DELETE FROM dogs""");
    }
    // Caso não consiga lança erro.
    catch (error) {
      throw Exception('Falha ao deletar todos os dados do BD!');
    }
  }
}