I agree, partly. As you in fact use a entitys toString() method in your code you should at least warn in the documentation that the entities toString() method might be called in some situations. I agree that is very useful in some situations and a feature, not a bug. Nevertheless it can be surprising.