Соглашения об именах исключений Java

Question

В Java есть ли семантическая разница между использованием " Illegal " (как в IllegalArgumentException) и " Invalid " (как в javax.activity.InvalidActivityException)?

В ходе выполнения задания стало полезным написать подкласс IllegalArgumentException, представляющий серию входных символов, которые не могут быть разбиты на токены, и мне интересно, говорит ли соглашение об использовании InvalidTokenException или IllegalTokenException.

Единственное различие, которое я могу найти, состоит в том, что java.lang, кажется, предпочитает "Незаконно", тогда как javax.* предпочитает "Недействительно". Однако есть также java.security.InvalidParameterException, который является подклассом IllegalArgumentException.

Answer 1

Вы можете иметь законное использование API и при этом иметь недействительные данные; это все семантика.

Answer 2

javax.activity.InvalidActivityException наследуется от java.rmi.RemoteException, и вы, вероятно, не хотите эту зависимость. Смотри также Javadoc

РЕДАКТИРОВАТЬ Неверный и Незаконный используются как синонимы, это не делает различий в семантике, только технические проблемы, упомянутые выше.

РЕДАКТИРОВАТЬ: Из Postgres Документация Раздел 45.3.14. Хитрые слова, которых следует избегать:

Illegal . «Незаконный» означает нарушение закона, остальное является «недействительным». Еще лучше сказать, почему это недействительно.

Answer 3

AFAIK, IllegalArgumentException следует использовать, только если вы хотите сообщить о неправильном использовании вызова метода API.Похоже, вы описываете сценарий, когда API использовался неправильно, поэтому я думаю, что IllegalArgumentException был бы лучшим выбором.