GeoTools

OSGeo

Monday, March 22, 2021

GeoTools 25.0 released

  The GeoTools team is pleased to share the availability GeoTools 25.0 

This release is also available from the OSGeo Maven Repository and is made in conjunction with GeoServer 2.19.0 and JTS 1.18.1.

Change DataStore Parameters Map<String,Serilizable> to Map<String,?>

This API change makes it easier to configure DataStore's with full objects (which may or may not be serializable):

Map<String, Object> connectionDetails = new HashMap<>();
connectionDetails.put("url", url );
DataStore dataStore = DataStoreFinder.getDataStore(map);

As shown above this change does not effect existing client code. If you implement your own DataStore please check out update instructions.

New gt-http library and HTTPClientFinder

We noticed that the various web clients (gt-wfs, gt-wms, gt-tile) all had different ways to change between the use of built-in Java URL or an alternative such as Apache HTTP Components implementation.
 
Hints hints = new Hints(Hints.HTTP_LOGGING, "True")
HTTPClient http = HTTPClientFinder.createClient(hints); 
HTTPResponse response = http.get( new URL("https://geotools.org") );

The new gt-http library module is available to integrators providing a single location to configure how the library interacts with web resources. The update instructions provide a table to guide migrating from deprecated implementations to the shared gt-http classes.

Extending use of Variable Arguments making the api easier to use 

An interesting update that simplifies the use of GeoTools, methods that previously worked with array can now be used more easily.

As an example Query.setPropertyNames( String ... propNames ) allows for:

Query q = new Query(tname("ft1"));
q.setPropertyNames("geom", "name");

Existing code that use a String[] array will continue to work just fine, see update instructions for more examples.

GeoPackage Improvements

Several geopackage improvements for this release:
  • Add support for GeoPackage sorting in GeoPackageProcessRequest
  • GeoPackage store fails to register two same named columns, in different tables, both using the schema extension
  • Improve GeoPackage array storage (as JSON structures)

JDBCDataStore Updates

One performance improvement for database use:
  • Native support for average and stddev aggregate functions in jdbc data stores
Updated jdbc drivers:
  • Oracle 19.10.0.0
  • PostgreSQL 42.2.19
  • sqlite-jdbc 3.34.0
  • SQL Server 8.4.1.jre8

Massive Code Cleanup

The GeoTools codebase is easier to work with due to ongoing quality assurance activities, code cleanup and additional "pmd" checks added to our build chain.

The PMD static code analyzer has a motto of "Don't shoot the messenger", what they did not warn us about is that PMD shoots first and shoots often:
  • Remove un-necessary casts from code
  • Remove explicit type when diamond operator can be used
  • Unchecked warnings cleanup, addressing all compiler warnings
  • Replace iterator loops with enhanced for loops
  • Avoid assertTrue for tests that can be expressed with dedicated assertions
  • Collapse catch statements with the same body in a multi-catch
  • Replace try/finally with try-with-resources
  • Remove usage of Vector/Hashtable, replace with ArrayList and HashMap
In each case the entire codebase has been cleaned up to address the concern raised, and then the rule added to our build chain so any future work is called out on poor behaviour. In many cases these checks help catch common errors improving library stability and the confidence of the development team.

All of the above checks are running in continous integration, but more importantly, in the QA build check running on each PR, keeping the code from regressions.

Thanks to Andrea, Ian and everyone involved for making the GeoTools library better.

Updated Libraries

Each major release is an opportunity to update the libraries that GeoTools uses: 
  • JTS 1.18.1
  • jai-ext to 1.1.19
  • commons-beanutils 1.9.4
  • Batik 1.13
  • Jackson 2 libraries 2.10.5 and 2.10.5.1
  • Apache HTTP components to 4.5.13
  • Guava to 30.1-jre
For additional information on upgrading your application see our User Manual "upgrading" page. 

Public service announcement

  • ArcSDE DataStore has been retired due to lack of feedback and active maintainer
  • Validation extension has been retired as it has been unused for some time

About GeoTools 25 Series 

For more information see the release notes ( 25.025-RC ).