Когда выбрасывать исключение IllegalArgumentException или NullPointerException для нулевого параметра

При определении методов установки разработчики часто сталкиваются с дилеммой: выдавать ли исключение IllegalArgumentException или NullPointerException для нулевого параметра. Оба исключения кажутся релевантными на основании их описаний в JavaDoc:

• IllegalArgumentException: Указывает на недопустимый или недопустимый аргумент.
• NullPointerException: Вызывается, когда null используется ненадлежащим образом.

Однако соответствующий Выбор — IllegalArgumentException (IAE) по следующим причинам:

• Предполагаемое использование: NPE предназначен для ошибок во время выполнения, связанных с нулевым разыменованием, тогда как IAE предназначен для для проверки параметров.
• Вводящий в заблуждение след: NPE в трассировка стека может указывать на нулевое разыменование вместо неправильного значения параметра.
• Согласованность: IAE обычно используется для других ошибок недопустимых параметров, поэтому согласованность предпочтительна.
• Несоответствия API Java: Хотя API Java иногда использует NPE для нулевых параметров, его несогласованность не должна эмулируется.

Поэтому для методов установки, где значение null не подходит, следует использовать IllegalArgumentException для передачи намерения проверки параметра.