RESTful Bookmarks Jersey + Spring

Exemplo de aplicação para salvar links, onde a interface utiliza AngularJS + Twitter Bootstrap e o lado do servidor utilizado o Jersey integrado com o Spring para disponibilizar um serviço de dados RESTful, que aceita uma comunicação JSON ou XML.

Utilizado neste projeto

• Ambiente de desenvolvimento

  • Maven 3
  • Eclipse Juno JEE
  • Apache Tomcat 6.x
  • Java 1.6+

• Cliente

  • AngularJS 1.0.1
  • Twitter Bootstrap 2.0.4

• Servidor

  • Jersey (User Guide)
  • Spring
  • Hibernate
  • HSQLDB
  • Jetty para testes, gerenciado pelo Maven

Quanto as versões no Servidor:

Verificar o arquivo pom.xml

Um projeto que auxiliou neste projeto foi o Wine Cellar Java, que é um exemplo de uso do Jersey em uma webapp Java. Além do post do Christophe Coenraets - Sample Application with Angular.js e Using Backbone.js with a RESTful Java Back-End.

Montando o ambiente local para uso desse projeto

O projeto disponibilizado no github, não possui nenhum arquivo para incluí-lo diretamente no Eclipse. Então após baixar o projeto no seu computador local.

Conforme especificado anteriormente, os itens citados do ambiente de desenvolvimento serão necessários.

Feito o download/clone do projeto para a sua máquina local, realize o respectivos passos a seguir:

1. Vá até o diretório do projeto

2. Execute os comandos em sequência:

   mvn compile

   mvn eclipse:eclipse

3. Importe o projeto no Eclipse

   Atenção:

    É necessário ter a variável M2_REPO configurada nas 
    variáveis do ClassPath, apontando para o diretório 
    do .m2/repository do Maven
    
    Lembre-se também de ter adicionado o Apache Tomcat 6.x
    ao Runtime Environments nas preferencias do seu Eclipse
   

4. Feito isso, o projeto está pronto para ser executado no Eclipse. Caso queira gerar o .war do projeto utilize o comando

   mvn clean install

Quanto ao RESTful do projeto

A definição do método a ser executado é definido no cabeçalho da requisição enviada para o servidor.

• GET - recupera 1 ou mais bookmarks
  • .../api/bookmarks/ - lista todos os bookmarks
  • .../api/bookmarks/{id} - retorna o respectivo bookmark pelo seu ID
  • .../api/bookmarks/search/{name} - retorna uma lista dos bookmarks que contém o respectivo nome
• POST - insere um novo
  • .../api/bookmarks/ - enviado via post
• PUT - atualiza um existente
  • .../api/bookmarks/{id} - enviado via post
• DELETE - remove 1 bookmark pelo ID
  • .../api/bookmarks/{id}

Archetype do Maven que gerou a estrutura inicial do projeto

mvn archetype:generate \
    -DarchetypeGroupId=org.apache.maven.archetypes \
    -DarchetypeArtifactId=maven-archetype-webapp \
    -Dversion=1.0 \
    -DgroupId=com.erkobridee.restful.bookmarks.jerseyspring \
    -DartifactId=restful-bookmarks-jerseyspring

Alterações

• v1
  • versão inicial funcional
• v2 - versão atual

  • Atualização do Spring para versão 3.1.1.RELEASE

  • Atualização das configurações

  • Inclusão do Jetty para teste da aplicação diretamente pelo Maven

    mvn jetty:run - a aplicação irá executar na url: http://localhost:9090

  • Inclusão de testes de Integração

    mvn clean integration-test - durante a fase de teste de integração a aplicação irá testar a url: http://localhost:8080/restful-bookmarks-jerseyspring/