[SIS-587] Rename internal packages

• Type: Task
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 1.0, 1.1, 1.2, 1.3
• Fix Version/s: 1.4
• Component/s: Coverage, Features, Geometry, GUI, Metadata, Portrayal, Referencing, Shapefile, Storage, Utilities
• Assignee: Martin Desruisseaux
• Reporter: Martin Desruisseaux
• Created: 22/Aug/23 17:09
• Updated: 08/Mar/24 09:35
• Resolved: 24/Aug/23 12:32

Description

Apache SIS has a many packages for SIS internal usage. Users should not use the classes in those package, because they may change in any SIS version without notice. Prior to SIS 1.4, those packages were identified by naming conventions. Anything starting with org.apache.sis.internal. is excluded from Javadoc and should be ignored by users. However this convention is unconvenient for SIS developers, because the internal part in package name cause related package to appear far from each other. As SIS become bigger, the internal packages became more and more confusing.

Since JPMS modularisation, the internal naming convention is no longer needed. Instead the module-info.java file declare explicitly which packages are exported, and packages not in this list are invisible to users. Consequently we can rename the internal packages to something much closer to where they are used.

Issue Links

• depends upon: SIS-561 Upgrade to Java 11
• is depended upon by: SIS-596 Better encapsulation of modules internal