Tentando rodar a api no eclipse

[emerson-diego]

Olá pessoal, acho este projeto muito legal e hoje tirei 2 horas para tentar rodar a api localmente. Como tive dificuldades, seguem meu feedback para apreciação e talvez melhorar a documentação.

1. O projeto repasse-server não tinha um .project. Desta forma o eclipse não reconhecia. Resolvi criando este arquivo com base em um outro projeto. Deu certo.

2. A configuração com o banco de dados foi bem fácil. Já tinha o wildfly configurado na minha máquina.

3. Vi que precisaria dar uma carga dos dados para minha base local do mysql. Tive muita dificuldade de rodar o endpoint que promete rodar a carga.

a) Pela documentação na página inicial, diz-se que basta fazer: $ curl -X POST http://localhost:8080/repasse/rest/carga/2015/1

No entanto, depois de mexer no projeto, descobri que a invocação correta seria: http://localhost:8080/rest/carga/transferencia/2015/1/

b) Mesmo depois de descobrir a url, verifiquei que existe uma restrição de execução destes endpoints, configurado no web.xml. Descobri olhando o projeto. Acho que poderia estar documentado. Consegui executar o endpoint de transferência de dados documentando esta configuração no arquivo.

4. Nesta parte, o código do endpoint de carga começou a ser executado, mas começou a dar problemas:

Entre eles, na linha 103 da classe ArquivoTransfUtils. (Files.delete(Paths.get(tempZip.getPath()));) . Penso que se trata de algum problema relacionado ao SO que usei. No caso foi o Windows.

5. Outros erros aconteceram que me incomodaram:

a) Estou obtendo o seguinte erro ao baixar o projeto no eclipse: Description Resource Path Location Type
Plugin execution not covered by lifecycle configuration: com.sebastian-daschner:jaxrs-analyzer-maven-plugin:0.14:analyze-jaxrs (execution: default, phase: process-test-classes) pom.xml /repasse-server line 143 Maven Project Build Lifecycle Mapping Problem

b) Está dando erro ao rodar os testes. Diz que os testes não são executáveis.

É isso, espero ter contribuído de alguma forma. Também espero contribuir mais com este projeto, mas gostaria que melhorassem a documentação.

[jesuino]

Olá Emerson.

Ótimo feedback. Agradecemos imensamente. Vou comentar cada ponto:

1. O projeto repasse-server não tinha um .project. Desta forma o eclipse não reconhecia. Resolvi criando este arquivo com base em um outro projeto. Deu certo.

Você precisa importar como "Existing maven project" e apontar para o diretório do Repasse Server

3.a: Obrigado, faz tempo que o README.md foi escrito e realmente está bastante desatualizado.
3.b Idem 3.a.

4. Infelizmente nunca tive a oportunidade de rodar no Windows. Verificarei esse problema em breve em uma máquina virtual. Criei o Verificar execução do projeto on Windows #202.

5.a Essa API foi adicionada recentemente. Você pode simplesmente remover o plugin no pom.xml ou configurar o eclipse para ignorar esse erro. De qualquer forma criei um issue para melhorar isso. VEja #201

5.b Vou verificar também. Uma forma de contornar isso é fazer o build pela linha de comando usando o -DskipTests.

É isso, espero ter contribuído de alguma forma. Também espero contribuir mais com este projeto, mas gostaria que melhorassem a documentação.

Iremos melhorar sim, agradecemos a abertura do issue. Vou manter ele aberto por enquanto.

[emerson-diego]

Obrigado Jesuíno pelo rápido feedback.