Xamarin Forms - Usando SQLite com MVVM

Abra o VS 2017 Community e clique em New Project e a seguir escolha Cross Platform -> Mobile App (Xamarin.Forms) e informe o nome PedidoApp:

A seguir selecione a Plataforma, eu marquei somente Android, e escolha a estratégia de compartilhamento que será .NET Standard.

Pronto nosso projeto já esta criado. ( Atualmente(08/2018) a versão mais atual estável é a 3.1.0)

Para organizar nosso projeto vamos criar as seguintes pastas via menu Project-> New Folder;

Vamos agora via menu Tools e a opção Manage Nuget Packages for Solution incluir os pacotes nuget usados em nosso projeto:

Clique na guia Browse e a seguir localize e instale em todos os projetos os seguinte pacotes :

Ao final deveremos ter as as seguintes dependêncais em nosso projeto .NET Standard :

Vamos definir o nosso modelo de domínio representado pela classe Pedido na pasta Models com o seguinte código:

Neste código estamos mapeando a entidade Pedido para a tabela Pedidos no banco de dados SQLite, e, definindo o campo Id como chave primária auto-incremental na tabela Pedidos.

Vamos definir a camada de acesso a dados criando a classe DatabaseHelper na pasta Helpers.

Nesta classe vamos definir a conexão com o SQLite e o nome do banco de dados que vamos criar.

Para simplificar o nosso código vamos usar a biblioteca chamada PCL Storage através da qual podemos usar o compartlhamento de arquivos para todas as plataformas sem ter que escrever código separado para cada plataforma.

A PCL Storage fornece um conjunto consistente de APIs IO para arquivos locais para Android, iOS , Windows Store e Windows Phone tornando mais simples o tratamento de arquivos no ambiente multiplataforma.

Nesta classe vamos definir todos os métodos para realizar o acesso e a persistência dos dados no SQLite.

using PCLExt.FileStorage;
using PCLExt.FileStorage.Folders;
using PedidoApp.Models;
using SQLite;
using System.Collections.Generic;
using System.Linq;

namespace PedidoApp.Helpers
{
    public class DatabaseHelper
    {
        //defina uma conexao e o  nome do banco de dados
        static SQLiteConnection sqliteconnection;
        public const string DbFileName = "PedidosDB.db";

        public DatabaseHelper()
        {
            //cria uma pasta base local para o dispositivo
            var pasta = new LocalRootFolder();
            //cria o arquivo
            var arquivo = pasta.CreateFile(DbFileName, CreationCollisionOption.OpenIfExists);
            //abre o BD
            sqliteconnection = new SQLiteConnection(arquivo.Path);
            //cria a tabela no BD
            sqliteconnection.CreateTable<Pedido>();
        }

        //Pegar todos os dados  
        public List<Pedido> GetAllPedidosData()
        {
            return (from data in sqliteconnection.Table<Pedido>()
                    select data).ToList();
        }

        //Pegar dados especifico por id
        public Pedido GetPedidoData(int id)
        {
            return sqliteconnection.Table<Pedido>().FirstOrDefault(t => t.Id == id);
        }

        // Deletar todos os dados
        public void DeleteAllPedidos()
        {
            sqliteconnection.DeleteAll<Pedido>();
        }

        // Deletar um dado especifico por id
        public void DeletePedido(int id)
        {
            sqliteconnection.Delete<Pedido>(id);
        }

        // Inserir dados
        public void InsertPedido(Pedido pedido)
        {
            sqliteconnection.Insert(pedido);
        }

        // Atualizar dados
        public void UpdatePedido(Pedido pedido)
        {
            sqliteconnection.Update(pedido);
        }
    }
}

Agora vamos usar os recursos da FluentValidation e definir a validação dos dados em nossa aplicação. Para isso vamos criar classe PedidoValidator na pasta Validator com o código abaixo:

Estamos validando as propriedades Titulo, Link, Preco e Descricao. Definimos também dois métodos para validação do Preco, PrecoMaiorQueZero, e, para verificar se a string esta vazia : ValidateStringEmpty.

Na pasta Services vamos criar os serviços usados na aplicação. Para isso vamos definir as interfaces dos serviços e a seguir sua implementação.

Vamos começar com a definição do repositório usado na aplicação criando a interface IPedidoRepository :

using PedidoApp.Helpers;
using PedidoApp.Models;
using System.Collections.Generic;

namespace PedidoApp.Services
{
    //implementa o repositorio
    public class PedidoRepository : IPedidoRepository
    {
        DatabaseHelper _databaseHelper;
        public PedidoRepository()
        {
            _databaseHelper = new DatabaseHelper();
        }

        public void DeleteAllPedidos()
        {
            _databaseHelper.DeleteAllPedidos();
        }

        public void DeletePedido(int pedidoID)
        {
            _databaseHelper.DeletePedido(pedidoID);
        }

        public List<Pedido> GetAllPedidosData()
        {
            return _databaseHelper.GetAllPedidosData();
        }

        public Pedido GetPedidoData(int pedidoID)
        {
            return _databaseHelper.GetPedidoData(pedidoID);
        }

        public void InsertPedido(Pedido pedido)
        {
            _databaseHelper.InsertPedido(pedido);
        }

        public void UpdatePedido(Pedido pedido)
        {
            _databaseHelper.UpdatePedido(pedido);
        }
    }
}

Nesta implementação do padrão repositório estamos usando uma instância da nossa camada de acesso a dados para ter acesso e persistir os dados. Centralizamos assim nesta classe todo o acesso a dados.

Agora vamos definir o serviço de mensagens usado na aplicação. Crie a interface IMessageService com o código abaixo:

Esses métodos serão usados para exibir mensagens usando a classe DisplayAlert. Para implementar esta interface crie a classe MessageService :

A implementação obtém a página atual do topo da pilha de navegação da aplicação : PedidoApp.App.Current e usa a classe DisplayAlert() para exibir uma mensagem.

Para concluir vamos definir o serviço de navegação criando a interface INavigationService :

Na interface definimos os métodos para navegar entre as páginas da aplicação.

Na classe NavigationService vamos implementar esta interface conforme a seguir:

Para concluir essa etapa vamos criar na pasta Util a classe CurrencyConverter cujo código temos a seguir:

using System;
using System.Globalization;
using System.Text.RegularExpressions;
using Xamarin.Forms;

namespace PedidoApp.Util
{
    /// <summary>
    /// Conversor para ser usado em campos Entry com máscara para moeda
    /// <para>A propriedade vinculada deve ser to tipodecimal, e tem que invocar a
    /// o evento PropertyChangedEventArgs sempre que seu valor for alterado
    /// de forma que o comportamento da mascara seja mantido.</para>
    /// </summary>
    public class CurrencyConverter : IValueConverter
    {
        public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
        {
            //implementação para notação 000.00
            //return Decimal.Parse(value.ToString()).ToString("C");
            //implementação local pt-br 000,00
            NumberFormatInfo nfi = new CultureInfo("pt-BR").NumberFormat;
            return Decimal.Parse(value.ToString()).ToString("C", nfi);
        }

        public object ConvertBack(object value,Type targetType,object parameter,CultureInfo culture)
        {
            string valueFromString = Regex.Replace(value.ToString(), @"\D", "");

            if (valueFromString.Length <= 0)
                return 0m;

            long valueLong;
            if (!long.TryParse(valueFromString, out valueLong))
                return 0m;

            if (valueLong <= 0)
                return 0m;

            return valueLong / 100m;
        }
    }
}

Nessa classe convertemos os valores do preço do pedido informados via view Entry para o formato string onde implementamos a notação da moeda Real (R$).

Na próxima parte to artigo vamos registrar os serviços e definir as Views e as ViewModels da nossa aplicação.

"Jesus respondeu, e disse-lhe: Se alguém me ama, guardará a minha palavra, e meu Pai o amará, e viremos para ele, e faremos nele morada."
João 14:23