Utilización del contenido JSON en solicitudes y respuestas de JAX-RS

JavaScript Object Notation (JSON) es un formato de medios común que los servicios RESTful utilizan y generan. Puede utilizar este formato de intercambio de datos ligero que se basa en la notación literal de objetos de JavaScript para intercambiar datos.

Acerca de esta tarea

JSON es un formato de datos popular que es independiente del lenguaje de programación. Varios navegadores web y bibliotecas JavaScript, como Dojo, dan soporte a JSON. WebSphere da soporte a las bibliotecas de Jackson y JavaScript Object Notation (JSON4J).

La biblioteca Jackson es un procesador JSON (tanto analizador como generador) basado en tecnología de analizador de extracción StAX (Streaming API for XML). Proporciona lectura y escritura básica JSON (análisis y generación), un modelo completo de árbol basado en nodos, así como enlace de datos objeto-a-JSON.

Puede utilizar la biblioteca de Jackson para empaquetar y desempaquetar datos de JSON hacia y desde objetos POJO (Plain Old Java™ Objects) y JAXB (Java Architecture for XML Binding). Para utilizar Jackson para procesar datos JSON, debe incluir las bibliotecas Jackson en la classpath. Después de añadir Jackson a la vía de acceso de clases, utilice objetos POJOs y JAXB para representar cuerpos de mensajes de solicitud y respuesta. Jackson se incluye en el tiempo de ejecución del lado del servidor de este producto.

La biblioteca JSON4J es una implementación de un conjunto de clases de manejo JSON para utilizarlas en entornos Java. La biblioteca JSON4J proporciona un modelo Java simple para construir y manipular datos que se han de representar como datos JSON.

Puede utilizar la biblioteca JSON4J como salida de datos JSON. Para utilizar tipos de JSON4J como tipos de entidad admitidos, debe incluir la biblioteca JSON4J en la variable vía de acceso de clases. Después de añadir JSON4J a la vía de acceso de clases, puede utilizar las clases JSONObject y JSONArray de la biblioteca JSON4J como tipos para representar cuerpos de mensajes de solicitud y respuesta. JSON4J se incluye en el entorno de ejecución del lado del servidor de este producto.

Procedimiento

  1. Configure el entorno de desarrollo.
    1. Antes de comenzar a desarrollar aplicaciones JAX-RS, debe configurar su entorno de desarrollo añadiendo las bibliotecas JAX-RS en la vía de acceso de clases.
  2. Defina los recursos en aplicaciones web JAX-RS.
    1. Los recursos son el bloque de compilación básico de creación de un servicio RESTful. Los recursos pueden contener datos actualizados de forma estática o dinámica. Ejemplos de recursos de una aplicación de almacén de libros en línea incluyen un libro, un pedido en una tienda y una colección de usuarios. Identificando los recursos en la aplicación, puede hacer que el servicio resulte más útil y más fácil de desarrollar.
  3. Configure la aplicación JAX-RS.

    Puede configurar aplicaciones JAX-RS de varias maneras en función de sus necesidades. Para sacar partido de la funcionalidad de Java Platform, Enterprise Edition (Java EE) 6, puede utilizar las prestaciones de exploración de anotaciones. Mediante la utilización de la exploración de anotación, puede omitir una subclase javax.ws.rs.core.Application de JAX-RS o tener una subclase javax.ws.rs.core.Application mínimamente definida. Como alternativa, puede especificar el servlet o filtro IBM® JAX-RS si desea utilizar la funcionalidad disponible en el servlet o filtro IBM JAX-RS.

    Si utiliza uno de los métodos de configuración de JAX-RS Versión 1.1, puede omitir una subclase javax.ws.rs.core.Application en la aplicación o disponer de una subclase javax.ws.rs.core.Application que devuelva un conjunto vacío de clases para informar al entorno de ejecución JAX-RS para que busque y utilice todas las clases JAX-RS de la aplicación. Tal vez desee utilizar este método cuando no quiera añadir manualmente cada clase JAX-RS a una subclase javax.ws.rs.core.Application a medida que desarrolla la aplicación.

    Al especificar el servlet y filtro IBM JAX-RS específicos, puede sacar partido y asegurarse del comportamiento específico de IBM JAX-RS. Por ejemplo, el uso del filtro IBM JAX-RS puede ser útil para el desarrollo de una aplicación web con una mezcla de recursos JAX-RS y archivos JSP (JavaServer Pages) con los mismos patrones de URL.

    Aunque existe un método de configuración de JAX-RS V1.1 que soporta el uso de un archivo web.xml opcional, si desea especificar roles o restricciones de seguridad o desea aprovechar otras características habilitadas con un archivo web.xml, debe especificar la información en un archivo web.xml.

    Elija uno de los tres métodos siguientes para configurar la aplicación JAX-RS:

    • Configurar las aplicaciones JAX-RS con métodos de JAX-RS 1.1

      Utilice este método si desea utilizar las prestaciones de exploración de anotaciones o utilizar los métodos de configuración de JAX-RS 1.1. Puede utilizar las prestaciones de exploración de anotaciones para promover la portabilidad de las aplicaciones, minimizar la cantidad de código de configuración o modificar dinámicamente la aplicación sin cambios en el código de aplicación.

    • Configure el archivo web.xml para los servlets de JAX-RS

      Utilice este método si desea especificar características que se habilitan utilizando parámetros de inicialización de servlet para cambiar el comportamiento y asegurarse de obtener el servlet IBM JAX-RS. Cuando se utilizan servlets, puede definir una vía de acceso del servlet en el archivo web.xml que se añadirá al URL base.

    • Configure el archivo web.xml para los filtros de JAX-RS

      Utilice este método si desea utilizar el filtro cuando tiene los JSP, otros servlets y filtros y recursos JAX-RS con una combinación de patrones de URL. Puede configurar el archivo web.xml para definir filtros que indiquen los URL posibles en los que se puede invocar el filtro.

  4. Implemente un método de recurso utilizando el contenido JSON para una entidad de solicitud y respuesta.
    1. Los servicios RESTful pueden consumir y producir contenido utilizando el formato JSON.
  5. Ensamble las aplicaciones web JAX-RS.
    1. Después de desarrollar los archivos de clase Java para la aplicación web de JAX-RS y tras editar el archivo web.xml para habilitar el servlet de JAX-RS, ya estará listo para ensamblar la aplicación. Ensamble la aplicación web en un paquete WAR (archivador web). Puede ensamblar el paquete WAR en un paquete archivador empresarial (EAR), si fuera preciso.
  6. Despliegue las aplicaciones web JAX-RS.
    1. Una vez que ha ensamblado la aplicación web JAX-RS, debe desplegar el paquete WAR (Web Archive) o el paquete EAR (Enterprise Archive) en el servidor de aplicaciones.

Resultados

Ha desarrollado y desplegado una aplicación web JAX-RS en el servidor de aplicaciones que utiliza bibliotecas JSON4J para procesar contenido JSON en solicitudes y respuestas.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_jaxrs_jsoncontent
File name: twbs_jaxrs_jsoncontent.html