2.7.11.2.2. 带有 multipart/form-data的输出
RESTEasy 提供了一个简单的 API 来输出 multipart/form-data
。
package org.jboss.resteasy.plugins.providers.multipart; public class MultipartFormDataOutput extends MultipartOutput { public OutputPart addFormData(String key, Object entity, MediaType mediaType) public OutputPart addFormData(String key, Object entity, GenericType type, MediaType mediaType) public OutputPart addFormData(String key, Object entity, Class type, Type genericType, MediaType mediaType) public Map<String, OutputPart> getFormData() }
要输出 multipart/form-data
,您必须创建一个 MultipartFormDataOutput
对象并调用 addFormData()
方法。RESTEasy 将自动查找 MessageBodyWriter
来托管您的实体对象。与 MultipartInput
类似,有时您可能会有对通用类型的元数据敏感的托管。在这种情况下,使用 GenericType
。通常,传递对象及其 MediaType
应该足够。
示例:返回 multipart/form-data
Format
@Path("/form") public class MyService { @GET @Produces("multipart/form-data") public MultipartFormDataOutput get() { MultipartFormDataOutput output = new MultipartFormDataOutput(); output.addPart("bill", new Customer("bill"), MediaType.APPLICATION_XML_TYPE); output.addPart("monica", new Customer("monica"), MediaType.APPLICATION_XML_TYPE); return output; } }
注意
上例假定 客户
类标有 Jakarta XML Binding。