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 ).

Thursday, March 4, 2021

GeoTools 25-RC Release Candidate

 The GeoTools team is pleased to share the availability GeoTools 25-RC 

This release candidate is also available from the OSGeo Maven Repository and is made in conjunction with GeoServer 2.19-RC and JTS 1.18.1.

Please Test this Release Candidate 

A release candidate is your chance to both try out new features and contribute to the project with valuable feedback right when we need it most. 

Please test this release with your project and let us know of any regression before we release GeoTools 25 later this month.  

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. 

Improvements and Fixes 

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
From our issue tracker release-notes
  • Add new expression functions to support AND, &&, OR operators
  • Use faster JTS function for pole of inaccessibility
  • SimplifyingFilterVisitor does not account for null values when simplifying negations
  • Speed improvement relaxing FactoryRegistery synchronization
  • gt-renderer: Map rendering of numbers using scientific notation
  • gt-css: Styles don't change the size of a label unless `font-style` is set
  • gt-wfs-ng: WFS 2.0 GetFeature reponse parsing fails on "boundedBy"
  • gt-wmts: HTTP headers set for WMTS isn't used for GetCapabilities calls
  • gt-wmts: WMTSCoverageReader#getMap() in some cases throws IllegalArgumentException
  • gt-wmts: WMTS client code automatically uppercases key names in KVP requests which breaks non standard servers
  • gt-process: Add ability to produce contours from an irregular grid of points.

About GeoTools 25 Series 

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

Wednesday, March 3, 2021

GeoTools default branch changed to main

A quick public service announcement, the GeoTools default branch has changed to main.

To update your local repository:
git branch -m master main
git fetch upstream
git branch -u upstream/main main

GeoTools is following the development ecosystem (git, gitlab, github, bitbucket) and information technology industry effort to replace the use of word " master " in a professional context.

GeoTools default main branch
GeoTools default main branch