更换javax.mail依赖后，BASE64DecoderStream无法解析为类型的问题

问题情况 #

之前使用的JavaMail依赖是：

<dependency>
    <groupId>javax.mail</groupId>
    <artifactId>mail</artifactId>
    <version>1.4</version>
</dependency>

由于Java 8不支持该版本（依赖TLS 1.0），更换为：

<dependency>
    <groupId>javax.mail</groupId>
    <artifactId>javax.mail-api</artifactId>
    <version>1.6.0</version>
</dependency>

更换后，代码中com.sun.mail.util.BASE64DecoderStream出现无法解析类型的错误，Eclipse提示：

Multiple markers at this line
    - com.sun.mail.util.BASE64DecoderStream cannot be resolved to a type
    - com.sun.mail.util.BASE64DecoderStream cannot be resolved to a type

错误原因 #

javax.mail-api只是JavaMail的API规范包，仅包含抽象接口和核心API类，不包含com.sun.mail.util这类属于具体实现的类。旧的mail包是API+实现的整合包，所以之前能找到该类，拆分后只引入API包就会缺失实现类。

两种解决方式 #

方式一：添加JavaMail实现依赖 #

在pom.xml中补充引入对应版本的实现包，和javax.mail-api版本保持一致：

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.0</version>
</dependency>

添加后就能找到BASE64DecoderStream类，原代码无需修改。

方式二：改用API兼容的写法（推荐） #

避免依赖具体实现类，直接使用JavaMail API提供的通用方式读取内容。getContent()方法对于二进制邮件内容会返回InputStream，JavaMail会自动处理BASE64解码，无需强转成特定实现类：

if (p.getContentType().contains("image/")) {
    File f = new File("image" + new Date().getTime() + ".jpg");
    // 使用try-with-resources自动关闭流，避免资源泄漏
    try (DataOutputStream output = new DataOutputStream(
            new BufferedOutputStream(new FileOutputStream(f)));
         InputStream input = (InputStream) p.getContent()) {
        
        byte[] buffer = new byte[1024];
        int bytesRead;
        while ((bytesRead = input.read(buffer)) != -1) {
            output.write(buffer, 0, bytesRead);
        }
    } catch (IOException | MessagingException e) {
        // 根据业务需求处理异常
        e.printStackTrace();
    }
}

这种写法不依赖具体实现，兼容性更强，也符合面向接口编程的原则。

内容的提问来源于stack exchange，提问作者rob