All Versions
Latest Version
Avg Release Cycle
Latest Release

Changelog History

  • v5.0.0 Changes

    ๐Ÿš€ This release of QueryDSL targets Java 8 minimally and comes with various improvements to make QueryDSL ready for the modern Java ecosystem. ๐Ÿšš This version also removes joda-time:joda-time, and as required runtime dependencies for using QueryDSL.

    ๐Ÿš€ QueryDSL 5.0 is the long awaited major release after the QueryDSL project was left mostly unmaintained for over two years. ๐Ÿš€ With this release the team worked hard on resolving the most pressing issues that have been requested repeatedly for a long time.

    ๐Ÿš€ A huge thanks goes out to all contributors that made this release possible in their free time:

    ๐Ÿ†• New features

    • ๐ŸŽ #2672 - Various performance and code improvements possible by targeting Java 8 source level.
    • #2672 - Added Fetchable#stream() which returns a Stream<T>. Make sure that the returned stream is always closed to free up resources, for example using try-with-resources. It does not suffice to rely on a terminating operation on the stream for this (i.e. forEach, collect).
    • #2324 - Removal of Guava as dependency. Almost no required transitive dependencies to get started with QueryDSL. And no more conflicts with Guava versions required by your other tools or own application.
    • #2025 - joda-time:joda-time is no longer a required dependency for querydsl-sql. By default, the Java 8 date/time API is used for date/time operations. The joda-time:joda-time types will still be registered automatically if they are on the classpath.
    • ๐Ÿ‘ #2215 - MongoDB 4 support through the Document API
    • #2697 - Allow com.querydsl.core.alias.Alias.* to be used on a JRE by relying on ECJ as compiler
    • #2479 - Swap out JSR305 for Jetbrains Annotations. Because the Jetbrains Annotations, contrary to the JSR305 annotations, use a Class retention level, Jetbrains Annotations does not have to be available at runtime and is not a transitive dependency.
    • #658 - Added JPAExpressions#treat which can be used to generate JPA 2.1 Treated path expressions.
    • ๐Ÿ‘ #2666 - More descriptive error message when using unsupported query features in JPA.
    • ๐Ÿ‘ #2106 - Support NullsLast ordering in querydsl-collections.
    • โฌ†๏ธ #2404 - Upgrade of JTS / Geolatte in querydsl-spatial
    • ๐Ÿ‘ #2320 - Make Spatial support available to HibernateDomainExporter and JPADomainExporter.
    • ๐Ÿš€ #2612 - Support jakarta.* packages for new Jakarta EE releases (available through thejakarta classifiers for Maven)

    ๐Ÿ›  Bugfixes

    • #2579 - Count query generation in JPASQLQuery
    • #2671 - Fixed a concurrency issue in Alias.*. Alias.* is now Thread safe.
    • โ†ช #2053 - Work around issues with AbstractJPAQuery#fetchResults and AbstractJPAQuery#fetchCount in a query with a having clause by using an in-memory calculation.
    • โ†ช #2504 - Work around issues with AbstractJPAQuery#fetchResults and AbstractJPAQuery#fetchCount in a query with multiple group by expressions by using an in-memory calculation.
    • #2663 - Fix issues with the JPA implementation of InsertClause.
    • #2706 - Fix a memory leak in TemplateFactory.
    • #2467 - Prevent ExtendedBeanSerializer from generating toString method twice

    ๐Ÿ’ฅ Breaking changes

    • โœ… Java 8 minimal requirement. If you still rely on Java <7, please use the latest 4.x.x version.
    • ๐Ÿšš JavaSE6SQLExceptionWrapper and other parts regarding pre-Java 7 exception handling are removed.
    • โœ‚ Removed bridge method that were in place for backwards compatibility of legacy API's. This may lead to some breaking API changes.
    • โœ‚ Removed Guava as a dependency. If your application relies on Guava, make sure to add it as a direct dependency for your project and not rely on QueryDSL shipping it transitively.
    • ๐Ÿš€ In order for Guava to be removed Mysema Codegen had to be rereleased as QueryDSL Codegen Utils. Therefore, the classes in this module moved to a different package: com.mysema.codegen is now com.querydsl.codegen.utils. This for example affects com.mysema.codegen.model.SimpleType. Although many applications won't touch the codgen internal classes, custom APT extensions might be affected by this.
    • Due to the removal of Guava, any method that received an ImmutableList as parameter, now accepts any List instead. Normal code should handle this signature just fine. However, make sure to check any reflective uses of these parameters.
    • 0๏ธโƒฃ The querydsl.variableNameFunctionClass property for the DefaultConfiguration should now be provided as a java.util.function.Function instead of a
    • CodeWriter#beginStaticMethod now takes a java.util.function.Function instead of a
    • AbstractLuceneQuery now takes a java.util.function.Function instead of a
    • AbstractMongodbQuery now takes a java.util.function.Function instead of a
    • 0๏ธโƒฃ com.querydsl.codegen.NamingFunction, EvaluatorFunction, DefaultVariableFunction now extend java.util.function.Function instead of
    • Any constructor that received a javax.inject.Provider, now takes a java.util.function.Supplier instead. In most cases you can replace the argument with provider::get.
    • ๐Ÿš€ This release targets Hibernate 5 in the Hibernate integration. If you need Hibernate 4 dialect specific workarounds, use the HQLTemplates instead of the Hibernate5Templates.
    • ๐Ÿ—„ Removal of various deprecated methods.
    • joda-time:joda-time is now an optional dependency. If your application relies on joda-time:joda-time make sure to specify it as a direct dependency rather than relying on QueryDSL to include it transitively.
    • is no longer a dependency. If your application currently relies on QueryDSL shipping JSR305 transitively, you should add JSR305 as a direct dependency to your project.
    • MDC keys now use an underscore instead of a dot as separator: querydsl.query now is querydsl_query and querydsl.parameters is querydsl_parameters.
    • โฌ†๏ธ Removal of PolyHedralSurface in querydsl-spatial and querydsl-sql-spatial due to the upgrade of geolatte-geom.
    • ๐Ÿšš com.querydsl.apt.Extension moved to com.querydsl.codegen and now resides in the querydsl-codegen module.
    • ๐Ÿšš com.querydsl.apt.SpatialSupport moved to com.querydsl.spatial.apt.SpatialSupport and now resides in the querydsl-spatial module.
    • ๐Ÿšš com.querydsl.sql.codegen.SpatialSupport moved to com.querydsl.sql.spatial.SpatialSupport and now resides in the querydsl-sql-spatial module.
    • ๐Ÿšš SQLServerGeometryReader in querydsl-sql-spatial is removed in favour of org.geolatte.geom.codec.db.sqlserver.*.
    • ๐Ÿšš PGgeometryConverter in querydsl-sql-spatial is removed in favour of org.geolatte.geom.codec.Wkt.
    • ๐Ÿšš JGeometryConverter in querydsl-sql-spatial is removed in favour of*.
    • ๐Ÿ‘ Removal of HibernateDomainExporter in querysql-jpa-codegen. HibernateDomainExporter only supported Hibernate 4, which QueryDSL no longer actively supports. Instead, use the JPADomainExporter with Hibernate.

    ๐Ÿ—„ Deprecations

    • ๐Ÿ—„ AbstractJPAQuery#fetchResults and AbstractJPAQuery#fetchCount are now deprecated for queries that have multiple group by expressions or a having clause, because these scenarios cannot be supported by pure JPA and are instead computed in-memory. If the total count of results is not necessary, we recommend to always use AbstractJPAQuery#fetch instead. If you want a reliable way of computing the result count for a paginated result for even the most complicated queries, we recommend using the Blaze-Persistence QueryDSL integration. BlazeJPAQuery properly implements both fetchResults and fetchCount and even comes with a page method.

    โšก๏ธ Dependency updates

    • ๐Ÿ‘ cglib:cglib to 3.3.0 for Java 8+ support
    • ๐Ÿ‘ org.eclipse.jdt.core.compiler:ecj to 4.6.1 for Java 8+ support
    • ๐Ÿ‘ joda-time:joda-time to 2.10.8 for better interoperability with other frameworks that use more recent versions than QueryDSL.
    • ๐Ÿ‘ org.geolatte:geolatte-geom to 1.4.0 for better interopability with Hibernate Spatial. querydsl-spatial is still backwards compatible with older versions of Geolatte, however, querydsl-sql-spatial is not and requires 1.4.0 or newer.
    • ๐Ÿ‘ com.vividsolutions:jts to org.locationtech:jts for better interopability with Hibernate Spatial. com.vividsolutions:jts is still supported for querydsl-spatial if an older version of org.geolatte:geolatte-geom is provided.
    • ๐Ÿ‘ DataNucleus 5.2.x for Java 8+ support
      • JDO now uses org.datanucleus:javax.jdo instead of javax.jdo:jdo-api