Criando um serviço da web JAX-RS
Antes de Iniciar
- WebSphere Application Server v7.0 ou v8.0, selecionando para instalar o Feature Pack for Web 2.0 AND MOBILE e as ferramentas para desenvolvimento do WebSphere Application Server
Caso escolha implementar em um servidor diferente do WebSphere Application Server, não é possível usar a biblioteca IBM® JAX-RS e deve-se instalar e configurar suas próprias bibliotecas JAX-RS por meio da página Aspectos do projeto > Preferências do JAX-RS.
Para obter informações detalhadas sobre como usar os serviços da web JAX-RS no WebSphere Application Server, consulte: Centro de informações do WebSphere Application Server
Criar um Projeto da Web Ativado para JAX-RS
Sobre Esta Tarefa
O [WebSphere Application Server tradicional] WebSphere Application Server tradicional V9 suporta JAX-RS 1.1 e 2.0. A versão do JAX-RS utilizada no projeto deve corresponder à versão do JAX-RS utilizada na instalação do WebSphere Application Server tradicional V9. Se essas versões não corresponderem, as ferramentas exibirão um aviso quando o projeto for implementado no servidor. Ao criar um projeto JAX-RS sem especificar um nível de máscara, as ferramentas utilizarão o JAX-RS 2.0 por padrão.
com.ibm.ws.jaxrs.jar
com.ibm.ws.prereq.jaxrs.jar
javax.j2ee.jaxrs.jar
com.ibm.ws.jaxrs20.jar
com.ibm.ws.prereq.jaxrs20.jar
javax.ws.rs-api-2.0.jar
Procedimento
Criar um Serviço da Web JAX-RS
Procedimento
- Em seu projeto da web, crie um pacote (clique com o botão direito do mouse em e selecione ). Importe as classes do serviço da web para o pacote.
- Abra WebContent/WEB-INF/web.xml. Na visualização Design, selecione o Servlet JAX-RS Servlet e clique em Incluir e inclua um parâmetro de Inicialização no servlet JAX-RS, deixando os campos de nome e valor vazios. Salve o web.xml ignorando quaisquer erros que possam ser exibidos.
- Na visualização Marcadores, selecione o erro do web.xml sobre o param-name, clique com o botão direito do mouse e selecione Correção Rápida. Procure o aplicativo e selecione.
- Inclua o EAR que contém o projeto JAX-RS no servidor e inicie o servidor.
Resultados
Cada aplicativo da web deve ter uma raiz de contexto para o aplicativo da web implementar com êxito. Uma raiz de contexto para cada módulo de Web é definido no descritor de implementação do aplicativo durante a montagem do aplicativo ou durante a implementação do aplicativo. A raiz de contexto é combinada com o mapeamento de servlet definido a partir do arquivo WAR para compor a URL integral que os usuários digitam para acessar o servlet. A raiz de contexto para cada aplicativo da web implementado deve ser exclusiva no servidor. A raiz de contexto também pode estar vazia.
Por exemplo, se um aplicativo da web usou uma raiz de contexto de sample/application/, a URL de solicitação de aplicativo da web iniciará com http://<nome_do_host>:<porta>/sample/application/. O padrão da URL de um servlet é anexado à raiz de contexto do aplicativo da web. Por exemplo, se a raiz de contexto for sample/application/ e o mapeamento de URL do servlet for rest/api/*, o URI base para o aplicativo da web JAX-RS será http://<nome_do_host>:<porta>/sample/application/rest/api.
Editando um Projeto JAX-RS
- Tipo de Biblioteca
- Nome de servlet JAX-RS
- Nome de classe de servlet JAX-RS
- Padrões de mapeamento de URL