Hello Chris
Le 04/08/12 18:57, Mattmann, Chris A (388J) a écrit :
I would propose that if we go this route, then your patch assumes that we have a
http://svn.apache.org/repos/asf/incubator/sis/trunk/sis-metadata/
Yes, unless peoples wish to create group of modules, in which case it
could be:
(...snip...)/trunk/metadata/sis-metadata
Other possible modules in this group would be "sis-metadata-fra" (for an
extension defined by the French government) and likewise for other
countries. However I feel relatively neutral about whatever we should
use groups or not; I will let peoples decide.
module, and that the class live inside of:
http://svn.apache.org/repos/asf/incubator/sis/trunk/sis-metadata/src/main/java/org/apache/sis/metadata/[citation]/
(optionally in the citation folder, or simply metadata for now)
I think that the citation folder is important given the amount of
metadata classes (about 100 distributed in 12 packages). Furthermore,
the "citation" folder actually matches a part of the ISO standard. Every
classes defined in the ISO 19xxx series of standards (with very few
exceptions) are defined with the following pattern:
XX_ClassName
Where XX is a two-letters prefix. Thus, the "real" name of the Citation
class in the ISO 19115 standard is "CI_Citation". Those two letters
prefix works exactly as a package name in the ISO standard. Other
classes in the "CI" package are CI_ResponsibleParty, CI_Address,
CI_Telephone, etc. Then there is an other "package", called "DQ" (which
we call "quality" in GeoAPI) with classes like DQ_DataQuality,
DQ_LogicalConsistency, etc.
So the package divisions in GeoAPI reflects the package divisions in the
ISO specifications, except that we use real names instead than
two-letter codes. I think that keeping the same organisation may help
peoples who are familiar with the standard to identify the corresponding
SIS class.
I would however suggest to insert an additional "iso" folder between
"metadata" and "citation", like below:
(...snip...)/sis-metadata/src/main/java/org/apache/sis/metadata/iso/citation/
The reason is that we would like to propose the following package later,
for the ISO-NetCDF bindings:
(...snip...)/sis-metadata/src/main/java/org/apache/sis/metadata/netcdf
And more packages may appear later for more spatial metadata conventions.
Cheers
Martin
