Quando lançar IllegalArgumentException ou NullPointerException para um parâmetro nulo

Ao definir métodos setter, os desenvolvedores geralmente enfrentam o dilema de lançar uma IllegalArgumentException ou um NullPointerException para um parâmetro nulo. Ambas as exceções parecem relevantes com base em suas descrições JavaDoc:

• IllegalArgumentException: Indica um argumento ilegal ou inapropriado.
• NullPointerException: Lançado quando null é usado de forma inadequada.

No entanto, a escolha apropriada é IllegalArgumentException (IAE) pelos seguintes motivos:

• Uso pretendido: O NPE é destinado a erros de tempo de execução relacionados à desreferência nula, enquanto o IAE é designado para validação parâmetros.
• Rastreamento enganoso: NPE em um rastreamento de pilha pode sugerir uma desreferência nula em vez de um valor de parâmetro incorreto.
• Consistência: IAE é comumente usado para outros erros de parâmetros inválidos, portanto, consistência é preferível.
• Inconsistências da API Java: Enquanto a API Java às vezes usa NPE para parâmetros nulos, sua inconsistência não deve ser emulada.

Portanto, para métodos setter onde null não é apropriado, IllegalArgumentException deve ser usado para transmitir a intenção da validação do parâmetro.