Существует ли передовая практика или отраслевой стандарт для создания исключений из API набора инструментов?
Должны ли методы, с которыми сталкивается пользователь, перехватывать и оборачивать Exception в какое-то CustomException, чтобы пользователям приходилось беспокоиться только о том, что CustomException выйдет из API?
Или это соглашение, позволяющее просто разрешить они всплывают?
Мы заинтересованы в том, чтобы иметь возможность документировать все возможные исключения, которые могут генерировать наши методы API. (Например, если наш метод API вызывает Stream.Write(), который генерирует 4 или 5 исключений, нам придется документировать все это в дополнение к другим исключениям, которые могут генерировать другие вызываемые методы.)
Мы думали сделать что-то вроде этого:
public void customerFacingApiMethod(){
try {
//api functionality goes here
} catch (Exception e) {
throw new CustomException(e);
}
}
Подробнее здесь: https://stackoverflow.com/questions/184 ... oolkit-api
