Class TransporteController

java.lang.Object

br.com.vantroba.bi.transporte.processamento.TransporteController

@Controller("/api/transporte")
public class TransporteController
extends Object

API REST de transporte: envio de XLS (Bearer), listagem e consulta pública de processamentos.

Constructor Summary

Constructors

Constructor	Description
TransporteController(ProcessamentoService processamentoService, ProcessamentoConsultaService consultaService)	Cria o controller REST de transporte.

Method Summary

Modifier and Type	Method	Description
io.micronaut.http.HttpResponse<byte[]>	baixarArquivo(Long id)	Faz o download do arquivo XLS original de um processamento.
ProcessamentoDetalheResponse	detalhe(Long id)	Retorna os detalhes de um processamento específico.
ProcessamentoListResponse	listar(int page, int size, String status)	Lista o histórico de processamentos de forma paginada, opcionalmente filtrado por status.
String	logs(Long id)	Retorna o conteúdo text/plain do arquivo de log de um processamento.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

TransporteController

public TransporteController(ProcessamentoService processamentoService,
 ProcessamentoConsultaService consultaService)

Cria o controller REST de transporte.

Parameters:

processamentoService - serviço de recebimento e agendamento de processamentos

consultaService - serviço de consulta e listagem de processamentos

Method Details

listar

@Get("/processamentos")
@Secured("isAnonymous()")
public ProcessamentoListResponse listar(@QueryValue(defaultValue="0")
 int page,
 @QueryValue(defaultValue="20")
 int size,
 @Nullable @QueryValue
 String status)

Lista o histórico de processamentos de forma paginada, opcionalmente filtrado por status.

Parameters:

page - índice da página (base zero; padrão 0)

size - quantidade de itens por página (padrão 20)

status - filtro opcional por status do processamento

Returns:

página de processamentos correspondente aos filtros

detalhe

@Get("/processamentos/{id}")
@Secured("isAnonymous()")
public ProcessamentoDetalheResponse detalhe(@PathVariable
 Long id)

Retorna os detalhes de um processamento específico.

Parameters:

id - identificador do processamento

Returns:

detalhes do processamento

logs

@Get(value="/processamentos/{id}/logs",
     produces="text/plain")
@Secured("isAnonymous()")
public String logs(@PathVariable
 Long id)

Retorna o conteúdo text/plain do arquivo de log de um processamento.

Parameters:

id - identificador do processamento

Returns:

conteúdo textual do log (pode estar vazio)

baixarArquivo

@Get("/processamentos/{id}/arquivo")
@Secured("isAnonymous()")
public io.micronaut.http.HttpResponse<byte[]> baixarArquivo(@PathVariable
 Long id)

Faz o download do arquivo XLS original de um processamento. Lê do backend conforme o modo de armazenamento (S3_FILE_STORAGE) — Postgres e/ou Garage.

Parameters:

id - identificador do processamento

Returns:

o arquivo .xlsx como anexo