org.nuiton.topia.framework
Class TopiaQuery

java.lang.Object
  org.nuiton.topia.framework.TopiaQuery

public class TopiaQuery
extends Object

Query HQL managment to simplify usage of TopiaContext.find(String, Object...).

TODO-FD20091224 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(String, 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(String, Object...) :
       TopiaContext context = rootContext.beginTransaction();
 

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