<div class="key-takeaways"><ul><li>Solon ใช้คลาส UploadedFile จัดการไฟล์ในเลเยอร์เว็บโดยไม่ต้องตั้งค่าเพิ่ม</li><li>เฟรมเวิร์กจะไม่ลบไฟล์ชั่วคราวให้อัตโนมัติ จึงต้องใช้รูปแบบ try/finally เสมอ</li><li>รองรับการส่งหลายไฟล์พร้อมกันด้วย UploadedFile[] ตั้งแต่เวอร์ชัน v2.3.8 เป็นต้นไป</li><li>ตั้งค่าขนาดไฟล์และหน่วยความจำได้ผ่านไฟล์ app.yml เช่น การกำหนดค่า fileSizeThreshold ใน v3.6.0</li></ul></div><p>การอัปโหลดไฟล์มักจะเป็นเรื่องน่าเบื่อจนกว่าคุณจะเคยใช้เวลาช่วงบ่ายเพื่อแก้ปัญหาข้อผิดพลาดประเภท MultipartException: Failed to parse multipart servlet request ในสภาพแวดล้อมจริงบนเซิร์ฟเวอร์โปรดักชัน ซึ่งในฝั่งของ Spring Boot การอัปโหลดไฟล์จะต้องเกี่ยวข้องกับคอมโพเนนต์อย่าง MultipartFile, MultipartAutoConfiguration, ชุดคุณสมบัติ spring.servlet.multipart.* รวมถึงการตั้งต้นสมมติฐานว่าแอปพลิเคชันกำลังทำงานบนเซิร์ฟเวิร์ตคอนเทนเนอร์ แม้ว่าระบบเหล่านี้จะใช้งานได้จริง แต่ก็ซ่อนกลไกการทำงานเบื้องหลังไว้ค่อนข้างมาก</p><p>ในทางตรงกันข้าม เฟรมเวิร์ก Solon เลือกเส้นทางที่แตกต่างออกไปโดยสิ้นเชิง โดยมีคลาสหลักคือ UploadedFile ซึ่งอยู่ในเว็บเลเยอร์และไม่ต้องอาศัยการตั้งค่าเพิ่มเติมใดๆ ผู้พัฒนาจึงมีอำนาจควบคุมที่ชัดเจนว่ากระบวนการแยกส่วนข้อมูลหรือ multipart parsing จะเกิดขึ้นเมื่อใด และไฟล์ชั่วคราวจะถูกลบออกเมื่อไร</p><div class="mb-20"><img class="img-bdrd-16" src="https://api.inewgen.co/uploads/solon_file_upload_uploadedfile_multipartfile_ms84g2yy_inline_1_1fa049a9f7.jpg" alt="software architecture diagram" loading="lazy" /><p class="color-gray-500 text-sm mt-10">ภาพประกอบจากคลังภาพสต็อก ไม่ใช่ภาพจากเหตุการณ์จริง</p></div><p>เมื่อเมธอดในคอนโทรลเลอร์มีพารามิเตอร์ที่เป็น UploadedFile ระบบของ Solon จะทำการทริกเกอร์กระบวนการแยกส่วนข้อมูลแบบอัตโนมัติทันทีโดยไม่ต้องใส่แอนโนเทชันเพิ่มเติมใดๆ ตัวอย่างเช่นการจัดการฟิลด์ฟอร์ม user_avatar ดังนี้:</p><ul><li>รองรับฟิลด์เดี่ยว: @Param("user_avatar") UploadedFile file</li><li>รองรับไฟล์หลายไฟล์: ใช้ UploadedFile[] เมื่อไคลเอนต์ส่งไฟล์หลายไฟล์ภายใต้ชื่อฟิลด์เดียวกัน (รองรับตั้งแต่ v2.3.8)</li><li>รองรับฟอร์มแบบผสม: สามารถรับทั้งไฟล์และฟิลด์ข้อความธรรมดาได้ในคำขอเดียวกัน</li></ul><p>อย่างไรก็ตาม มีข้อควรระวังที่สำคัญคือ เฟรมเวิร์กจะไม่ลบไฟล์ชั่วคราวให้อัตโนมัติ หากคุณข้ามการเรียกใช้งานเมธอด delete() ไฟล์ชั่วคราวเหล่านั้นจะยังคงค้างอยู่บนดิสก์ ดังนั้นรูปแบบการเขียนโค้ดแบบ try/finally จึงเป็นสิ่งจำเป็นที่ไม่สามารถละเลยได้</p><div class="ai-insight"><p>การที่เฟรมเวิร์กไม่ลบไฟล์ชั่วคราวให้อัตโนมัติและกำหนดให้ผู้พัฒนาต้องจัดการผ่าน try/finally นั้น เป็นการออกแบบที่เน้นความโปร่งใสและการควบคุมทรัพยากรระบบด้วยตนเอง ซึ่งช่วยลดความประหลาดใจเมื่อเกิดปัญหาเรื่องพื้นที่ดิสก์เต็มในระบบโปรดักชัน ต่างจากเฟรมเวิร์กบางตัวที่ซ่อนกระบวนการเหล่านี้ไว้เบื้องหลังจนกว่าจะเกิดข้อผิดพลาด</p></div><p>สำหรับการจัดการไฟล์ขนาดใหญ่และหน่วยความจำ Solon อนุญาตให้ปรับแต่งผ่านไฟล์ app.yml ได้อย่างยืดหยุ่น ดังนี้:</p><ul><li>server.request.maxBodySize: กำหนดขนาดร่างกายของคำขอสูงสุด (ค่าเริ่มต้นคือ 2mb)</li><li>server.request.maxFileSize: กำหนดขนาดสูงสุดของไฟล์เดี่ยว (ค่าเริ่มต้นคือ 20mb)</li><li>server.request.maxHeaderSize: กำหนดขนาดส่วนหัวสูงสุด (ค่าเริ่มต้นคือ 8kb)</li><li>server.request.fileSizeThreshold: กำหนดเกณฑ์ขนาดไฟล์ ถ้าน้อยกว่านี้จะเก็บไว้ในหน่วยความจำ แต่ถ้ามากกว่าจะเก็บเป็นไฟล์ชั่วคราวบนดิสก์ (เพิ่งเพิ่มเข้ามาใน v3.6.0)</li></ul><p>การตั้งค่า fileSizeThreshold ที่เปิดตัวในเวอร์ชัน v3.6.0 ช่วยให้ระบบสามารถคัดแยกไฟล์ขนาดเล็กให้อยู่ในหน่วยความจำและไฟล์ขนาดใหญ่ให้ลงดิสก์ได้โดยอัตโนมัติ โดยก่อนหน้านี้ในเวอร์ชันที่เก่ากว่า v3.6.0 คุณจะต้องใช้แฟล็ก use_tempfile: true เพื่อบังคับโหมดไฟล์ชั่วคราว ซึ่งในปัจจุบันแฟล็กดังกล่าวถูกประกาศให้เลิกใช้งานแล้ว</p><p class="source-attribution">ที่มา: <img src="https://www.google.com/s2/favicons?domain=dev.to&sz=64" alt="Dev.to" class="source-logo" width="16" height="16" /> <a href="https://dev.to/solonjava/solon-file-upload-uploadedfile-over-multipartfile-22gf" target="_blank" rel="noopener noreferrer">Dev.to</a></p>

<div class="key-takeaways"><ul><li>Solon uses the UploadedFile core class in the web layer with zero extra configuration.</li><li>The framework does not auto-clean temp files, making the try/finally pattern mandatory.</li><li>Supports multiple files via UploadedFile[] arrays since version v2.3.8.</li><li>Fine-tune body sizes and memory thresholds easily via app.yml settings like fileSizeThreshold in v3.6.0.</li></ul></div><p>File uploading often feels mundane until you spend an entire afternoon debugging a MultipartException: Failed to parse multipart servlet request in a production environment. In Spring Boot, handling file uploads involves numerous components such as MultipartFile, MultipartAutoConfiguration, spring.servlet.multipart.* properties, alongside a quiet assumption that your application runs on a servlet container. While it functions well, it carries a substantial amount of hidden machinery behind the scenes.</p><p>Solon takes a completely different path. Its core class is UploadedFile, residing natively in the web layer without requiring any extra configuration. This design provides developers with explicit control over when multipart parsing occurs and precisely when temporary files are cleaned up.</p><div class="mb-20"><img class="img-bdrd-16" src="https://api.inewgen.co/uploads/solon_file_upload_uploadedfile_multipartfile_ms84g2yy_inline_1_1fa049a9f7.jpg" alt="software architecture diagram" loading="lazy" /><p class="color-gray-500 text-sm mt-10">Stock photo for illustration only, not from the actual event</p></div><p>Whenever a controller method includes an UploadedFile parameter, Solon automatically triggers multipart parsing without requiring any explicit annotations. Common implementation patterns include:</p><ul><li>Single file parameter: @Param("user_avatar") UploadedFile file handling the form field "user_avatar"</li><li>Multiple files: Utilizing UploadedFile[] when clients submit multiple files under an identical field name (supported since v2.3.8)</li><li>Mixed forms: Receiving both file and regular text fields concurrently within the same request</li></ul><p>One critical detail to note is that the framework does not automatically clean up temporary files. If you omit the delete() call, those temporary files will remain stored on your disk. Consequently, incorporating the try/finally pattern is mandatory rather than optional.</p><div class="ai-insight"><p>Requiring developers to handle temporary file deletion explicitly via try/finally highlights Solon's philosophy of avoiding hidden magic. By bringing disk I/O and resource lifecycle management directly into the developer's field of view, it prevents unexpected disk space leaks in production environments compared to frameworks that abstract these details away entirely.</p></div><p>To manage request payloads and memory thresholds efficiently, configurations can be specified directly inside the app.yml file:</p><ul><li>server.request.maxBodySize: Maximum request body size (default: 2mb)</li><li>server.request.maxFileSize: Maximum single file upload size (default: 20mb)</li><li>server.request.maxHeaderSize: Maximum header size limit (8kb)</li><li>server.request.fileSizeThreshold: Files below this threshold route to memory, while larger files route to disk (introduced in v3.6.0)</li></ul><p>The fileSizeThreshold setting introduced in v3.6.0 automatically routes small files directly to memory and large files to disk. Prior to version v3.6.0, developers had to rely on useTempfile: true to force temporary file mode—a flag that has now been officially deprecated.</p><p class="source-attribution">Source: <img src="https://www.google.com/s2/favicons?domain=dev.to&sz=64" alt="Dev.to" class="source-logo" width="16" height="16" /> <a href="https://dev.to/solonjava/solon-file-upload-uploadedfile-over-multipartfile-22gf" target="_blank" rel="noopener noreferrer">Dev.to</a></p>

medium_solon-file-upload-uploadedfile-multipartfile-ms84g2yy.jpg

small_solon-file-upload-uploadedfile-multipartfile-ms84g2yy.jpg

thumbnail_solon-file-upload-uploadedfile-multipartfile-ms84g2yy.jpg

solon-file-upload-uploadedfile-multipartfile-ms84g2yy.jpg

ทำความเข้าใจระบบอัปโหลดไฟล์ในเฟรมเวิร์ก Solon ที่เน้นความโปร่งใส ควบคุมการทำงานได้ชัดเจนโดยไม่ต้องพึ่งพาการตั้งค่าอัตโนมัติจำนวนมาก

Discover how the Solon framework handles file uploads using UploadedFile, offering explicit control and transparency without heavy auto-configurations.

Inewgen

Inewgen

#MultipartFile

Solon File Upload: UploadedFile Over MultipartFile Explained

Inewgen