Java Exception Naming Conventions

Question

In Java, is there a semantic difference between using "Illegal" (as in IllegalArgumentException) versus "Invalid" (as in javax.activity.InvalidActivityException)?

During the course of an assignment it became useful to write a subclass of IllegalArgumentException to represent a series of input characters that cannot be tokenized, and I'm wondering whether convention says to use InvalidTokenException or IllegalTokenException.

The only difference I can find so far is that java.lang seems to prefer "Illegal" while javax.* prefers "Invalid". However, there is also java.security.InvalidParameterException which is a subclass of IllegalArgumentException.

score 13 · Accepted Answer · 2013-09-11T20:17:22.983

13

You can have legal usage of an API and still have invalid data; it is all semantics.

edited Sep 11 '13 at 20:17

answered Mar 02 '10 at 15:33

2

But the IllegalArgumentException appears to cover both illegal API usage and invalid data. – ehdv Mar 03 '10 at 18:47

stacker · Answer 2 · 2010-03-08T20:07:27.307

2

javax.activity.InvalidActivityException is inherited from java.rmi.RemoteException and you probably don't want this dependency. See also Javadoc

EDIT both Invalid and Illegal are used synonymously it makes no differency in semantics, just the technical issues mentioned above.

EDIT: From Postgres Documentation Section 45.3.14. Tricky words to avoid:

Illegal. "Illegal" stands for a violation of the law, the rest is "invalid". Better yet, say why it's invalid.

edited Mar 08 '10 at 20:07

answered Mar 02 '10 at 15:32

stacker

68,052
28
140
210

1

He's talking about names, not extending the InvalidActivityException. – Bart van Heukelom Mar 02 '10 at 15:35

score -1 · Answer 3 · answered Mar 02 '10 at 15:30

-1

AFAIK, IllegalArgumentException should only be used when you want to signal the incorrect use of an API method call. What it appears you are describing is a scenario when the API has been used incorrectly, so I think an IllegalArgumentException would be the better choice.

answered Mar 02 '10 at 15:30

ChadNC

2,528
4
25
39

Did you mean `IllegalStateException` for the second "IllegalArgumentException"? If not, I'm really confused... – ehdv Mar 02 '10 at 15:33
1

AFAIK that is not what the OP is asking. – Daniel Rikowski Mar 02 '10 at 15:36
@DR - you would be correct. Thanks for the formatting improvement, btw. – ehdv Mar 02 '10 at 15:43

Java Exception Naming Conventions

3 Answers3

Linked

Related