[SIS-345] Upgrade JAXB binding to ISO 19115-3

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 0.7, 0.8
• Fix Version/s: 1.0, 1.1
• Component/s: Metadata
• Assignee: Martin Desruisseaux
• Reporter: Martin Desruisseaux
• Created: 20/Dec/16 16:52
• Updated: 28/Dec/22 16:47
• Resolved: 05/May/19 15:51

Description

ISO 19115-3 has been published in August 2016. It replaces ISO 19139. This specification defines the new XML representation of ISO 19115-1 metadata. We should update JAXB annotations in all metadata classes accordingly. Steps to do are:

• For each org.apache.sis.metadata.iso.* package, change the value of @XmlSchema annotation in package-info.java files.
• For each deprecated method, remove the @XmlElement annotation.
• For each class without @XmlRootElement annotation (i.e. new type introduced by ISO 19115 revision):
  • Add @XmlRootElement annotation.
  • Add the corresponding adapter in org.apache.sis.internal.jaxb.metadata package.
• For each getter method without @XmlElement annotation:
  • Add @XmlElement annotation.
  • Verify that the package-info.java file declares an adapter for the method return type.
• Update XML test files.

For compatibility with older format, ISO provides XSLT:

• Migrating (overview)
• XSLT files

Issue Links

• depends upon: SIS-394 Implement data quality (ISO 19157) in metadata package
• depends upon: SIS-299 Better handling of errors in XML.unmarshal
• depends upon: SIS-94 Update SIS to revision 2014 of the ISO 19115 standard
• depends upon: SIS-379 Upgrade to ISO 19103:2015
• depends upon: SIS-169 Upgrade metadata classes to the new ISO 19115:2014 revision
• depends upon: SIS-331 Verify the mapping from ISO 19115:2003 to ISO 19115:2014
• is depended upon by: SIS-380 Remove deprecated metadata methods
• is depended upon by: SIS-381 Handle legacy ISO 19139:2007 format using XSL instead than private methods
• is related to: SIS-419 Implement (un)marshalling of gco:Record
• is related to: SIS-361 NetCDF to ISO 19115:2014 mapping
• is related to: SIS-387 Automatically resolve links in metadata document

Sub-Tasks

• When renaming "xsi:type" value, may need to declare a new namespace: Closed
• Complete MarshallingTest and add UnmarshallingTest: Open
• Use of GML 3.2 implies the use of ISO 19139:2007 metadata: Open
• Missing @XmlElement on DefaultMetadata.getCharacterSets(): Closed
• Upgrade org.apache.sis.test.integration.MetadataTest to ISO 19115-3: Open
• Allow profiles to extend legacy metadata schema: Closed
• Upgrade or remove JAXB annotations of ImmutableIdentifier: Closed