SWFUpload是一个JavaScript库，它允许用户通过Flash技术实现无刷新的多文件上传。这个库在Web开发中尤其有用，因为它提供了用户友好的界面和高效的数据传输方式，同时减轻了服务器端的压力。以下是对SWFUpload工作原理和关键组件的详细说明：
1. **核心文件与目录结构**：
- `SWFUpload` 文件夹包含所有核心组件，包括Flash对象（`swfupload.swf`）和其他必需的JavaScript文件。
- `css` 文件夹存储样式表，用于自定义上传界面的外观。
- `images` 文件夹包含与上传过程相关的图像资源。
- `jslib` 文件夹包含JavaScript库，比如`swfupload.js`、`swfupload.queue.js`、`fileprogress.js`和`handlers.js`，这些文件分别处理基本功能、文件队列管理、进度显示和事件处理。
2. **事件处理**：
- `handlers.js` 文件是事件处理的核心，开发者可以在这里定义自定义的上传事件，如开始上传、取消、暂停等。
- `file_queued_handler` 会在文件被添加到队列时触发。
- `file_queue_error_handler` 处理文件队列中的错误。
- `file_dialog_complete_handler` 在文件选择对话框关闭时触发。
- `upload_start_handler` 文件开始上传时执行。
- `upload_progress_handler` 更新上传进度。
- `upload_error_handler` 处理上传过程中出现的错误。
3. **客户端设置**：
- `sample.html` 文件展示了如何在HTML页面中集成SWFUpload。它包含了必要的JavaScript引用和HTML结构。
- JavaScript代码段设置了SWFUpload的配置，如上传URL (`upload_url`)、文件大小限制 (`file_size_limit`)、文件类型 (`file_types`)、文件上传限制 (`file_upload_limit`) 和自定义参数 (`post_params`)。
4. **服务器端支持**：
- SWFUpload支持多种服务器端技术，例如Struts、Servlet和JSP。示例中使用了Struts1.x进行文件上传处理。
5. **多文件上传队列**：
- `swfupload.queue.js` 管理客户端选择的多个文件，它们被组织成一个队列，按顺序逐个上传到服务器。
- 用户可以通过设置限制(`file_queue_limit`)来控制队列中的最大文件数量。
6. **用户体验优化**：
- 通过Flash组件，SWFUpload可以提供一个具有拖放功能的用户界面，使得文件选择和上传过程更加直观。
- 用户还可以自定义按钮的外观和行为，通过`button_image_url`、`button_width`、`button_height`等属性调整。
7. **调试与兼容性**：
- `debug` 参数设置为`true`，会开启调试模式，显示详细的日志信息，帮助开发者解决问题。
- SWFUpload依赖Flash插件，因此不适用于不支持Flash的设备（如某些移动设备）。
SWFUpload是一个强大的多文件无刷新上传解决方案，它提供了丰富的定制选项和事件处理机制，便于开发者构建符合项目需求的上传功能。然而，随着技术的发展，现代浏览器逐渐弃用了Flash，因此在新项目中，开发者可能需要考虑使用HTML5的File API或者其他基于JavaScript的无插件上传库，如Plupload或Dropzone.js，以确保更广泛的兼容性和安全性。
