Sobre Esta Tarefa
O serviço da web JAX-RS precisa residir em um projeto com
o aspecto JAX-RS ativado.
Procedimento
- Na perspectiva Java EE, clique com o botão direito do mouse em seu projeto do aplicativo corporativo e selecione para abrir o assistente de projeto da web.
- No campo Nome,
digite um nome para seu novo projeto da web. Para
este tutorial, use JAXRS.
- Na seção Modelos de Projeto,
selecione o tipo de modelo da web que deseja usar: Para
esse tutorial, selecione Simples.
| Opção |
Descrição |
| Dojo Toolkit |
Configura o projeto para ter recursos do Dojo. Os recursos do Dojo podem estar no próprio projeto, em um projeto separado ou em um local remoto acessível via HTTP. |
| JavaServer Faces |
Ativa o projeto para ser implementado com recursos do JSF.
A configuração é fornecida para JSP ou Facelets. |
| Serviços REST |
Um projeto configurado para os Serviços REST com base no JAX-RS |
| Simples |
Isso cria um projeto da web básico. |
- Na seção
Modelo de programação, selecione o modelo de programação que deseja usar: Para
esse tutorial, selecione Java EE.
- Somente lado do cliente (HTML, JavaScript,...)
- Java EE
- OSGi
- Clique em Avançar para configurar seu novo projeto da web.
- Na página de implementação, na lista de opções de configuração
disponíveis, clique em Implementação para
abrir a página de configuração Implementação.
- No campo Tempo de Execução de Destino, selecione o WebSphere Application Server
que você instalou anteriormente no tutorial.
- No campo Versão do Módulo da Web, aceite
o padrão, que é automaticamente selecionado com base em qual WebSphere Application Server
você selecionou.
- No campo Associação do EAR, selecione Incluir
projeto em um EAR e assegure que JAXRSEAR seja
o nome do projeto EAR.
- Na seção Implementação, selecione Mudar Recursos. Na página Máscaras do projeto, selecione JAX-RS (REST Web Services), versão 2.0 e clique em OK.
- Na lista de opções de configuração
disponíveis, clique em Java para abrir a página de configuração Java.
- No campo
Pastas de Origens no Caminho de Construção, aceite o
diretório src padrão ou clique em Incluir
Pasta, Editar... ou Remover para
especificar uma pasta para seus arquivos de origem.
- No campo
Pasta de Saída Padrão:, especifique uma pasta
para seus arquivos de saída ou aceite o valor padrão (WebContent\WEB-INF\classes).
Importante: Se escolher uma pasta diferente de
WebContent\WEB-INF\classes para a pasta de saída padrão, a visualização de
problemas relatará um aviso:
O padrão para os problemas de incidência de raízes únicas é configurado para aviso. Para alterar essa configuração,
use a página
Filtros de validação para validador de estrutura do projeto:
- Clique em e, em seguida, no botão ... para Configurações.
- Na página Filtros de validação para validador de estrutura do projeto,
especifique o nível de severidade padrão. Os níveis de severidade disponíveis são Erro, Aviso
e Ignorar.
- Na lista de opções de configuração disponíveis, clique em Serviços
REST para abrir a página de configuração dos Serviços REST.
No campo Biblioteca de Implementação JAX-RS,
selecione IBM WebSphere Application Server v<x> Biblioteca
JAX-RS. Assegure que os valores a seguir apareçam:
- No campo Nome do Servlet JAX-RS:, assegure
que Servlet JAX-RS seja exibido.
- No campo Nome da Classe do Servlet JAX-RS:,
assegure que com.ibm.websphere.jaxrs.server.IBMRestServlet seja exibido.
- No campo Padrões de Mapeamento de URL:, assegure
que /jaxrs/* seja exibido.
Saiba mais sobre bibliotecas: As bibliotecas JAX-RS para cada WebSphere Application Server que você instalou serão listadas
nessa caixa suspensa. Se você desejar usar uma biblioteca não WebSphere, ela poderá
ser importada usando a página de preferências de Bibliotecas de Usuário. Se você selecionar
Biblioteca de Usuário, será possível ativar a página Bibliotecas de Usuário e
incluir uma biblioteca. Após um projeto ter sido criado, é possível
mudar a biblioteca na página .
- Na lista de opções de configuração disponíveis,
clique em Módulo da web. Na página Configuração do
módulo da web:
- No campo Raiz de Contexto, digite o nome de sua raiz de projeto da web ou aceite o
padrão (que é o nome de seu projeto da web).
- No campo Diretório de conteúdo, digite o nome do seu diretório de conteúdo ou aceite o padrão (WebContent).
- Selecione Gerar
descritor de implementação web.xml se desejar criar um
descritor de implementação. Também é possível incluir um descritor de implementação no seu módulo da web posteriormente.É necessário
usar um web.xml para configurar as restrições de segurança
e outros comportamentos.
- Clique em Concluir.
Resultados
O aspecto inclui a biblioteca, informações do servlet e suporte para o processamento de anotações do
JAX-RS e correções rápidas do JAX-RS.
Agora você está pronto
para iniciar o próximo módulo: Criando e testando o serviço da web.