/RELEASENOTES.TXT

 1Changes in 2.0.0 (revision 264) compared to 1.1.5
 2-------------------------------------------------
 3
 4The biggest and most important change is that the query template engine is been rebuild from the ground up to be a fully generic template engine. The query template engine has become an extension of this generic template engine.
 5
 6Template file must have the following first line, starting in column 1:
 7
 8<%@ template version="1.0" language="groovy" %>
 9
10The language attribute becomes optional when the TemplateLoader or QueryLoader is ocnfigured with a default language.
11Supported script languages: groovy and javascript.
12For javascript you need the rhino javascript implementation in the classpath.
13
14A lot of improvements in the template compiler.
15
16Generic templates:
17
18	Template files need to have the .slt extension, for example: soap-result.xml.slt
19
20Query templates:
21
22	The QueryManager is renamed to QueryLoader.
23	
24	setPackage() is replaced with setTemplatePath()
25		The path can now be:
26			a folder in the classpath: "classpath:/solidstack/query/"
27			a folder in the filesystem: "c:/folder/"
28			a url: "file:/c:/folder/"
29
30	Queries do not have to be bound to its parameters before execution. Parameters are supplied when executing.
31	Template files need to have the .slt extension, for example: example-query.sql.slt
32	
33	Query.getPreparedSQL() is now public and returns a PreparedSQL object.
34	
35	Added directive: <%@ query language="SQL|JPQL|HQL" %>, default SQL
36		The helps the Query to automatically determine if a native query or a normal query should be used.
37
38	The HibernateSupport class is moved to the solidstack.query.hibernate package.
39		Added methods:
40			createQuery() which returns a org.hibernate.Query.
41			executeUpdate() which calls org.hibernate.Query.executeUpdate() and returns the number of modified entities.
42			list() which calls org.hibernate.Query.list() and returns a list of Hibernate entities.
43			uniqueResult() which calls org.hibernate.Query.uniqueResult() and returns a single Hibernate entity or null.
44		
45	The JPASupport class is moved to the solidstack.query.jpa package.
46		Added methods:
47			getResultList() without the resultClass parameter. This one returns a list of Object[] or a list of objects depending on the number of values returned by the query.
48			getSingleResult() without the resultClass parameter. This one returns an Object[] or an object depending on the number of values returned by the query.
49			executeUpdate() which calls javax.persistence.Query.executeUpdate() and returns the number of modified entities.