FinderException for findBySomeCriteria(...)

[Shreyas Reddy]

For a finder method returning a collection of component interfaces, if no entities matching the criteria are found an empty collection is returned. When does such a method throw FinderException?
Thanks,

[Keerthi P]

... when JDBC calls fail, in which case the core SQLException will be wrapped in the FinderException.

[Kathy Sierra]

Keerthi is right--basically a FinderException from a multi-entity finder says, "Something unexpected happened while the finder method was running...", which usually means something related to the database select, although it could be anything else. The Client must assume that if a FinderException comes back from a multi-entity finder that something went wrong during the search for matching entities, but that it has nothing to do with whether there ARE any matching entities.

cheers,
Kathy