easy_comp 0.0.6

Componentes Feitos mais para uso pessoal.

Componentes

1. BaseWidget
2. BasefulWidget
3. BaseState
4. ValidatorUtil
5. FirebaseFirestoreRepository

Instalação

1. Adicione a ultima versão ao arquivo pubspec.yaml (e rode 'dart pub get');

dependencies:
    easy_comp: ^0.0.6

2. Importe o pacote para usar no seu App Flutter

import 'package:easy_comp/easy_comp.dart';

Modo de usar

• Usando componente BaseWidget em um StatelessWidget

import 'package:flutter/material.dart';
import 'package:easy_comp/easy_comp.dart';

class EasyCompTeste extends BaseWidget {
  EasyCompTeste({Key? key});

  @override
  Widget builder(BuildContext context, BoxConstraints constrains) {
    return Container(
      child: Center(
        child: Text("Usando BaseWidget"),
      ),
    );
  }
}

• Usando componente BasefulWidget em um StatefulWidget

import 'package:flutter/material.dart';
import 'package:easy_comp/easy_comp.dart';

class EasyCompTeste extends BasefulWidget {
  EasyCompTeste({Key? key});
  @override
  _EasyCompTesteState createState() => _EasyCompTesteState();
}

class _EasyCompTesteState extends BasefulWidgetState<EasyCompTeste> {
  @override
  Widget builder(BuildContext context, BoxConstraints constrains) {
    return Container(
      child: Center(
        child: Text("Usando BaseWidgetFull"),
      ),
    );
  }
}

• Usando componente BaseState em um StatefulWidget

import 'package:easy_comp/easy_comp.dart';
import 'package:easy_comp/src/testes/provider_basestate.dart';
import 'package:flutter/material.dart';

class TesteBaseState extends StatefulWidget {
  const TesteBaseState({super.key});
  @override
  BaseState<TesteBaseState, ProviderBaseState> createState() => _TesteBaseStateState();
}

class _TesteBaseStateState extends BaseState<TesteBaseState, ProviderBaseState> {
  // Contem a variavel provider para pegar os dados do ProviderBaseState;

  @override
  void onInit() {
    // onInit é o InitState
    super.onInit();
    debugPrint(provider.titulo);

    provider.titulo = "Mudando";
  }

  @override
  void onResume() {
    // onResume é após o carregamendo da tela para buscar no servidor...
    super.onResume();
    provider.getDadosApi();
  }

  @override
  Widget build(BuildContext context) {
    return Text(provider.titulo);
  }
}

• Usando componente FirebaseFirestoreRepository

import 'dart:developer';

import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:easy_comp/easy_comp.dart';
import 'package:easy_comp/src/utils/utils.dart';

/// Primeiro você cria seu Model e Repositorio.

class TesteModel {
  String id = "";
  String nome = "";
  String categoria = "INITIAL";
  TesteModel({
    required this.id,
    required this.nome,
    this.categoria = "INITIAL",
  });

  TesteModel.fromDocument(DocumentSnapshot<Map<String, dynamic>> doc) {
    final map = doc.data()!;
    id = getMap<String>(key: "id", map: map, retur: doc.id);
    nome = getMap<String>(key: "nome", map: map, retur: "");
    categoria = getMap<String>(key: "categoria", map: map, retur: "INITIAL");
  }

  TesteModel.fromJson(Map<String, dynamic> map, String? id) {
    this.id = id ?? (getMap<String>(key: "id", map: map, retur: ""));
    nome = getMap<String>(key: "nome", map: map, retur: "");
    categoria = getMap<String>(key: "categoria", map: map, retur: "INITIAL");
  }

  static Map<String, dynamic> toJson(TesteModel model) => {
        "id": model.id,
        "nome": model.nome,
        "categoria": model.categoria,
      };

  @override
  String toString() => 'Teste(id: $id, nome: $nome, categoria: $categoria)\n';
}

class TesteRepository extends FirebaseFirestoreRepository<TesteModel> {
  /// Esse é um repositorio teste, mostrando com se usa a lib FirebaseFirestoreRepository<TesteModel>()\n
  ///
  /// Example:
  /// ```dart
  /// class TesteRepository extends FirebaseFirestoreRepository<TesteModel> {
  ///   TesteRepository()
  ///    : super(
  ///        collectionPath: 'BAIRROS',
  ///        firestore: FirebaseFirestore.instance,
  ///        fromJson: TesteModel.fromJson,
  ///        toJson: TesteModel.toJson,
  ///      );
  ///   @override
  ///   CollectionReference<TesteModel> get collection => super.collection;
  ///
  ///   Future<List<TesteModel>> todosByCategoria() async {
  ///     final lista = await collection.where("categoria", isEqualTo: "INITIAL").get().then((value) => value.docs.map((e) => e.data()).toList());
  ///     return lista;
  ///   }
  /// }
  ///
  /// void main() {
  ///   final repo = TesteRepository();
  ///   final todos = await repo.buscarTodos();
  ///   log(todos.toString());
  ///
  ///   final todosCat = await repo.todosByCategoria();
  ///   log(todosCat.toString());
  /// }
  /// ```
  TesteRepository()
      : super(
          collectionPath: 'BAIRROS',
          firestore: FirebaseFirestore.instance,
          fromJson: TesteModel.fromJson,
          toJson: TesteModel.toJson,
        );

  /// Com essa referencia pode criar novas funcões personalizas para seu Modelo.
  @override
  CollectionReference<TesteModel> get collection => super.collection;

  /// Exemplo de função personalizada
  /// Vamos criar uma que retorna todos com a categoria INITIAL.
  Future<List<TesteModel>> todosByCategoria() async {
    final lista = await collection.where("categoria", isEqualTo: "INITIAL").get().then((value) => value.docs.map((e) => e.data()).toList());
    return lista;
  }
}

void main() async {
  final repo = TesteRepository();
  final todos = await repo.buscarTodos(
    descending: false,
    limit: 10,
    orderBy: "nome",
    where: QueryConstraint(field: "categoria", op: QueryOperation.isEqualTo, value: "INITIAL"),
    // Ou
    whereList: [
      QueryConstraint(field: "categoria", op: QueryOperation.isEqualTo, value: "INITIAL"),
      QueryConstraint(field: "nome", op: QueryOperation.isGreaterThanOrEqualTo, value: "Teste"),
    ],
  );
  log(todos.toString());
}