<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.

เจาะลึก Solon File Upload ใช้ UploadedFile จัดการไฟล์แทน MultipartFile

Solon File Upload: UploadedFile Over MultipartFile Explained

<div class="key-takeaways"><ul><li>Solon WebSocket มีสถาปัตยกรรมที่แตกต่างจากมาตรฐาน JSR-356 ของ Java อย่างสิ้นเชิง</li><li>รองรับการใช้งานแบบพอร์ตแชร์ร่วมกับ HTTP ผ่านการตั้งค่า server.websocket.port</li><li>โค้ดที่ใช้ @ServerEndpoint แบบเดิมจำเป็นต้องเขียนใหม่ให้เข้ากับ Listener Interface</li><li>จุดเด่นคือทดสอบง่ายและทำ Routing ได้ชัดเจนโดยไม่ต้องพึ่งพา Annotation Scanning</li></ul></div><p>ระบบ WebSocket ของ Solon ถือเป็นหนึ่งในจุดที่นักพัฒนาสาย Java อาจต้องปรับตัวทำความเข้าใจใหม่ เนื่องจากแนวทางการออกแบบมีความแตกต่างจากมาตรฐานทั่วไปอย่าง JSR-356 ที่ใช้งานกันแพร่หลายใน Spring, Tomcat หรือคอนเทนเนอร์ Java EE อื่นๆ แม้จะไม่ใช่ระบบที่แย่กว่า แต่เป็นแนวคิดที่เลือกเดินคนละทาง เมื่อทำความเข้าใจรูปแบบของมันได้แล้ว จะพบว่ามีความสะอาดและเป็นระเบียบกว่ามากทีเดียว</p><p>โครงสร้างการทำงานหลักของ Solon WebSocket จะแบ่งออกเป็น 2 รูปแบบ ขึ้นอยู่กับปลั๊กอินของเซิร์ฟเวอร์ที่เลือกใช้งาน ดังนี้:</p><ul><li>การใช้งานแบบพอร์ตแชร์ (Shared port): การจราจรทั้ง HTTP และ WebSocket จะใช้พอร์ตเดียวกัน ซึ่งปลั๊กอินเซิร์ฟเวอร์ส่วนใหญ่รองรับการทำงานนี้ได้ทันที</li><li>การกำหนดค่าผ่านพารามิเตอร์ <code>server.websocket.port : 18080</code> โดยไม่ต้องกังวลเรื่องหมายเลขเวอร์ชันในการประกาศ dependency เนื่องจากระบบ Solon BOM จะทำหน้าที่จัดการให้ทั้งหมด</li></ul><p>ข้อควรระวังสำคัญคือ Solon WebSocket ไม่ได้ใช้งาน API ตามมาตรฐาน JSR-356 ดังนั้น หากนักพัฒนากำลังย้ายระบบโค้ดเดิมที่เรียกใช้คลาส <code>javax.websocket.Session</code>, แอนโนเทชัน <code>@ServerEndpoint</code> หรือระบบ Encoder/Decoder ของ JSR-356 โค้ดส่วนนั้นจำเป็นต้องถูกเขียนใหม่ทั้งหมดให้อยู่ในรูปแบบของ listener interface pattern แม้จะไม่ใช่การเขียนใหม่ทั้งหมดในปริมาณที่ใหญ่โต แต่มันก็เป็นงานที่ต้องลงมือทำจริงจัง</p><div class="mb-20"><img class="img-bdrd-16" src="https://api.inewgen.co/uploads/solon_websocket_java_ms7ro01u_inline_1_42a7ff4382.jpg" alt="software development architecture diagram code" loading="lazy" /><p class="color-gray-500 text-sm mt-10">ภาพประกอบจากคลังภาพสต็อก ไม่ใช่ภาพจากเหตุการณ์จริง</p></div><div class="ai-insight"><p>การเปลี่ยนผ่านจาก Annotation มาเป็น Listener Interface ในทางวิศวกรรมซอฟต์แวร์ช่วยลดปัญหาความซับซ้อนที่เกิดจาก Magic Annotation (แอนโนเทชันวิเศษที่ซ่อนการทำงานเบื้องหลัง) ซึ่งมักสร้างความประหลาดใจหรือตรวจหาข้อผิดพลาดได้ยาก การใช้ Listener ตรงๆ ช่วยให้เราเห็นลำดับการทำงาน (Pipeline) ได้อย่างชัดเจนผ่านโค้ดตรงหน้า</p></div><p>ในทางกลับกัน ข้อดีที่ได้กลับคืนมาคือรูปแบบ listener นั้นช่วยให้การเขียน Unit Test กลายเป็นเรื่องง่ายดาย เพียงแค่สร้างอินสแตนซ์ของคลาส listener ขึ้นมาแล้วเรียกใช้งานเมธอดโดยตรง นอกจากนี้ยังช่วยเรื่องการประกอบระบบและการทำ routing ผ่าน path ได้อย่างชัดเจน อ่านง่าย โดยไร้ความประหลาดใจจากระบบสแกนแอนโนเทชันที่มักซ่อนอยู่เบื้องหลัง</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-websocket-listener-interface-over-annotation-maze-3eja" target="_blank" rel="noopener noreferrer">Dev.to</a></p>

<div class="key-takeaways"><ul><li>Solon WebSocket features an architecture that clearly diverges from the standard Java JSR-356 specification.</li><li>It supports shared port configurations where HTTP and WebSocket traffic use the same port.</li><li>Legacy code using @ServerEndpoint must be refactored to fit the listener interface pattern.</li><li>The core advantage is easier unit testing and explicit routing without annotation scanning surprises.</li></ul></div><p>Solon's WebSocket support is one of those areas where the design diverges clearly from what most Java developers expect. If you have built WebSocket endpoints with JSR-356—the standard followed by Spring, Tomcat, and most Java EE containers—Solon handles things differently. It is not worse, simply different, and once the pattern clicks, it proves to be noticeably cleaner.</p><p>Solon WebSocket operates under specific configurations based on the server plugin in use:</p><ul><li>Shared port configuration allows HTTP and WebSocket traffic to share a single port, supported out of the box by most server plugins.</li><li>Configuration is managed via <code>server.websocket.port : 18080</code>, with no version numbers required in dependency declarations since the Solon BOM handles them.</li></ul><p>A crucial detail is that Solon WebSocket does not implement the JSR-356 API. Developers migrating legacy code that directly utilizes <code>javax.websocket.Session</code>, <code>@ServerEndpoint</code> in the <code>javax.websocket</code> namespace, or standard encoders/decoders will need to rewrite that code to adopt the listener interface pattern. While not a massive rewrite, it is certainly a tangible migration effort.</p><div class="mb-20"><img class="img-bdrd-16" src="https://api.inewgen.co/uploads/solon_websocket_java_ms7ro01u_inline_1_42a7ff4382.jpg" alt="software development architecture diagram code" loading="lazy" /><p class="color-gray-500 text-sm mt-10">Stock photo for illustration only, not from the actual event</p></div><div class="ai-insight"><p>Transitioning away from annotation-heavy frameworks toward explicit listener interfaces often benefits enterprise applications by eliminating hidden 'magic' behaviors. Explicit pipelines and path listeners make debugging straightforward because the routing logic resides directly in the code rather than being inferred by background reflection scanners.</p></div><p>On the flip side, the listener pattern is remarkably easier to test—developers can simply instantiate the listener class and invoke its methods directly. Furthermore, it simplifies component composition, giving you explicit, readable routing pathways without the usual surprises associated with annotation scanning.</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-websocket-listener-interface-over-annotation-maze-3eja" target="_blank" rel="noopener noreferrer">Dev.to</a></p>

medium_solon-websocket-java-ms7ro01u.jpg

small_solon-websocket-java-ms7ro01u.jpg

thumbnail_solon-websocket-java-ms7ro01u.jpg

solon-websocket-java-ms7ro01u.jpg

เจาะลึกการทำงานของ Solon WebSocket ที่ฉีกแนวจากมาตรฐาน JSR-356 แบบเดิมๆ ด้วยรูปแบบ Listener Interface ที่ทดสอบและควบคุมง่ายกว่า

A deep dive into how Solon WebSocket diverges from standard Java JSR-356, offering a cleaner listener interface pattern that is easier to test and route.

ไขข้อข้องใจ Solon WebSocket ทำไมถึงไม่เหมือน Java มาตรฐาน

Decoding Solon WebSocket: Moving Beyond the Annotation Maze

Inewgen

Inewgen

#Solon

เจาะลึก Solon File Upload ใช้ UploadedFile จัดการไฟล์แทน MultipartFile

Inewgen

ไขข้อข้องใจ Solon WebSocket ทำไมถึงไม่เหมือน Java มาตรฐาน

Inewgen