Java获取文件后缀名的方法小结

更新时间：2025年05月21日 09:59:08 作者：李少兄

在Java开发中,尤其是Web应用或文件处理场景中,获取文件后缀名是一个高频需求,无论是文件上传验证、类型过滤、格式校验,还是日志记录,后缀名的正确提取都是核心基础,本文给大家介绍了Java获取文件后缀名的方法,需要的朋友可以参考下

前言
1. 基础方法：lastIndexOf + substring
2. 字符串分割：split 方法
3. 正则表达式
4. Apache Commons IO 的 FilenameUtils
5. Spring框架的 StringUtils
6. 使用 File 类
7. Java NIO的 Paths 类
8. 结合MIME类型验证
9. 自定义枚举过滤
10. 使用Lombok的 @Cleanup 简化代码
方法对比表
最佳实践建议
总结

前言

在Java开发中，尤其是Web应用或文件处理场景中，获取文件后缀名是一个高频需求。无论是文件上传验证、类型过滤、格式校验，还是日志记录，后缀名的正确提取都是核心基础。

1. 基础方法：lastIndexOf + substring

定义：通过定位最后一个 . 的位置，截取后缀名。

入参：MultipartFile file

依赖：无

代码示例：

public static String getExtension(MultipartFile file) {
    if (file == null) {
        return "";
    }
    String originalFilename = file.getOriginalFilename();
    if (originalFilename == null || originalFilename.isEmpty()) {
        return "";
    }
    int dotIndex = originalFilename.lastIndexOf('.');
    if (dotIndex == -1 || dotIndex == originalFilename.length() - 1) {
        return "";
    }
    return originalFilename.substring(dotIndex + 1).toLowerCase();
}

执行效果：

文件名 report_v2.2023.xlsx → 返回 xlsx
文件名 image. → 返回空字符串
文件名 .gitignore → 返回 gitignore

2. 字符串分割：split 方法

定义：通过 . 分割文件名，取最后一个元素。

入参：MultipartFile file

依赖：无

代码示例：

public static String getExtension(MultipartFile file) {
    if (file == null) {
        return "";
    }
    String originalFilename = file.getOriginalFilename();
    if (originalFilename == null) {
        return "";
    }
    String[] parts = originalFilename.split("\\.");
    return parts.length > 1 ? parts[parts.length - 1].toLowerCase() : "";
}

执行效果：

文件名 archive.v1.7z → 返回 7z
文件名 file → 返回空字符串

3. 正则表达式

定义：通过正则匹配最后一个 . 后的字符串。

入参：MultipartFile file

依赖：无

代码示例：

public static String getExtension(MultipartFile file) {
    if (file == null) {
        return "";
    }
    String originalFilename = file.getOriginalFilename();
    if (originalFilename == null) {
        return "";
    }
    Pattern pattern = Pattern.compile("\\.(\\w+)$");
    Matcher matcher = pattern.matcher(originalFilename);
    return matcher.find() ? matcher.group(1).toLowerCase() : "";
}

执行效果：

文件名 document.pdf → 返回 pdf
文件名 file.tar.gz → 返回 gz

4. Apache Commons IO 的 FilenameUtils

定义：使用 Apache Commons IO 的工具类。

入参：MultipartFile file

依赖：

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-io</artifactId>
    <version>9.0.0</version>
</dependency>

代码示例：

import org.apache.commons.io.FilenameUtils;

public static String getExtension(MultipartFile file) {
    if (file == null) {
        return "";
    }
    String originalFilename = file.getOriginalFilename();
    return FilenameUtils.getExtension(originalFilename).toLowerCase();
}

执行效果：

文件名 file.txt → 返回 txt
文件名 file. → 返回空字符串

5. Spring框架的 StringUtils

定义：使用 Spring 的工具类。

入参：MultipartFile file

依赖：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <version>6.0.10</version>
</dependency>

代码示例：

import org.springframework.util.StringUtils;

public static String getExtension(MultipartFile file) {
    if (file == null) {
        return "";
    }
    String originalFilename = file.getOriginalFilename();
    return StringUtils.getFilenameExtension(originalFilename);
}

执行效果：

文件名 image.jpg → 返回 jpg
返回值为 null 时需注意空指针（如 file 无扩展名）。

6. 使用 File 类

定义：通过构造 File 对象提取文件名。

入参：MultipartFile file

依赖：无

代码示例：

import java.io.File;

public static String getExtension(MultipartFile file) {
    if (file == null) {
        return "";
    }
    String originalFilename = file.getOriginalFilename();
    if (originalFilename == null) {
        return "";
    }
    File tempFile = new File(originalFilename);
    String name = tempFile.getName();
    int dotIndex = name.lastIndexOf('.');
    return (dotIndex > 0 && dotIndex < name.length() - 1) 
        ? name.substring(dotIndex + 1).toLowerCase() 
        : "";
}

执行效果：

文件名 data.csv → 返回 csv
文件名 config. → 返回空字符串

7. Java NIO的 Paths 类

定义：通过 java.nio.file 包处理路径。

入参：MultipartFile file

依赖：无

代码示例：

import java.nio.file.Path;
import java.nio.file.Paths;

public static String getExtension(MultipartFile file) {
    if (file == null) {
        return "";
    }
    String originalFilename = file.getOriginalFilename();
    if (originalFilename == null) {
        return "";
    }
    Path path = Paths.get(originalFilename);
    String name = path.getFileName().toString();
    return name.substring(name.lastIndexOf('.') + 1).toLowerCase();
}

执行效果：

文件名 report.pdf → 返回 pdf
跨平台兼容性好（如路径 /home/file.txt → 提取 txt）。

8. 结合MIME类型验证

定义：通过 MultipartFile.getContentType() 验证后缀。

入参：MultipartFile file

依赖：无

代码示例：

public static boolean validateFile(MultipartFile file) {
    String ext = getExtension(file); // 使用上述任意方法
    String contentType = file.getContentType();
    return ext.equals("jpg") && contentType.equals("image/jpeg");
}

执行效果：

文件名 image.jpg 且 MIME 为 image/jpeg → 返回 true
文件名 image.png 但 MIME 为 image/jpeg → 返回 false

9. 自定义枚举过滤

定义：通过枚举限定允许的后缀。

入参：MultipartFile file

代码示例：

enum FileType {
    PNG, JPG, JPEG, GIF;

    public static boolean isValid(String ext) {
        for (FileType type : FileType.values()) {
            if (type.name().equalsIgnoreCase(ext)) {
                return true;
            }
        }
        return false;
    }
}

public static String getValidExtension(MultipartFile file) {
    String ext = getExtension(file);
    return FileType.isValid(ext) ? ext : "";
}

执行效果：

文件名 photo.jpg → 返回 jpg
文件名 image.bmp → 返回空字符串

10. 使用Lombok的 @Cleanup 简化代码

定义：通过 Lombok 减少资源管理代码。

入参：MultipartFile file

依赖：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.28</version>
    <scope>provided</scope>
</dependency>

代码示例：

import lombok.Cleanup;

public static String getExtension(MultipartFile file) {
    if (file == null) {
        return "";
    }
    @Cleanup
    InputStream inputStream = file.getInputStream();
    // 其他逻辑（如读取文件内容）
    return "ext"; // 示例返回值
}

执行效果：

自动关闭 inputStream，无需手动管理资源。

方法对比表

方法	依赖	边界处理	性能	适用场景
`lastIndexOf` + `substring`	无	完善（需手动处理）	高	简单场景，无依赖要求
`split`	无	简单（需数组长度判断）	中	快速实现，无特殊需求
正则表达式	无	灵活（正则可扩展）	中	需复杂匹配时
Apache Commons IO	`commons-io`	自动处理	高	需多文件操作功能
Spring `StringUtils`	`spring-core`	自动处理	高	Spring生态内使用
`File` 类	无	基础	中	需路径处理时
Java NIO `Paths`	无	基础	中	现代API，跨平台需求
MIME类型验证	无	依赖MIME类型	高	安全验证场景

最佳实践建议

依赖选择：
- 零依赖场景：优先使用 lastIndexOf 或 split。
- 复杂需求：使用 Apache Commons IO 或 Spring 的 StringUtils。
边界情况处理：
- 文件名以 . 开头（如 .gitignore）：返回后缀 gitignore。
- 文件名无扩展名（如 file）：返回空字符串。
- 文件名以 . 结尾（如 file.）：返回空字符串。
后缀统一小写：
- 使用 toLowerCase() 避免大小写敏感问题（如 JPG → jpg）。
安全验证：
- 结合MIME类型与后缀双重校验（如 image/jpeg 与 jpg）。

总结

针对 MultipartFile 的后缀名获取，选择需结合项目需求：

基础场景：推荐 lastIndexOf 或 Apache Commons IO。
Spring生态：直接使用 StringUtils.getFilenameExtension。
安全敏感场景：结合MIME类型验证。

以上就是Java获取文件后缀名的方法小结的详细内容，更多关于Java获取文件后缀名的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

解决mybatis-generator生成Mapper文件没有Selective结尾的问题
这篇文章主要介绍了解决mybatis-generator生成Mapper文件没有Selective结尾的问题，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-09-09
Java发送邮件javax.mail的实现方法
这篇文章主要为大家介绍了Java发送邮件javax.mail的实现方法，具有一定的参考价值，代码都有详细的注释，感兴趣的小伙伴们可以参考一下
2016-01-01
mybatis修改int型数据无法修改成0的解决
这篇文章主要介绍了mybatis修改int型数据无法修改成0的解决方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-09-09
Java如何利用Socket传输信息或文件
这篇文章主要介绍了Java如何利用Socket传输信息或文件问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-08-08
java实现日历功能
这篇文章主要为大家详细介绍了java实现日历功能，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-06-06
Java8 Predicate花样用法详解
本文主要介绍了Java 8 Predicate花样用法详解，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-03-03
解决springboot报错Failed to parse multipart servlet request
在使用SpringBoot开发时,通过Postman发送POST请求,可能会遇到因临时目录不存在而导致的MultipartException异常,这通常是因为OS系统（如CentOS）定期删除/tmp目录下的临时文件,解决方案包括重启项目
2024-10-10
ActiveMQ结合Spring收发消息的示例代码
这篇文章主要介绍了ActiveMQ结合Spring收发消息的示例代码，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-10-10
Java 从json提取数组并转换为list的操作方法
这篇文章主要介绍了Java 从json提取出数组并转换为list,使用getJSONArray()获取到jsonarray后，再将jsonArray转换为字符串，最后将字符串解析为List列表，本文通过实例代码给大家详细讲解，需要的朋友可以参考下
2022-10-10
Java动态数组ArrayList实现动态原理
ArrayList是一种动态数组,它可以在运行时自动调整大小以适应元素的添加和删除,在Java中,你可以使用ArrayList类来实现动态数组,本文将给大家介绍一下ArrayList动态数组,是怎么实现动态的
2023-08-08