more javadoc corrections. also removed unused setters from the
interfaces and added better exception handling to the resource selector.