Ideias de implementação

[graciano]

A ideia aqui é colocar tudo que for discutido e especulado sobre o projeto: frameworks, libs, como implementar tal coisa etc.

Inicialmente começamos com o que tem abaixo:
Itens a serem discutidos:
- parâmetros padrão da URI (offset e order by)
- validação dos campos de cada request
- LinkFactory e Providers (ver a questão de como serão mapeados os Resources)

[graciano]

Uma ideia legal é colocar o status http na response, não sei se eles cobram isso, mas faz muito sentido.. tipo assim

    @GET
    @Path("licitacoes/")
    public Response printMessage() {
        //...
        String result = databaseData.build();
        return Response.status(200).entity(result).build();
    }

[graciano]

Pra pegar annotations:

    methods = new HashMap<String, Method>();
    for (Method method : getClass().getMethods()) {
        if (method.isAnnotationPresent(Links.class)) {
            Links linksAnnotation = method.getAnnotation(Links.class);
            methods.put(linksAnnotation.resource(), method);
            }
    }

[graciano]

Xiao disse para estudarmos spring. É MVC, já tem suporte a HAL, providers de JSON baseados nos nossos models e usa o swagger para supeorte à documentação. Me parece promissor.

[graciano]

@pedrobarros dá uma olhada nas issues :P

[graciano]

falta decidir se usaremos Gradle ou Maven. Dizem que Gradle é melhor e mais fácil de usar. Voto nele.

[graciano]

Uma ideia: ao invés de um Request usar métodos do tipo ResourceList, ele retornar algum outro tipo, que pode ser uma mmensagem de erro com um status http de erro 403 bad request ou 500 ou whatever ou um ResourceList com status ok 200.

[graciano]

Coisas sobre a implementação do swagger:

• existe um repo de integração com o spring
• recomendo usarmos o swagger padrão pra um servlet, que poderá ser usado caso passemos a usar spring, de qualquer maneira.

lado ruim tem que usar maven ou gradle. Voto pra usar gradle só por ter ouvido falar que é mais fácil.
obs: swagger usa aquela ideia dada pelo @pedrobarros de colocar os parâmetros nos argumentos.

Fonte de informações aqui.

[graciano]

Para sincronizar o fork de compras usar estes links:

• configuração inicial
• passo a passo pra sincronizar