Quarkus中需添加quarkus-resteasy-multipart等依赖,定义@MultipartForm类接收XML文件流,端点用@Consumes(MediaType.MULTIPART_FORM_DATA)解析并JAXB反序列化,配置大小限制,RESTEasy Reactive则用quarkus-resteasy-reactive-multipart替代。
如果您在Quarkus应用中需要通过REST端点接收XML格式的文件上传,需借助RESTEasy的multipart支持实现二进制或文本内容解析。以下是实现该功能的具体步骤:
一、添加必要依赖
Quarkus默认不启用RESTEasy Classic的multipart支持,需显式引入对应扩展以启用MultipartForm注解和相关解析器。
1、在pom.xml中添加quarkus-resteasy-multipart依赖:
2、确保quarkus-resteasy-jackson或quarkus-resteasy-jaxb已存在,用于后续XML反序列化(推荐JAXB,因原生支持XML)。
3、若使用JAXB,还需添加quarkus-jaxb扩展,并在application.properties中设置quarkus.resteasy-jaxb=true。
二、定义Multipart表单数据类
需创建一个POJO类,用@MultipartForm标注,并为XML文件字段指定@PartType与MediaType.TEXT_XML或MediaType.APPLICATION_XML,确保RESTEasy按XML类型解析字节流。
1、声明字段类型为InputStream或byte[],避免直接使用File(Quarkus不支持服务端文件系统写入)。
2、为该字段添加@FormParam名称,与HTML表单中name属性一致。
3、在类顶部添加@MultipartForm注解,使RESTEasy识别为多部分表单绑定目标。
三、编写REST端点处理方法
端点需使用@POST与@Consumes(MediaType.MULTIPART_FORM_DATA),并接受前述Multipart表单类作为参数;接收到XML流后,可使用JAXBContext或Jackson XMLMapper进行反序列化。
1、在资源类中定义方法,参数类型为已标注@MultipartForm的表单类。
2、调用JAXBContext.newInstance(YourXmlClass.class).createUnmarshaller().unmarshal(inputStream)完成解析。
3、捕获JAXBException并返回Response.status(BAD_REQUEST).entity("Invalid XML")等错误响应。