style: 删除无效参数注释

This commit is contained in:
daiomina 2021-01-02 18:14:48 +08:00
parent 8a18873b81
commit 56a252857f
1 changed files with 202 additions and 203 deletions

View File

@ -1,204 +1,203 @@
package com.ruoyi.file.utils; package com.ruoyi.file.utils;
import java.io.File; import java.io.File;
import java.io.IOException; import java.io.IOException;
import org.apache.commons.io.FilenameUtils; import org.apache.commons.io.FilenameUtils;
import org.springframework.beans.factory.annotation.Value; import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.multipart.MultipartFile; import org.springframework.web.multipart.MultipartFile;
import com.ruoyi.common.core.exception.file.FileNameLengthLimitExceededException; import com.ruoyi.common.core.exception.file.FileNameLengthLimitExceededException;
import com.ruoyi.common.core.exception.file.FileSizeLimitExceededException; import com.ruoyi.common.core.exception.file.FileSizeLimitExceededException;
import com.ruoyi.common.core.exception.file.InvalidExtensionException; import com.ruoyi.common.core.exception.file.InvalidExtensionException;
import com.ruoyi.common.core.utils.DateUtils; import com.ruoyi.common.core.utils.DateUtils;
import com.ruoyi.common.core.utils.IdUtils; import com.ruoyi.common.core.utils.IdUtils;
import com.ruoyi.common.core.utils.StringUtils; import com.ruoyi.common.core.utils.StringUtils;
import com.ruoyi.common.core.utils.file.MimeTypeUtils; import com.ruoyi.common.core.utils.file.MimeTypeUtils;
/** /**
* 文件上传工具类 * 文件上传工具类
* *
* @author ruoyi * @author ruoyi
*/ */
public class FileUploadUtils public class FileUploadUtils
{ {
/** /**
* 默认大小 50M * 默认大小 50M
*/ */
public static final long DEFAULT_MAX_SIZE = 50 * 1024 * 1024; public static final long DEFAULT_MAX_SIZE = 50 * 1024 * 1024;
/** /**
* 默认的文件名最大长度 100 * 默认的文件名最大长度 100
*/ */
public static final int DEFAULT_FILE_NAME_LENGTH = 100; public static final int DEFAULT_FILE_NAME_LENGTH = 100;
/** /**
* 资源映射路径 前缀 * 资源映射路径 前缀
*/ */
@Value("${file.prefix}") @Value("${file.prefix}")
public String localFilePrefix; public String localFilePrefix;
/** /**
* 根据文件路径上传 * 根据文件路径上传
* *
* @param baseDir 相对应用的基目录 * @param baseDir 相对应用的基目录
* @param file 上传的文件 * @param file 上传的文件
* @return 文件名称 * @return 文件名称
* @throws IOException * @throws IOException
*/ */
public static final String upload(String baseDir, MultipartFile file) throws IOException public static final String upload(String baseDir, MultipartFile file) throws IOException
{ {
try try
{ {
return upload(baseDir, file, MimeTypeUtils.DEFAULT_ALLOWED_EXTENSION); return upload(baseDir, file, MimeTypeUtils.DEFAULT_ALLOWED_EXTENSION);
} }
catch (Exception e) catch (Exception e)
{ {
throw new IOException(e.getMessage(), e); throw new IOException(e.getMessage(), e);
} }
} }
/** /**
* 文件上传 * 文件上传
* *
* @param baseDir 相对应用的基目录 * @param baseDir 相对应用的基目录
* @param file 上传的文件 * @param file 上传的文件
* @param extension 上传文件类型 * @return 返回上传成功的文件名
* @return 返回上传成功的文件名 * @throws FileSizeLimitExceededException 如果超出最大大小
* @throws FileSizeLimitExceededException 如果超出最大大小 * @throws FileNameLengthLimitExceededException 文件名太长
* @throws FileNameLengthLimitExceededException 文件名太长 * @throws IOException 比如读写文件出错时
* @throws IOException 比如读写文件出错时 * @throws InvalidExtensionException 文件校验异常
* @throws InvalidExtensionException 文件校验异常 */
*/ public static final String upload(String baseDir, MultipartFile file, String[] allowedExtension)
public static final String upload(String baseDir, MultipartFile file, String[] allowedExtension) throws FileSizeLimitExceededException, IOException, FileNameLengthLimitExceededException,
throws FileSizeLimitExceededException, IOException, FileNameLengthLimitExceededException, InvalidExtensionException
InvalidExtensionException {
{ int fileNamelength = file.getOriginalFilename().length();
int fileNamelength = file.getOriginalFilename().length(); if (fileNamelength > FileUploadUtils.DEFAULT_FILE_NAME_LENGTH)
if (fileNamelength > FileUploadUtils.DEFAULT_FILE_NAME_LENGTH) {
{ throw new FileNameLengthLimitExceededException(FileUploadUtils.DEFAULT_FILE_NAME_LENGTH);
throw new FileNameLengthLimitExceededException(FileUploadUtils.DEFAULT_FILE_NAME_LENGTH); }
}
assertAllowed(file, allowedExtension);
assertAllowed(file, allowedExtension);
String fileName = extractFilename(file);
String fileName = extractFilename(file);
File desc = getAbsoluteFile(baseDir, fileName);
File desc = getAbsoluteFile(baseDir, fileName); file.transferTo(desc);
file.transferTo(desc); String pathFileName = getPathFileName(fileName);
String pathFileName = getPathFileName(fileName); return pathFileName;
return pathFileName; }
}
/**
/** * 编码文件名
* 编码文件名 */
*/ public static final String extractFilename(MultipartFile file)
public static final String extractFilename(MultipartFile file) {
{ String fileName = file.getOriginalFilename();
String fileName = file.getOriginalFilename(); String extension = getExtension(file);
String extension = getExtension(file); fileName = DateUtils.datePath() + "/" + IdUtils.fastUUID() + "." + extension;
fileName = DateUtils.datePath() + "/" + IdUtils.fastUUID() + "." + extension; return fileName;
return fileName; }
}
private static final File getAbsoluteFile(String uploadDir, String fileName) throws IOException
private static final File getAbsoluteFile(String uploadDir, String fileName) throws IOException {
{ File desc = new File(uploadDir + File.separator + fileName);
File desc = new File(uploadDir + File.separator + fileName);
if (!desc.exists())
if (!desc.exists()) {
{ if (!desc.getParentFile().exists())
if (!desc.getParentFile().exists()) {
{ desc.getParentFile().mkdirs();
desc.getParentFile().mkdirs(); }
} }
} return desc;
return desc; }
}
private static final String getPathFileName(String fileName) throws IOException
private static final String getPathFileName(String fileName) throws IOException {
{ String pathFileName = "/" + fileName;
String pathFileName = "/" + fileName; return pathFileName;
return pathFileName; }
}
/**
/** * 文件大小校验
* 文件大小校验 *
* * @param file 上传的文件
* @param file 上传的文件 * @return
* @return * @throws FileSizeLimitExceededException 如果超出最大大小
* @throws FileSizeLimitExceededException 如果超出最大大小 * @throws InvalidExtensionException
* @throws InvalidExtensionException */
*/ public static final void assertAllowed(MultipartFile file, String[] allowedExtension)
public static final void assertAllowed(MultipartFile file, String[] allowedExtension) throws FileSizeLimitExceededException, InvalidExtensionException
throws FileSizeLimitExceededException, InvalidExtensionException {
{ long size = file.getSize();
long size = file.getSize(); if (DEFAULT_MAX_SIZE != -1 && size > DEFAULT_MAX_SIZE)
if (DEFAULT_MAX_SIZE != -1 && size > DEFAULT_MAX_SIZE) {
{ throw new FileSizeLimitExceededException(DEFAULT_MAX_SIZE / 1024 / 1024);
throw new FileSizeLimitExceededException(DEFAULT_MAX_SIZE / 1024 / 1024); }
}
String fileName = file.getOriginalFilename();
String fileName = file.getOriginalFilename(); String extension = getExtension(file);
String extension = getExtension(file); if (allowedExtension != null && !isAllowedExtension(extension, allowedExtension))
if (allowedExtension != null && !isAllowedExtension(extension, allowedExtension)) {
{ if (allowedExtension == MimeTypeUtils.IMAGE_EXTENSION)
if (allowedExtension == MimeTypeUtils.IMAGE_EXTENSION) {
{ throw new InvalidExtensionException.InvalidImageExtensionException(allowedExtension, extension,
throw new InvalidExtensionException.InvalidImageExtensionException(allowedExtension, extension, fileName);
fileName); }
} else if (allowedExtension == MimeTypeUtils.FLASH_EXTENSION)
else if (allowedExtension == MimeTypeUtils.FLASH_EXTENSION) {
{ throw new InvalidExtensionException.InvalidFlashExtensionException(allowedExtension, extension,
throw new InvalidExtensionException.InvalidFlashExtensionException(allowedExtension, extension, fileName);
fileName); }
} else if (allowedExtension == MimeTypeUtils.MEDIA_EXTENSION)
else if (allowedExtension == MimeTypeUtils.MEDIA_EXTENSION) {
{ throw new InvalidExtensionException.InvalidMediaExtensionException(allowedExtension, extension,
throw new InvalidExtensionException.InvalidMediaExtensionException(allowedExtension, extension, fileName);
fileName); }
} else if (allowedExtension == MimeTypeUtils.VIDEO_EXTENSION)
else if (allowedExtension == MimeTypeUtils.VIDEO_EXTENSION) {
{ throw new InvalidExtensionException.InvalidVideoExtensionException(allowedExtension, extension,
throw new InvalidExtensionException.InvalidVideoExtensionException(allowedExtension, extension, fileName);
fileName); }
} else
else {
{ throw new InvalidExtensionException(allowedExtension, extension, fileName);
throw new InvalidExtensionException(allowedExtension, extension, fileName); }
} }
} }
}
/**
/** * 判断MIME类型是否是允许的MIME类型
* 判断MIME类型是否是允许的MIME类型 *
* * @param extension
* @param extension * @param allowedExtension
* @param allowedExtension * @return
* @return */
*/ public static final boolean isAllowedExtension(String extension, String[] allowedExtension)
public static final boolean isAllowedExtension(String extension, String[] allowedExtension) {
{ for (String str : allowedExtension)
for (String str : allowedExtension) {
{ if (str.equalsIgnoreCase(extension))
if (str.equalsIgnoreCase(extension)) {
{ return true;
return true; }
} }
} return false;
return false; }
}
/**
/** * 获取文件名的后缀
* 获取文件名的后缀 *
* * @param file 表单文件
* @param file 表单文件 * @return 后缀名
* @return 后缀名 */
*/ public static final String getExtension(MultipartFile file)
public static final String getExtension(MultipartFile file) {
{ String extension = FilenameUtils.getExtension(file.getOriginalFilename());
String extension = FilenameUtils.getExtension(file.getOriginalFilename()); if (StringUtils.isEmpty(extension))
if (StringUtils.isEmpty(extension)) {
{ extension = MimeTypeUtils.getExtension(file.getContentType());
extension = MimeTypeUtils.getExtension(file.getContentType()); }
} return extension;
return extension; }
}
} }