Usando Conteúdo JSON nos Pedidos e Respostas do Aplicativo JAX-RS

O JavaScript Object Notation (JSON) é um formato de mídia comum que os serviços RESTful consomem e produzem. É possível usar esse formato de troca de dados leve que seja baseado na notação literal de objeto do JavaScript para troca de dados.

Sobre Esta Tarefa

JSON é um formato de dados popular com uma linguagem de programação neutra. Diversos navegadores da Web e bibliotecas JavaScript, como Dojo, fornecem suporte para o JSON. O WebSphere suporta as bibliotecas Jackson e JavaScript Object Notation (JSON4J).

A biblioteca Jackson é um processador JSON (ambos analisador e gerador) que se baseia na tecnologia pull parser de fluxo API para XML (StAX). Ela fornece leitura e gravação JSON (análise e geração), um modelo em árvore completo baseado em nó, além de ligação de dados objeto-para-JSON.

É possível usar a biblioteca Jackson para desserializar e serializar os dados JSON para os objetos do Plain Old Java™ Objects (POJOs) e Java Architecture for XML Binding (JAXB). Para usar o Jackson para processar dados JSON, você deve incluir as bibliotecas Jackson no caminho da classe. Depois de incluir Jackson no caminho da classe, use os objetos POJOs e JAXB para representar o corpo das mensagens de solicitação e de resposta. Jackson é incluído no tempo de execução do lado do servidor desse produto.

A biblioteca JSON4J é uma implementação de um conjunto de classes de manipulação JSON para uso em ambientes Java. Uma biblioteca JSON4J fornece um modelo Java simples para contruir e manipular dados para serem renderizados como dados JSON.

É possível usar a biblioteca JSON4J para gerar dados JSON. Para usar tipos JSON4J como tipos de entidade suportados, deve-se incluir a biblioteca JSON4J no caminho da classe. Depois de incluir JSON4J no caminho da classe, é possível usar o JSONObject e as classes JSONArray da biblioteca JSON4J como tipos para representar corpos de mensagens de solicitação e resposta. O JSON4J está incluído no ambiente de tempo de execução no lado do servidor desse produto.

Procedimento

  1. Configure o ambiente de desenvolvimento.
    1. Antes de iniciar o desenvolvimento de aplicativos JAX-RS, é necessário configurar o ambiente de desenvolvimento incluindo as bibliotecas JAX-RS no caminho de classe.
  2. Definir os recursos nos aplicativos da Web JAX-RS.
    1. Os recursos são o bloco de construção básico de um serviço RESTful. Os recursos podem conter dados estáticos ou atualizados dinamicamente. Os exemplos de recursos a partir de um aplicativo de armazenamento de manual online incluem um manual, uma ordem de um armazenamento e uma coleta de usuários. Ao identificar os recursos no seu aplicativo, poderá tornar seu serviço mais útil e fácil de desenvolver.
  3. Configure o aplicativo JAX-RS.

    É possível configurar aplicativos JAX-RS de várias formas dependendo de suas necessidades. Para aproveitar a funcionalidade Java Platform, Enterprise Edition (Java EE) 6, é possível usar os recursos de varredura de anotação. Ao usar a varredura de anotação, é possível omitir uma subclasse javax.ws.rs.core.Application ou ter uma subclasse javax.ws.rs.core.Application minimamente definida. Como alternativa, é possível especificar o servlet ou filtro do IBM® JAX-RS se quiser usar a funcionalidade disponível no servlet e filtro do IBM JAX-RS.

    Usando um dos métodos de configuração do JAX-RS Versão 1.1, é possível omitir uma subclasse javax.ws.rs.core.Application em seu aplicativo ou ter uma subclasse javax.ws.rs.core.Application que retorne um conjunto vazio de classes para informar ao ambiente de tempo de execução do JAX-RS para localizar e usar todas as classes JAX-RS no aplicativo. Você pode querer usar este método quando não desejar ter que incluir manualmente cada classe JAX-RS relevante em uma subclasse javax.ws.rs.core.Application conforme o aplicativo é desenvolvido.

    Ao especificar o servlet e filtro IBM JAX-RS específicos, é possível aproveitar e garantir o comportamento do IBM JAX-RS específico. Por exemplo, usar o filtroIBM JAX-RS pode ser útil no desenvolvimento de um aplicativo da Web com uma combinação de recursos JAX-RS e arquivos JavaServer Pages (JSP) com os mesmos padrões de URL.

    Embora haja um método de configuração de JAX-RS V1.1 que suporte o uso de um arquivo web.xml opcional, se quiser especificar restrições de segurança ou funções, ou, se quiser aproveitar os outros recursos ativados com um arquivo web.xml, você deverá especificar as informações em um arquivo web.xml.

    Escolha um dos três métodos a seguir para configurar seu aplicativo JAX-RS:

    • Configurar aplicativos JAX-RS usando métodos JAX-RS 1.1

      Use este método se quiser usar os recursos de varredura de anotação ou usar os métodos de configuração do JAX-RS 1.1. É possível usar os recursos de varredura de anotação para promover a portabilidade do aplicativo, para minimizar a quantidade de código de configuração ou para modificar o aplicativo de forma dinâmica sem mudanças no código do aplicativo.

    • Configurar o arquivo web.xml para servlets JAX-RS

      Use este método se quiser especificar os recursos que estão ativados usando os parâmetros de inicialização de servlet para alterar o comportamento e garantir que se obtém o servlet IBM JAX-RS. Ao usar os servlets, é possível definir um caminho de servlet no arquivo web.xml que é anexado à URL de base.

    • Configurar o arquivo web.xml para filtros JAX-RS

      Use este método se quiser usar o filtro quando tiver JSPs, outros servlets e filtros e recursos JAX-RS com uma combinação de padrões URL. É possível configurar o arquivo web.xml para definir filtros que indicam as possíveis URLs nas quais o filtro pode ser chamado.

  4. Implemente um método de recurso usando conteúdo JSON para uma entidade de pedido e de resposta.
    1. Os serviços RESTful podem consumir e produzir um conteúdo usando o formato JSON.
  5. Montar aplicativos da Web JAX-RS.
    1. Após desenvolver os arquivos de classe Java para o seu aplicativo da Web JAX-RS e editar o arquivo web.xml para ativar o servlet JAX-RS, você está pronto para montar o aplicativo. Montar o aplicativo da Web em um pacote archive aplicativo da Web (WAR). É possível montar o pacote WAR em um pacote archive corporativo (EAR), se necessário.
  6. Implementar aplicativos da Web JAX-RS.
    1. Após ter montado o seu aplicativo da Web JAX-RS, é necessário implementar o seu pacote archive web (WAR) ou o pacote archive corporativo (EAR) no servidor de aplicativos.

Resultados

Você desenvolveu e implementou um aplicativo da Web JAX-RS no servidor de aplicativos que usa bibliotecas JSON4J para processar conteúdo JSON para pedidos e respostas.


Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_jaxrs_jsoncontent
Nome do arquivo: twbs_jaxrs_jsoncontent.html