0

0

Quarkus如何处理XML文件上传 RESTEasy和multipart支持

煙雲

煙雲

发布时间:2026-02-06 11:15:09

|

227人浏览过

|

来源于php中文网

原创

Quarkus中需添加quarkus-resteasy-multipart等依赖,定义@MultipartForm类接收XML文件流,端点用@Consumes(MediaType.MULTIPART_FORM_DATA)解析并JAXB反序列化,配置大小限制,RESTEasy Reactive则用quarkus-resteasy-reactive-multipart替代。

quarkus如何处理xml文件上传 resteasy和multipart支持

如果您在Quarkus应用中需要通过REST端点接收XML格式的文件上传,需借助RESTEasy的multipart支持实现二进制或文本内容解析。以下是实现该功能的具体步骤:

一、添加必要依赖

Quarkus默认不启用RESTEasy Classic的multipart支持,需显式引入对应扩展以启用MultipartForm注解和相关解析器。

1、在pom.xml中添加quarkus-resteasy-multipart依赖:

2、确保quarkus-resteasy-jacksonquarkus-resteasy-jaxb已存在,用于后续XML反序列化(推荐JAXB,因原生支持XML)。

3、若使用JAXB,还需添加quarkus-jaxb扩展,并在application.properties中设置quarkus.resteasy-jaxb=true

二、定义Multipart表单数据类

需创建一个POJO类,用@MultipartForm标注,并为XML文件字段指定@PartTypeMediaType.TEXT_XMLMediaType.APPLICATION_XML,确保RESTEasy按XML类型解析字节流。

1、声明字段类型为InputStreambyte[],避免直接使用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")等错误响应。

X-Node企业快速建站1.0.6.0801
X-Node企业快速建站1.0.6.0801

特色介绍: 1、ASP+XML+XSLT开发,代码、界面、样式全分离,可快速开发 2、支持语言包,支持多模板,ASP文件中无任何HTML or 中文 3、无限级分类,无限级菜单,自由排序 4、自定义版头(用于不规则页面) 5、自动查找无用的上传文件与空目录,并有回收站,可删除、还原、永久删除 6、增强的Cache管理,可单独管理单个Cache 7、以内存和XML做为Cache,兼顾性能与消耗 8、

下载

四、配置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、确认值单位支持KMG,例如2048K表示2MB。

五、使用RESTEasy Reactive替代方案

若项目采用RESTEasy Reactive(Quarkus 2.7+默认),则quarkus-resteasy-multipart不可用,须改用quarkus-resteasy-reactive-multipart扩展,并配合MultiMapRoutingContext手动提取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/xmlapplication/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 fieldParseError日志,表明XML结构与Java类匹配成功。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
软件测试常用工具
软件测试常用工具

软件测试常用工具有Selenium、JUnit、Appium、JMeter、LoadRunner、Postman、TestNG、LoadUI、SoapUI、Cucumber和Robot Framework等等。测试人员可以根据具体的测试需求和技术栈选择适合的工具,提高测试效率和准确性 。

446

2023.10.13

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1914

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2097

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1100

2024.11.28

curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

445

2023.06.14

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

179

2023.10.30

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

534

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

17

2025.12.06

java连接字符串方法汇总
java连接字符串方法汇总

本专题整合了java连接字符串教程合集,阅读专题下面的文章了解更多详细操作。

23

2026.02.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 4.7万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.0万人学习

React核心原理新老生命周期精讲
React核心原理新老生命周期精讲

共12课时 | 1.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号