Java I/O操作中多异常抛出的最佳实现方式问询

实现要点 #

1. NullPointerException处理：显式检查入参reader是否为null，主动抛出带明确提示的NPE。虽然JDK在创建BufferedReader时传入null也会自动抛NPE，但显式检查能提供更清晰的错误信息，符合代码可读性规范。
2. IOException处理：直接依托BufferedReader读取方法（如readLine()）抛出的IO异常，通过方法签名声明throws IOException即可，无需额外嵌套try-catch——冗余的catch会导致IntelliJ提示“无法到达”。
3. FileFormatException处理：在解析文件内容的过程中，一旦检测到格式不符合预期（比如行数不足、字符长度不对、内容非法等），直接抛出自定义的FileFormatException即可。

完整代码示例 #

自定义FileFormatException

public class FileFormatException extends Exception {
    public FileFormatException(String message) {
        super(message);
    }

    public FileFormatException(String message, Throwable cause) {
        super(message, cause);
    }
}

完善后的GameLoader类

import java.io.BufferedReader;
import java.io.IOException;
import java.io.Reader;

public class GameLoader {

    public GameLoader() {
    }

    /**
     * Loads a game grid from a text file.
     *
     * @param reader a {@code Reader} object that reads from the text file
     * @return the loaded game grid
     * @throws IOException if there is an error reading from the file
     * @throws FileFormatException if the file format is invalid
     * @throws NullPointerException if reader is null
     */
    public static GameGrid load(Reader reader) throws IOException, FileFormatException {
        // 显式检查空参数，抛出明确的NPE
        if (reader == null) {
            throw new NullPointerException("Reader cannot be null");
        }

        BufferedReader bufferedReader = new BufferedReader(reader);
        String line;
        int lineNumber = 0;
        GameGrid gameGrid = new GameGrid(); // 假设GameGrid已实现默认构造

        // 逐行读取并解析
        while ((line = bufferedReader.readLine()) != null) {
            lineNumber++;
            line = line.trim();
            
            // 示例：跳过空行（可根据业务需求调整）
            if (line.isEmpty()) {
                continue;
            }

            // 格式检查示例：要求每行必须为5个字符
            if (line.length() != 5) {
                throw new FileFormatException(
                    String.format("Invalid format at line %d: expected 5 characters, got %d", 
                    lineNumber, line.length())
                );
            }

            // 核心解析逻辑：将行内容转换为GameGrid的行数据
            // gameGrid.addRow(parseLine(line));
        }

        // 全局格式检查：确保GameGrid行数符合要求
        if (gameGrid.getRowCount() < 3) {
            throw new FileFormatException("Invalid file: game grid must have at least 3 rows");
        }

        return gameGrid;
    }
}

为何会出现「catch永远无法到达」的提示？ #

你遇到的问题通常源于冗余的异常处理逻辑：

• 如果在方法中捕获了IOException后立即重新抛出，而方法签名已经声明throws IOException，这个catch块完全多余，IntelliJ会标记为不可达
• 嵌套try块中，外层catch已经捕获了某类异常，内层对应的catch就永远不会被触发
• 代码逻辑中没有可能抛出某类异常的场景，但你却定义了对应的catch块

注意事项 #

• NullPointerException是运行时异常，不需要在方法签名的throws中声明，但在Javadoc中明确说明是良好的编码实践
• 自定义FileFormatException建议继承Exception（而非RuntimeException），使其成为受检异常，强制调用者处理格式错误场景
• 抛出异常时务必携带明确的错误信息（如行号、错误详情），便于后续调试和问题定位

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