ISPN-4364 Add documentation for Entry Retriever

* Added documentation for retriever
* Also made sure that filter package is public as it should be

https://issues.jboss.org/browse/ISPN-4364
> Note each invocation will start a brand new request chain so it can be reused.

^ What exactly does that mean?