< Anterior | Próximo >

Lição 1: Criando um servidor e um projeto da web

O serviço da web precisa residir em um projeto da web com a máscara JAX-RS ativada.

Criar um servidor ativado pelo JAX-RS

Sobre Esta Tarefa

Antes de criar o serviço da web, é necessário que haja um servidor que tenha o suporte de JVM Java 7.0 ou posterior definido e iniciado. Por padrão, um servidor é criado para você ao instalar o WebSphere Application Server. Esse servidor pode ser visto na visualização Servidores. Porém, se você desejar criar um novo WebSphere Application Server, faça o seguinte:

Procedimento

  1. No menu Arquivo, selecione Novo > Outro > Servidor > Servidor > Avançar.
  2. Selecione a versão apropriada do WebSphere Application Server como o tipo de servidor. Clique em Avançar.
  3. Se este tempo de execução não tiver sido criado em seu espaço de trabalho, será solicitado que você selecione o diretório de instalação para o servidor. Clique em Avançar.
  4. Aceite a porta e o nome do servidor padrão. Para esse tutorial o nome do servidor padrão utilizado será server1. Clique em Concluir.
  5. Aguarde o servidor iniciar. Após ele ser iniciado, a visualização Console exibirá Servidor server1 aberto para e-business. Se o servidor não iniciar automaticamente, selecione-o na visualização Servidores e clique no ícone de início: Ícone de início do servidor.

Criar um Projeto da Web Ativado para JAX-RS

Sobre Esta Tarefa

O serviço da web JAX-RS precisa residir em um projeto com o aspecto JAX-RS ativado.

Procedimento

  1. Na perspectiva Java EE, clique com o botão direito do mouse em seu projeto do aplicativo corporativo e selecione Novo > Projeto da Web para abrir o assistente de projeto da web.
  2. No campo Nome, digite um nome para seu novo projeto da web. Para este tutorial, use JAXRS.
  3. 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.
  4. 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
  5. Clique em Avançar para configurar seu novo projeto da web.
  6. 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.
  7. 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:
      Aviso de raiz única
      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:
      1. Clique em Janela > Preferências > Validação > Validação da estrutura do projeto e, em seguida, no botão ... para Configurações.
      2. 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.
  8. 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 Preferências > Máscaras de Projeto > JAX-RS.
  9. 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.
  10. 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.

< Anterior | Próximo >
Icon that indicates the type of topic Tutorial lesson topic
Timestamp icon Last updated: last_date

File name: jaxrs_exercise12.html