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.

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

Para 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.

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.

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

Para 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.