Typesafe operations for controlling find() queries

[gavinking]

See #383.

• Added the Find interface.
• Also added a way to set the cache modes for a Query, and the EntityGraph for a TypedQuery.

[gavinking]

This proposal is partially superseded by #436.

However, the operations added to Query and TypedQuery are not in #436. And also perhaps the method naming conventions here are better? (setFoo() vs withFoo())

So we should discuss how to proceed with these two competing PRs.

[trajano]

with... as long as it is fluent

[gavinking]

@trajano The argument against that is that we should keep names consistent across Query and Finder. So I'm uncertain which way to go on this.

[trajano]

I would prefer we mark the non-fluent set methods as deprecated and replace with with if it is fluent. Convention-wise with we expect it to return this whereas set we don't.

[gavinking]

@trajano after discussing with @lukasj last night, we have decided to go in a completely different direction.

[trajano]

Can you link to the different direction @gavinking

[gavinking]

#383 (comment)

#454