Executando em Desenvolvimento

Para executar o Connector com o perfil de desenvolvimento basta:

  1. 1Abrir o terminal e navegar até a pasta em que o arquivo do Connector foi descompactado.
  2. 2Substituir os valores marcados com <…> por suas configurações e executar o comando abaixo.
COPIAR
CLIENT_ID=encrypted.<Seu client id> \
CLIENT_SECRET=encrypted.<Seu client secret> \
CAFFEINE_MAXIMUM_SIZE=200 \
CAFFEINE_EXPIRE_DURATION_MINUTES=30 \
SPRING_PROFILES_ACTIVE=development \
./guiabolso_connector_client_1.0.0/bin/application
avisoPara evitar problemas com interpretação de caracteres especiais em variáveis de ambiente, é sempre recomendado passar os valores entre 'aspas simples'.
Ex: CLIENT_SECRET='encrypted.[SEU_SECRET_AQUI]'

Você deverá ver uma mensagem no final do console parecida com a exibida abaixo, o que significa que a aplicação está executando e pronta para receber requests na porta 9000.

COPIAR
2020-03-27 12:59:10.797 [main] INFO o.e.jetty.server.AbstractConnector {} - Started
ServerConnector@496401ee{HTTP/1.1,[http/1.1]}{0.0.0.0:9000}
2020-03-27 12:59:10.798 [main] INFO org.eclipse.jetty.server.Server {} - Started @6964ms

As únicas configurações obrigatórias para esse perfil são o CLIENT_ID e o CLIENT_SECRET. Por padrão o Connector será executado em perfil de desenvolvimento e usará os seguintes valores como padrão:

  • CLIENT_ID OBRIGATÓRIO Client ID da sua credencial da API.
  • CLIENT_SECRET OBRIGATÓRIO Client Secret da sua credencial da API.
  • SPRING_PROFILES_ACTIVE OPCIONAL Por padrão: development.
  • DATAPACKAGES_PATH OPCIONAL Caminho absoluto do arquivo datapackage.yml.
  • CAFFEINE_MAXIMUM_SIZE OPCIONAL Máximo de entradas no cache. Por padrão: 1000.
  • CAFFEINE_EXPIRE_DURATION_MINUTES OPCIONAL Tempo em minutos de expiração após o dado ser adicionado no cache. Por padrão: 10 minutos.

Adicionando o Perfil Redis


Você pode adicionalmente usar um cache distribuído dentro do cache de nível hierárquico do Connector. Se ele não encontrar os dados dentro do Caffeine ele irá procurar no Redis. Para isso você precisará do redis instalado localmente na sua máquina e precisará obrigatoriamente do REDIS_ADDRESS e do REDIS_EXPIRE_DURATION_MINUTES definidos.

COPIAR
CLIENT_ID=encrypted.<Seu client id> \
CLIENT_SECRET=encrypted.<Seu client secret> \
CAFFEINE_MAXIMUM_SIZE=200 \
CAFFEINE_EXPIRE_DURATION_MINUTES=30 \
REDIS_ADDRESS=<Endereço do host redis, ex. redis://localhost:6379> \
REDIS_EXPIRE_DURATION_MINUTES=60 \
SPRING_PROFILES_ACTIVE=development,redis \
./guiabolso_connector_client_1.0.0/bin/application
avisoPara evitar problemas com interpretação de caracteres especiais em variáveis de ambiente, é sempre recomendado passar os valores entre 'aspas simples'.
Ex: CLIENT_SECRET='encrypted.[SEU_SECRET_AQUI]'
  • REDIS_ADDRESS OBRIGATÓRIO Endereço do servidor redis. Se estiver usando cluster, basta separar os endereços por vírgulas. Por padrão: redis://localhost:6379.
  • REDIS_EXPIRE_DURATION_MINUTES OBRIGATÓRIO Tempo em minutos de expiração após o dado ser adicionado no cache. Por padrão: 30 minutos.

Próximos passos

connector

AWS

Para executar o Connector com o perfil da AWS basta abrir o terminal e navegar até a pasta...

connector

GCP

Para executar o Connector com o perfil do GCP basta abrir o terminal e navegar até a pasta...

© GuiaBolso Finanças Correspondente Bancário e Serviços LTDA 2020