Objetivo.Cursinho.SGA.Cliente 1.2.0

Curso Objetivo - Cliente SGA (Sistema de Gestão Acadêmica)

Pacote para facilitar o uso da API para acessar dados e arquivos, referentes aos dados de acordo com seu nível de acesso.

Último release

Release 1.2.0 (2022-11-13)

Features

• Atualizando gitignore.
• Simplificando build e publish.
• Complementando a documentação.
• Incluindo origem e tempo de expiração para criação do token.

Configuração

Para pode usar os recursos do pacote, são necessárias 3 (três) configurações:

• URL: (OBRIGATÓRIO) Informar a URL da API que irá ser carregada.
• Chave Pública: (OBRIGATÓRIO) Informar a chave pública de acesso a API.
• Autorização: (OBRIGATÓRIO) Informar a autorização de acesso a API que vai influênciar os recursos que você terá acesso.

É um Singleton, então só precisa ser atribuído um única vez dependendo da sua aplicação:

Objetivo.Cursinho.SGA.Cliente.Config.Url = "https://api.site.com.br/pasta/";
Objetivo.Cursinho.SGA.Cliente.Config.ChavePublica = "160MYEAto65UhwwrJsTtCBgVpwpj499CML4rK7y1bFpZLMudMk";
Objetivo.Cursinho.SGA.Cliente.Config.Autorizacao = "73oo41d94iPEQmeyScA5ApnthwH77b88pidsvxsHOKpMEtZGpz";

Chamando API

Um exemplo de teste de obter os dados da API.

using Xunit;
using System.Threading.Tasks;
using Objetivo.Cursinho.SGA.Cliente.Servicos;
using Objetivo.Cursinho.SGA.Cliente.ObjetosDeValor;

namespace Seu.Projeto.Csharp.Teste
{
    public class SobreServTeste
    {
        [Fact]
        public async Task Obter()
        {
            SobreServ serv = new();
            Sobre dados = await serv.ObterAsync();

            Assert.True(serv.EhValido());
            Assert.NotNull(dados);
        }
    }
}

Algumas chamadas precisam de parâmetros, e neste caso, há classes para mandar esses valores. Nesse exemplo, vou usar o serviço de filtro de unidades.

using Xunit;
using System.Linq;
using System.Threading.Tasks;
using System.Collections.Generic;
using Objetivo.Cursinho.SGA.Cliente.Servicos;
using Objetivo.Cursinho.SGA.Cliente.Entidades;
using Objetivo.Cursinho.SGA.Cliente.Comandos.UnidadeCmds;

namespace Seu.Projeto.Csharp.Teste
{
    public class UnidadeServTeste
    {
        [Fact]
        public async Task Filtrar_unidade_valido()
        {
            UnidadeServ serv = new();
            FiltrarCmd cmd = new()
            {
                Maximo = 1,
                Pagina = 1
            };
            Unidade[] dados = await serv.FiltrarAsync(cmd);
            
            Assert.True(dados.Any());
            Assert.True(serv.EhValido());
        }

        [Fact]
        public async Task Filtrar_unidade_invalido()
        {
            UnidadeServ serv = new();
            FiltrarCmd cmd = new()
            {
                Unidades = new List<string>() { "-1" },
                Maximo = 1,
                Pagina = 1
            };

            Unidade[] dados = await serv.FiltrarAsync(cmd);
            Assert.False(dados.Any());
            Assert.False(serv.EhValido());
        }
    }
}