Implemente recursos utilizando mensajes de múltiples partes
Un mensaje de múltiples partes contiene uno o varios mensajes en su estructura. Cada parte del mensaje puede tener su propio tipo de contenido. Mediante la utilización de IBM® Java™ API for RESTful Web Services (JAX-RS), puede generar y consumir mensajes de múltiples partes.
Acerca de esta tarea
IBM JAX-RS proporciona clases de Apache Wink para formar una solicitud de múltiples partes y una respuesta de múltiples partes. Además, IBM JAX-RS incluye proveedores de entidades, de forma predeterminada, que dan soporte a mensajes de múltiples partes. Estos proveedores de entidades pueden serializar y deserializar las instancias de clases de múltiples partes cuando el tipo de contenido del mensaje es compatible con multipart/*.
Para procesar mensajes de múltiples partes utilizando las API de Apache Wink, debe utilizar clases definidas para representar la entidad del cuerpo del mensaje de múltiples partes.
org.apache.wink.common.model.multipart.InMultiPart
org.apache.wink.common.model.multipart.BufferedInMultiPart
Utilice uno de los tipos de clase de solicitud de entrada de múltiples partes como parámetro de método en el método de recurso. La clase InMultiPart difunde el mensaje de solicitud mientras que la clase BufferedInMultiPart almacena todo el mensaje en la memoria. La difusión del mensaje consume menos memoria pero solamente puede acceder a las partes del mensaje una vez de forma iterativa. En cambio, si utiliza el almacenamiento intermedio, podrá leer todas las partes del mensaje cuando lo desee.
org.apache.wink.common.model.multipart.OutMultiPart
org.apache.wink.common.model.multipart.BufferedOutMultiPart
Puede devolver una instancia de uno de los tipos de respuestas salientes de múltiples partes en el método de recurso. La clase OutMultiPart difunde la respuesta de múltiples partes mientras que la clase BufferedOutMultiPart almacena todo el mensaje en la memoria.
Estas clases entrantes y salientes de múltiples partes utilizan proveedores de JAX-RS para serializar y deserializar partes individuales del mensaje de múltiples partes.
Para obtener más información sobre las clases de mensajes de múltiples partes, consulte la documentación de la API de Apache Wink.
Procedimiento
Resultados
Puede recibir y enviar mensajes de múltiples partes que contengan varios tipos de contenido.