bootstrap fileinput和Select2不被注意的坑

本文探讨了在项目中使用fileinput和select2插件时遇到的问题:重复初始化导致向服务器发送多余请求。通过在每次初始化前取消已注册的click、change及filebatchuploadsuccess事件,确保了每次操作只发送一次请求。

很多时候我们会在项目中使用插件,比如fileinput和select2 都用到了,使用过程中没有什么问题,但是最后测试的时候,F12在页面发现每次初始化插件之后,关闭窗口都不会自动销毁,再次点击会默认为第二次初始化。所以多次点击之后,会看到向后台请求了多次URL。如何解决这个问题呢?

插件都提供了destroy方法,在每次初始化之前调用$("#DIV的ID的name").fileinput('destroy');都不起作用。

debugger之后,发现多次初始化之后在我们需要触发的click事件在向服务器按照初始化的次数多次发送请求,因为每次初始化之后我们都注册了click事件,所以在初始化之前先关闭注册的click事件:

在项目中,select2是在注册change事件的时候发送请求给服务器,所以在初始化之前关闭change事件,$ ("#envSelect").off('change');

fileinput是在上传文件成功之后filebatchuploadsuccess事件多次向服务器发送请求。所以初始化之前关闭filebatchuploadsuccess事件。

$ ("#uploadConfigFile").off('filebatchuploadsuccess');

之后发现每次点击都默认是新的初始化,只发送一次请求到服务器。

<think>我们正在讨论的是Bootstrap FileInput多文件上传与编辑功能实现。根据引用[1]引用[2],我们可以总结出以下关键点: 1. 前端使用Bootstrap FileInput组件实现多文件上传,包括选择文件、显示文件列表、上传等功能。 2. 编辑功能包括已上传文件的回显(再次编辑时显示之前上传的文件)新增文件同时显示。 3. 后端需要提供文件上传接口,并且前端在上传后需要接收文件信息(如文件名、URL、缩略图等)用于显示。 根据用户上一次的问题(bootstrapfileinput多文件上传 springboot后端编辑实例)以及引用内容,我们将分为以下几个部分实现: 一、前端实现(使用Bootstrap FileInput) 二、后端实现(Spring Boot) 三、编辑回显与再次新增 一、前端实现(使用Bootstrap FileInput) 1. 引入必要的CSSJS文件。 2. 初始化FileInput组件,配置上传地址、允许的文件类型、最大文件数量、是否允许多文件等。 3. 配置预览,包括初始预览(initialPreview)初始预览配置(initialPreviewConfig)用于回显已上传的文件。 4. 配置上传成功后的回调,处理服务器返回的文件信息。 二、后端实现(Spring Boot) 1. 文件上传接口:接收MultipartFile数组,保存文件,并返回文件信息(包括文件名、URL、大小等,参考引用[2]中的FileVO类)。 2. 文件删除接口(可选,用于删除已上传的文件)。 3. 文件下载接口(用于回显时获取文件,或提供下载)。 三、编辑回显与再次新增 1. 在编辑页面,从后端获取已上传的文件列表,并初始化FileInput组件的initialPreviewinitialPreviewConfig。 2. 当用户再次新增文件时,FileInput组件会自动将新文件添加到文件列表中,并显示出来。 下面我们分别展开: 一、前端实现(详细步骤) 1. HTML结构: ```html <input id="file-input" type="file" name="files" multiple> ``` 2. JavaScript初始化: ```javascript $(document).ready(function() { // 初始化FileInput $("#file-input").fileinput({ language: 'zh', // 语言 uploadUrl: '/api/files/upload', // 上传地址 allowedFileExtensions: ['jpg', 'jpeg', 'png', 'gif', 'pdf'], // 允许的文件类型 maxFileCount: 10, // 最大文件数量 showUpload: true, // 显示上传按钮 showRemove: true, // 显示移除按钮 showCaption: false, // 是否显示标题 dropZoneEnabled: true, // 是否显示拖拽区域 // 初始预览配置(用于回显) initialPreview: [ // 这里放置预览内容,可以是图片的<img>标签,也可以是其他文件的<a>标签等 // 例如:'<img src="/api/files/download/1.jpg" class="file-preview-image">' ], initialPreviewConfig: [ // 每个预览项的配置 // 例如:{caption: "1.jpg", size: 12345, url: '/api/files/delete', key: 1} ], initialPreviewAsData: true, // 设置为true,则initialPreview中的内容将被解析为数据(如URL)而是直接显示HTML overwriteInitial: false, // 是否覆盖初始预览,设置为false则可以在初始预览基础上添加新文件 // 其他配置... }).on('fileuploaded', function(event, data) { // 文件上传成功后的回调 var response = data.response; if (response.success) { // 可以在这里将上传成功的文件信息添加到某个隐藏域中,或者更新已上传文件列表 console.log('文件上传成功', response.files); } }).on('fileremoved', function(event, id) { // 移除文件时的回调(id为文件在预览中的索引,或者配置中的key值) // 可以在这里发送请求删除服务器上的文件 console.log('文件被移除', id); }); }); ``` 二、后端实现(Spring Boot) 1. 文件上传接口: ```java @RestController @RequestMapping("/api/files") public class FileController { @Value("${file.upload-dir}") private String uploadDir; @PostMapping("/upload") public ResponseEntity<?> uploadFiles(@RequestParam("files") MultipartFile[] files) { List<FileVO> fileList = new ArrayList<>(); for (MultipartFile file : files) { // 保存文件 String filename = saveFile(file); // 构建FileVO对象(参考引用[2]) FileVO fileVO = new FileVO(); fileVO.setName(file.getOriginalFilename()); fileVO.setUrl("/api/files/download/" + filename); // 下载URL fileVO.setSize(formatFileSize(file.getSize())); // 如果是图片,可以生成缩略图URL,否则使用默认图标 if (isImage(file)) { fileVO.setThumbnailPic("/api/files/thumbnail/" + filename); } else { fileVO.setThumbnailPic("/path/to/default/thumbnail"); } fileList.add(fileVO); } // 返回结果 Map<String, Object> result = new HashMap<>(); result.put("success", true); result.put("files", fileList); return ResponseEntity.ok(result); } private String saveFile(MultipartFile file) { // 保存文件到uploadDir,返回保存的文件名(可以使用UUID避免重复) // 省略具体实现 } private boolean isImage(MultipartFile file) { // 判断文件是否为图片 String contentType = file.getContentType(); return contentType != null && contentType.startsWith("image"); } } ``` 2. 文件下载接口: ```java @GetMapping("/download/{filename}") public ResponseEntity<Resource> downloadFile(@PathVariable String filename) throws IOException { Path filePath = Paths.get(uploadDir).resolve(filename).normalize(); Resource resource = new UrlResource(filePath.toUri()); if (resource.exists()) { return ResponseEntity.ok() .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + resource.getFilename() + "\"") .body(resource); } else { throw new FileNotFoundException("文件未找到: " + filename); } } ``` 3. 文件删除接口(可选): ```java @DeleteMapping("/delete/{filename}") public ResponseEntity<?> deleteFile(@PathVariable String filename) { // 删除文件 Path filePath = Paths.get(uploadDir).resolve(filename).normalize(); try { Files.delete(filePath); return ResponseEntity.ok().body(Map.of("success", true)); } catch (IOException e) { return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR) .body(Map.of("success", false, "error", e.getMessage())); } } ``` 三、编辑回显与再次新增 在编辑页面,我们需要从后端获取当前记录已上传的文件列表,然后将其设置到FileInput的初始预览中。 1. 后端提供获取文件列表的接口(根据业务ID): ```java @GetMapping("/list") public ResponseEntity<List<FileVO>> getFiles(@RequestParam("businessId") Long businessId) { // 根据业务ID查询文件列表 List<FileVO> fileList = fileService.findByBusinessId(businessId); return ResponseEntity.ok(fileList); } ``` 2. 前端在初始化FileInput组件之前,先通过AJAX获取已上传的文件列表,然后设置initialPreviewinitialPreviewConfig: ```javascript // 假设我们已经获取了文件列表数据,存储在fileList变量中 var initialPreview = []; var initialPreviewConfig = []; fileList.forEach(function(file) { // 如果是图片,使用img标签 if (file.type.startsWith('image')) { initialPreview.push('<img src="' + file.thumbnailPic + '" class="file-preview-image">'); } else { // 其他文件类型,显示一个文件图标文件名 initialPreview.push('<div class="file-preview-other"><i class="fa fa-file"></i> ' + file.name + '</div>'); } initialPreviewConfig.push({ caption: file.name, size: file.size, url: '/api/files/delete', // 删除URL key: file.id, // 文件唯一标识,用于删除时传给服务器 extra: {id: file.id} // 额外参数 }); }); // 初始化FileInput时传入这些初始预览数据 $("#file-input").fileinput({ // ...其他配置... initialPreview: initialPreview, initialPreviewConfig: initialPreviewConfig }); ``` 3. 当用户移除一个文件时,我们可能需要删除服务器上的文件(通过配置的urlkey): ```javascript .on('fileremoved', function(event, id, index) { // 这里id就是配置中的key,我们可以发送一个删除请求 var config = initialPreviewConfig[index]; $.ajax({ url: config.url, type: 'DELETE', data: {id: config.key}, // 或者从extra中取 success: function(result) { console.log('文件删除成功'); } }); }); ``` 4. 当用户新增文件时,FileInput组件会自动上传到服务器,并在上传成功后触发fileuploaded事件,我们可以将新文件的信息添加到已上传文件列表中。 这样,我们就实现了多文件上传、编辑回显再次新增的功能。 注意事项: - 文件删除操作需要谨慎,确保只有拥有权限的用户才能删除。 - 在编辑时,如果用户删除了一个已存在的文件,除了从预览中移除,还需要从服务器删除,因此需要记录每个文件的唯一标识(如id)并发送删除请求。 以上是一个完整的实现方案,根据实际业务需求可能需要进行调整。</think>### Bootstrap FileInput 多文件上传与编辑功能实现 #### 一、前端实现(Bootstrap FileInput) ##### 1. 基础文件上传组件 ```html <input id="file-input" type="file" name="files[]" multiple> ``` ##### 2. 初始化配置(带编辑回显) ```javascript // 从后端获取已上传文件数据(编辑时使用) const initialFiles = [ { id: 101, name: "document.pdf", url: "/files/download/101", thumbnailPic: "/files/thumb/101", size: "2.5 MB", type: "application/pdf" }, // 更多文件数据... ]; $('#file-input').fileinput({ language: 'zh', uploadUrl: '/api/files/upload', deleteUrl: '/api/files/delete', allowedFileExtensions: ['jpg', 'png', 'pdf', 'docx'], maxFileCount: 10, showUpload: true, showRemove: true, showCaption: false, dropZoneEnabled: true, // 编辑回显配置 initialPreview: initialFiles.map(file => file.type.includes('image') ? `<img src="${file.thumbnailPic}" class="file-preview-image">` : `<div class="file-preview-other">${file.name}</div>` ), initialPreviewConfig: initialFiles.map(file => ({ caption: file.name, size: file.size, url: file.url, key: file.id, // 用于后端识别 extra: { id: file.id } // 额外参数 })), initialPreviewAsData: true, overwriteInitial: false, // 保留初始文件同时允许新增 fileActionSettings: { showRemove: true, showUpload: false, showZoom: true } }); ``` ##### 3. 事件处理 ```javascript // 文件上传成功 $('#file-input').on('fileuploaded', function(event, data) { const file = data.response.file; console.log(`上传成功: ${file.originalName} (ID: ${file.id})`); }); // 文件删除成功 $('#file-input').on('filedeleted', function(event, key) { console.log(`删除文件 ID: ${key}`); $.ajax({ url: '/api/files/delete', type: 'POST', data: { id: key } }); }); // 新增文件预览 $('#file-input').on('fileselect', function(event, files) { console.log(`新增 ${files.length} 个文件`); }); ``` #### 二、后端实现(Spring Boot) ##### 1. 文件信息实体类 ```java public class FileVO { private Integer id; // 文件ID private String name; // 原始文件名 private String url; // 访问URL private String size; // 文件大小 private String thumbnailPic;// 缩略图URL private String type; // MIME类型 // 构造方法/getters/setters } ``` ##### 2. 文件上传控制器 ```java @PostMapping("/upload") public ResponseEntity<Map<String, Object>> uploadFiles( @RequestParam("files") MultipartFile[] files, @RequestParam(value = "businessId", required = false) Integer businessId) { Map<String, Object> response = new HashMap<>(); List<FileVO> uploadedFiles = new ArrayList<>(); for (MultipartFile file : files) { FileVO fileVO = fileStorageService.storeFile(file, businessId); uploadedFiles.add(fileVO); } response.put("success", true); response.put("files", uploadedFiles); return ResponseEntity.ok(response); } ``` ##### 3. 文件存储服务 ```java @Service public class FileStorageService { @Value("${file.upload-dir}") private String uploadDir; public FileVO storeFile(MultipartFile file, Integer businessId) { // 生成唯一文件名 String fileName = UUID.randomUUID() + "_" + file.getOriginalFilename(); Path targetLocation = Paths.get(uploadDir).resolve(fileName); // 保存文件 Files.copy(file.getInputStream(), targetLocation, StandardCopyOption.REPLACE_EXISTING); // 生成缩略图(如果是图片) String thumbnail = generateThumbnail(file, fileName); // 保存到数据库 FileEntity entity = new FileEntity(); entity.setOriginalName(file.getOriginalFilename()); entity.setStoredName(fileName); entity.setSize(file.getSize()); entity.setBusinessId(businessId); entity = fileRepository.save(entity); // 返回VO对象 return new FileVO( entity.getId(), file.getOriginalFilename(), "/api/files/download/" + fileName, formatFileSize(file.getSize()), thumbnail, file.getContentType() ); } private String generateThumbnail(MultipartFile file, String fileName) { if (file.getContentType().startsWith("image")) { // 使用Thumbnailator生成缩略图 Path thumbPath = Paths.get(uploadDir, "thumbs", fileName); Thumbnails.of(file.getInputStream()) .size(200, 200) .toFile(thumbPath.toFile()); return "/api/files/thumb/" + fileName; } return null; } } ``` ##### 4. 文件删除接口 ```java @PostMapping("/delete") public ResponseEntity<?> deleteFile(@RequestParam("id") Integer id) { Optional<FileEntity> fileOpt = fileRepository.findById(id); if (fileOpt.isPresent()) { FileEntity file = fileOpt.get(); // 删除物理文件 Path filePath = Paths.get(uploadDir, file.getStoredName()); Files.deleteIfExists(filePath); // 删除缩略图 Path thumbPath = Paths.get(uploadDir, "thumbs", file.getStoredName()); Files.deleteIfExists(thumbPath); // 删除数据库记录 fileRepository.delete(file); return ResponseEntity.ok(Map.of("success", true)); } return ResponseEntity.notFound().build(); } ``` #### 三、编辑回显实现 ##### 1. 获取业务关联文件 ```java @GetMapping("/list") public ResponseEntity<List<FileVO>> getFilesByBusiness( @RequestParam("businessId") Integer businessId) { List<FileEntity> entities = fileRepository.findByBusinessId(businessId); List<FileVO> files = entities.stream().map(entity -> new FileVO( entity.getId(), entity.getOriginalName(), "/api/files/download/" + entity.getStoredName(), formatFileSize(entity.getSize()), entity.getContentType().startsWith("image") ? "/api/files/thumb/" + entity.getStoredName() : null, entity.getContentType() ) ).collect(Collectors.toList()); return ResponseEntity.ok(files); } ``` ##### 2. 前端初始化时加载 ```javascript // 编辑页面加载时获取已上传文件 const businessId = 123; // 当前编辑的业务ID $.get(`/api/files/list?businessId=${businessId}`, function(files) { $('#file-input').fileinput('init', { initialPreview: files.map(file => /* 预览HTML */), initialPreviewConfig: files.map(file => /* 配置对象 */) }); }); ``` #### 四、关键功能说明 1. **编辑回显机制**: - 使用 `initialPreview` `initialPreviewConfig` 初始化已存在文件 - `overwriteInitial: false` 允许在已有文件基础上新增 2. **业务关联**: - 通过 `businessId` 关联文件与业务实体 - 编辑时加载该业务的所有关联文件 3. **缩略图生成**: - 使用 Thumbnailator 库自动生成图片缩略图 - 前端根据文件类型显示同预览样式 4. **完整生命周期管理**: - 文件上传 → 数据库记录 → 编辑回显 → 删除清理 - 物理文件数据库记录同步管理 #### 五、最佳实践建议 1. **文件存储优化**: ```java // 使用云存储服务 public class S3FileStorage implements FileStorage { public String storeFile(MultipartFile file) { // 上传到AWS S3/Aliyun OSS return s3Client.putObject(bucketName, fileName, file.getInputStream()); } } ``` 2. **前端验证增强**: ```javascript $('#file-input').fileinput({ // ... validateInitialCount: true, maxFileSize: 5120, // 5MB msgSizeTooLarge: '文件大小超过限制' }); ``` 3. **后端安全防护**: ```java // 文件类型白名单验证 private void validateFileType(MultipartFile file) { String[] allowedTypes = {"image/jpeg", "application/pdf"}; if (!Arrays.asList(allowedTypes).contains(file.getContentType())) { throw new InvalidFileTypeException(); } } ``` > **提示**:对于复杂编辑场景,建议使用 `initialPreviewThumbTags` 实现自定义预览区域[^1],结合后端分片上传技术处理大文件[^2]。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值