org.nuiton.topia.framework
Class TopiaQuery<E extends TopiaEntity>

java.lang.Object
  org.nuiton.topia.framework.TopiaQuery<E>

Type Parameters:

E - The main entity for the query

public class TopiaQuery<E extends TopiaEntity>
extends java.lang.Object

Query HQL managment to simplify usage of TopiaContext.find(java.lang.String, java.lang.Object[]). TODO-FD20091224 Complete documentation of this class + JUnit Tests

 This class is used to construct a HQL query and then execute it from a TopiaContext. The TopiaQuery is linked to a TopiaEntity which
 is the main element manipulated in the query. There is two parts in using this class :
 - construction of the query, using add, addFrom, addOrder, addSelect, addGroup, ...
 - execution of the query, using executeToEntityList, executeToEntity, executeToInteger, ...

 Construction
 ============

 This class make easier the way to construct a HQL query.
 
 Example 1 :
 -----------

 SQL :
       "SELECT * FROM PersonImpl WHERE firstName LIKE 'M%' AND year > 1980"

 HQL using TopiaContext.find(java.lang.String, java.lang.Object[]) :
       TopiaContext context = rootContext.beginTransaction();
       context.find("FROM " + Person.class.getName() + " WHERE firstName LIKE :firstName AND year > :year",
              "firstName", "M%", year, 1980);

 TopiaQuery : 
       TopiaQuery query = TopiaQuery.createQuery(Person.class).add(Person.FIRST_NAME, Op.LIKE, "M%").add(Person.YEAR, Op.GT, 1980);

 But the real advantage is when you have some parameters to test before adding them to the query. With the older method, it was tidious to construct
 and add parameters to finally use the find method from TopiaContext.

 Example 2 :
 -----------

 HQL using TopiaContext.find(java.lang.String, java.lang.Object[]) :
       TopiaContext context = rootContext.beginTransaction();

       String query = "FROM " + Person.class.getName();
       List