Можно ли указывать throws для unchecked исключения?

Throws для unchecked исключений

Краткий ответ

Да, технически можно указывать throws для unchecked исключений, но это обычно не нужно и не рекомендуется. Компилятор не будет требовать обработку или объявления unchecked исключений.

Что такое checked и unchecked исключения?

Checked исключения (проверяемые)

Это исключения, которые обязательно нужно обработать или объявить:

// ❌ Ошибка компиляции — IOException не обработана
public void readFile(String path) {
    FileInputStream file = new FileInputStream(path);  // Ошибка!
}

// ✅ Правильно — объявляем throws
public void readFile(String path) throws IOException {
    FileInputStream file = new FileInputStream(path);
}

// ✅ Или обрабатываем try-catch
public void readFile(String path) {
    try {
        FileInputStream file = new FileInputStream(path);
    } catch (IOException e) {
        e.printStackTrace();
    }
}

Иерархия:

Throwable
  ├── Exception
  │   ├── IOException (checked)
  │   ├── SQLException (checked)
  │   ├── ClassNotFoundException (checked)
  │   └── ...
  └── RuntimeException (unchecked)
      ├── NullPointerException
      ├── ArithmeticException
      ├── IndexOutOfBoundsException
      └── ...

Unchecked исключения (непроверяемые)

Это RuntimeException и его наследники. Компилятор НЕ требует их обработки:

// ✅ Работает без throws
public void divide(int a, int b) {
    int result = a / b;  // Может выбросить ArithmeticException
}

// Компилятор не требует throws
// Даже если метод выбросит исключение

Можно ли добавить throws для unchecked?

Да, синтаксически это разрешено:

// ✅ Синтаксически правильно
public void divide(int a, int b) throws ArithmeticException {
    int result = a / b;
}

// ✅ Или для NullPointerException
public void process(String str) throws NullPointerException {
    System.out.println(str.toUpperCase());
}

Но это бесполезно для компилятора:

// Вызывающий код НЕ обязан обрабатывать
public static void main(String[] args) {
    divide(10, 2);  // Даже без try-catch
    // Компилятор не требует throws или try-catch
}

Когда может быть полезно?

1. Документирование (редко)

Можно использовать throws для документирования, какие unchecked исключения может выбросить метод:

// Явное объявление помогает читателям понять риски
public User findById(Long id) throws IllegalArgumentException, NullPointerException {
    if (id == null) {
        throw new NullPointerException("ID не может быть null");
    }
    if (id <= 0) {
        throw new IllegalArgumentException("ID должен быть > 0");
    }
    // ...
}

ОДНАКО: лучше использовать JavaDoc для этого:

/**
 * Находит пользователя по ID.
 * 
 * @param id ID пользователя
 * @return пользователь
 * @throws IllegalArgumentException если ID <= 0
 * @throws NullPointerException если ID null
 */
public User findById(Long id) {
    if (id == null) {
        throw new NullPointerException("ID не может быть null");
    }
    if (id <= 0) {
        throw new IllegalArgumentException("ID должен быть > 0");
    }
    // ...
}

2. Для интерфейсов (иногда полезно)

Если интерфейс объявляет unchecked исключение в throws, то все реализации должны его объявить:

public interface DataProcessor {
    void process(Data data) throws IllegalArgumentException;
}

public class MyDataProcessor implements DataProcessor {
    @Override
    public void process(Data data) throws IllegalArgumentException {
        if (data == null) {
            throw new IllegalArgumentException("Data не может быть null");
        }
        // обработка
    }
}

Иерархия исключений

// ❌ Неправильно переносить unchecked как checked
public void doSomething() throws RuntimeException {  // Бесполезно
    int x = 5 / 0;  // Может выбросить ArithmeticException
}

// ✅ Если обёртываешь unchecked в checked, то нужен try-catch
public void doSomething() throws Exception {  // Слишком общее
    try {
        int x = 5 / 0;
    } catch (ArithmeticException e) {
        throw new Exception("Ошибка расчёта", e);
    }
}

Примеры из Java SDK

Collections.sort() — объявляет ClassCastException (unchecked):

public interface List<E> extends Collection<E> {
    // Иногда unchecked исключения объявляют для документирования
    void sort(Comparator<? super E> c) throws ClassCastException;
}

Это помогает разработчикам узнать, что может выброситься.

Лучшие практики

❌ НЕ делай это

// Бесполезно — компилятор это игнорирует
public int add(int a, int b) throws ArithmeticException {
    return a + b;
}

// Слишком общее — теряется информация
public void doSomething() throws Exception {
    // ...
}

✅ Делай это

// 1. Для checked исключений — обязательно throws
public void readFile(String path) throws IOException {
    Files.readAllBytes(Paths.get(path));
}

// 2. Документируй unchecked в JavaDoc
/**
 * Находит элемент.
 * @throws IllegalArgumentException если индекс < 0
 */
public Object get(int index) {
    if (index < 0) {
        throw new IllegalArgumentException("Index не может быть < 0");
    }
    // ...
}

// 3. Используй специальные unchecked для логики
public class BusinessException extends RuntimeException {
    public BusinessException(String message) {
        super(message);
    }
}

public User register(String email) throws BusinessException {
    if (emailExists(email)) {
        throw new BusinessException("Email уже существует");
    }
    // ...
}

// Вызывающий код может не обрабатывать
User user = register("test@example.com");

Сравнение: checked vs unchecked

Вывод

✅ Технически можно указывать throws для unchecked исключений

❌ Но это бесполезно — компилятор игнорирует для вызывающего кода

✅ Используй throws только для checked исключений

✅ Для документирования unchecked используй JavaDoc @throws

❌ Не объявляй throws RuntimeException или throws Exception — слишком общее