[jira] [Created] (SIS-596) Better encapsulation of modules internal

["Martin Desruisseaux (Jira)" <ji...@apache.org>]

Martin Desruisseaux created SIS-596:
---------------------------------------

             Summary: Better encapsulation of modules internal
                 Key: SIS-596
                 URL: https://issues.apache.org/jira/browse/SIS-596
             Project: Spatial Information Systems
          Issue Type: Improvement
          Components: Coverage, Features, Metadata, Referencing, Utilities
    Affects Versions: 1.4
            Reporter: Martin Desruisseaux
            Assignee: Martin Desruisseaux
             Fix For: 1.5


Apache SIS has some internal packages not intended to appear in public API. Some internal packages are read by other SIS modules. Those packages must be declared by qualified exports. In order to avoid exporting more than intended, the following convention can be applied:

* `org.apache.sis. ... .inernal` are strictly inernal to the module. Those package should not be exported at all, not even as qualified exports.
* `org.apache.sis. ... .privy` are internal packages shared by other modules. "Privy" means "something that is known or understood by only a select few individuals". The "individuals" here are the SIS modules.

This task is about moving some (not all) classes from `internal` to `privy` packages, depending on whether they are used by other modules.

The goal is to improve encapsulation by avoiding to export some classes that are internal mechanic even from the point of view of other SIS modules.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)