desruisseaux opened a new pull request, #33:
URL: https://github.com/apache/sis/pull/33

   Review of the new style package added in the previous commit. Those classes 
are derived from OGC Symbology Encoding (SE) 1.1.0 specification.
   
   # Summary of changes:
   
   * Remove dependency to GeoAPI-pending interfaces (see below).
   * Warning resolutions for raw parametric types and unchecked casts.
   * Add some properties defined by the SE standard but missing in the classes.
   * Empty placeholders when addition of missing properties would be too much 
work.
   * Use `java.util.Optional` for better identification of which properties are 
optional.
   * Add some (not all) JAXB annotations, as a help for identifying mandatory 
properties.
   * Lazy initialization of (sometime standardized) default values of mandatory 
properties.
   * Add credits to OGC GeoAPI 2 contributors since GeoAPI was a source of 
inspiration.
   * Set version number to 1.5 (we will not include this package in SIS 1.4 
release).
   * Documentation.
   
   # Removal of GeoAPI-pending dependency
   
   The most important change is the removal of usages of GeoAPI-pending 
interfaces. The GeoAPI `org.opengis.style` package is not part of a formal 
GeoAPI release. It is currently found only in the "GeoAPI-pending" module, 
which is not released. Those interfaces were based on XML encoding as defined 
in OGC 05-077r4 standard. Using XML schema instead of UML models has many 
drawbacks shown in OGC meetings. UML abstract model was not available when 
`org.opengis.style` was first designed. But today, the ISO 19117:2012 standard 
evolved with a more elaborated model. There is also various OGC working groups 
actively working on new style standards, with goals such as better 
representation of 3D data. For those reasons, the style interfaces in 
GeoAPI-pending may change and it would premature to commit to them.
   
   Note that the GeoAPI-pending dependency was only on the SIS development 
branch. The SIS `master` branch does not depend on GeoAPI-pending and shall 
never do. Consequently this issue must be resolved before the previous commit 
can be merged to `master`.
       
   JIRA issue: https://issues.apache.org/jira/browse/SIS-583
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to