Tapestry 5.7.0 is a new major version which needs a migration step for projects using previous versions. To upgrade, update the dependency in your build configuration (Maven POM, Gradle build script, etc.) – or Download the new JAR file. Please check the 5.7.0 Upgrade Guide section in the bottom of this page for details. This is a step that only needs to be done once. Please also review the How to Upgrade instructions before upgrading.
The main new features are:
- Partial Java 9+ modules (JPMS) support. It's partial because module-info.java classes are not provided yet. On the other hand, Tapestry's JARs don't have split packages anymore, making them easier to be used with Java 9+ modules. Many classes had to be moved to other packages, and sometimes even to a different JAR. The migration tool mentioned above will take care of updating your code so it uses the correct new fully-qualified class names for the ones that were moved and/or renamed.
- TypeCoercer now uses mapped configuration so coercion overrides are done in an explicit manner. Please check the 5.7.0 Upgrade Guide section in the bottom of the page for details.
Improvements made
Bugs fixed
5.7.0 Upgrade Guide
- Download the migration tool jar from https://repo1.maven.org/maven2/org/apache/tapestry/tapestry-version-migrator/5.7.0/tapestry-version-migrator-5.7.0.jar
- Run "java -jar tapestry-version-migrator-5.7.0.jar upgrade 5.7.0" (without quotes) in the command line. It will process all .java files found in the current folder and its subfolders, recursively.
The second step is updating how contributions to the TypeCoercer service in case your projects have them. Here's a real example from Tapestry itself. It used to be done using Configuration, but now it's MappedConfiguration. If you had a contribution method like this:
@Contribute(TypeCoercer.class) public static void provideCoercions(Configuration<CoercionTuple> configuration) { configuration.add(CoercionTuple.create(String.class, JSONObject.class, new StringToJSONObject())); }
it should be changed to this:
public static void provideCoercions(MappedConfiguration<CoercionTuple.Key, CoercionTuple> configuration) { CoercionTuple<String, JSONObject> stringToJsonObject = CoercionTuple.create( String.class, JSONObject.class, new StringToJSONObject()); configuration.add(stringToJsonObject.getKey(), stringToJsonObject); }