Implementando Recursos Usando Mensagens Multipartes
Uma mensagem multipartes contém uma ou mais mensagens dentro de sua estrutura. Cada parte de mensagem pode possuir seu próprio tipo de conteúdo. Usando a API IBM® Java™ para Serviços da Web RESTful (JAX-RS), é possível produzir e consumir mensagens multipartes.
Sobre Esta Tarefa
O IBM JAX-RS fornece classes a partir de um Wink Apache para modelar um pedido multipartes e uma resposta multipartes. Além disso, o IBM JAX-RS inclui provedores de entidade, por padrão, que suportam mensagens multipartes. Esses provedores de entidade podem serializar e desserializar as instâncias de classe multipartes quando o tipo de conteúdo de mensagem for compatível com multipart/*.
Para processar mensagens multipartes usando as APIs Apache Wink, é necessário usar as classes definidas para representar a entidade do corpo de mensagem multipartes.
org.apache.wink.common.model.multipart.InMultiPart
org.apache.wink.common.model.multipart.BufferedInMultiPart
Use um dos tipos de classe de pedidos multipartes recebidos como um parâmetro de método no seu método de recurso. A classe InMultiPart flui a mensagem de pedido enquanto que a classe BufferedInMultiPart armazena a mensagem inteira na memória. Fluir a mensagem consome menos memória, mas é possível acessar apenas partes da mensagem uma vez de maneira iterativa. Por outro lado, usando armazenamento em buffer, é possível ler qualquer parte da mensagem a qualquer momento.
org.apache.wink.common.model.multipart.OutMultiPart
org.apache.wink.common.model.multipart.BufferedOutMultiPart
É possível retornar uma instância de um dos tipos de resposta multipartes de saída no seu método de recurso. A classe OutMultiPart flui a resposta multipartes enquanto que a classe BufferedOutMultiPart armazena a mensagem inteira na memória.
Essas classes multipartes de entrada e de saída usam os provedores de entidade JAX-RS para serializar e desserializar partes individuais da mensagem multipartes.
Para saber mais sobre as classes de mensagem multipartes, consulte a documentação da API Apache Wink.
Procedimento
Resultados
É possível receber e enviar mensagens multipartes que contêm vários tipos de conteúdo.