This maintenance release includes a few new features and one important change.

The next release of the library will be version 1.5.0 and we will remove all deprecated code in that release.

Potentially Breaking Change

The library will now throw a NonRenderingWhereClauseException if a where clause is coded in any statement, but fails to render because all optional conditions have been dropped. We have made this change out of an abundance of caution to prevent statements that accidentally impact all rows in a table (for example, a delete statement could delete all rows in a table).

The default behavior can be modified either through global configuration, or on a statement by statement basis. Please see the documentation page about library configuration for details here: https://mybatis.org/mybatis-dynamic-sql/docs/configuration.html.

New Features

1. Improve the arbitrary grouping in where clauses - virtually any where clause should now be possible
2. Add the ability to specify a table alias on delete and update statements - this improves those statements by allowing a correlated sub query
3. Some minor updates to the Kotlin DSL
4. Added some checks for invalid SQL
5. Standardized all exceptions thrown by the library to be either DynamicSqlException or some subclass of DynamicSqlException

The full list of changes is available here: https://github.com/mybatis/mybatis-dynamic-sql/issues?q=milestone%3A1.4.1+

Please read the full release notes for details: https://mybatis.org/mybatis-dynamic-sql/docs/CHANGELOG.html

All artifacts are available in Maven central under these coordinates:

:::xml
<dependency>
  <groupId>org.mybatis.dynamic-sql</groupId>
  <artifactId>mybatis-dynamic-sql</artifactId>
  <version>1.4.1</version>
</dependency>