The api uses the 'exception translation' idiom, by which any low-level exception in the api is wrapped into a single exception called DocumentException. The client of the api will get only the latter exception.
Now the DocumentException is checked, but reading J. Bloch and some other sources, I'm undecided as to whether I should make it unchecked.
Bloch states, you should avoid unnecessary use of checked exceptions (Item 41), and use them if the caller is expected to recover.
Does anyone have some examples or thoughts about this topic?
Gian [ September 14, 2006: Message edited by: Gian Franco Casula ]