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")等错误响应。

Wechat Article Html

将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。

下载

四、配置Multipart大小限制

默认情况下，Quarkus对multipart请求体有10MB上限，超出将触发413 Payload Too Large。需根据实际XML文件体积调整。

1、在application.properties中设置quarkus.resteasy-multipart.max-size=50M。

2、如需限制单个part大小，添加quarkus.resteasy-multipart.max-part-size=50M。

3、确认值单位支持K、M、G，例如2048K表示2MB。

五、使用RESTEasy Reactive替代方案

若项目采用RESTEasy Reactive（Quarkus 2.7+默认），则quarkus-resteasy-multipart不可用，须改用quarkus-resteasy-reactive-multipart扩展，并配合MultiMap与RoutingContext手动提取part。

1、添加依赖quarkus-resteasy-reactive-multipart，移除经典RESTEasy multipart扩展。

2、端点方法参数改为RoutingContext，通过context.fileUploads()获取上传文件列表。

3、筛选contentType().equals(MediaType.TEXT_XML)的upload项，调用upload.uploadedChannel().pipeTo(...)获取InputStream供JAXB解析。

六、测试上传请求构造

验证功能时，必须确保HTTP请求符合RFC 7578规范：Content-Type为multipart/form-data并携带正确boundary，且XML文件part的Content-Type头明确设为text/xml或application/xml。

1、使用curl命令时，添加-F "xmlFile=@example.xml;type=text/xml"，其中xmlFile需与表单类中@FormParam值一致。

2、若用Postman，选择form-data模式，Key设为字段名，Text类型切换为File，并点击Text下拉框选择File，同时在Headers中手动添加Content-Type: text/xml（部分版本需插件支持）。

3、检查响应状态码为200且无Unrecognized field或ParseError日志，表明XML结构与Java类匹配成功。