Package org.apache.sis.internal.jaxb.gco

Class GO_DateTime

java.lang.Object
javax.xml.bind.annotation.adapters.XmlAdapter<GO_DateTime,Date>
org.apache.sis.internal.jaxb.gco.GO_DateTime
Direct Known Subclasses:
GO_DateTime.Since2014
public class GO_DateTime extends XmlAdapter<GO_DateTime,Date>
JAXB adapter wrapping the date value in a <gco:Date> or <gco:DateTime> element, for ISO 19115-3 compliance. Only one of Date or DateTime field shall be non-null. At marshalling time, the choice is performed depending on whatever the given date contains hour, minute or seconds information different than zero.

Difference between ISO 19139:2007 and ISO 19115-3:2016

The ISO baseTypes.xsd files define two kinds of date property:
  • gco:Date_PropertyType accepts either gco:Date or gco:DateTime.
  • gco:DateTime_PropertyType accepts only gco:DateTime.
In the legacy standard (ISO 19139:2007), date properties (in particular in citations) were of type Date_PropertyType. But in the new standard (ISO 19115-3:2016), most date properties are of type DateTime_PropertyType, i.e. gco:Date is not legal anymore. The only exception is versionDate in cat:AbstractCT_Catalogue.
Since:
0.3
Version:
1.3
See Also:

  • Field Details

    • dateTime

      private XMLGregorianCalendar dateTime
      The date and time value using the code "DateTime" name. Only one of date and dateTime shall be non-null.

    • date

      private XMLGregorianCalendar date
      The date value using the "Date" name, used when there are no hours, minutes or seconds to format.

  • Constructor Details

    • GO_DateTime

      public GO_DateTime()
      Empty constructor for JAXB.

    • GO_DateTime

      private GO_DateTime(Date date)
      Builds a wrapper for the given Date.
      Parameters:
      date - the date to marshal. Cannot be null.

  • Method Details

    • getDate

      private Date getDate()
      Returns the current date, or null if none. If both fields are defined, then dateTime has precedence since it is assumed more accurate.

    • unmarshal

      public final Date unmarshal(GO_DateTime value)
      Converts a date read from a XML stream to the object which will contain the value. JAXB calls automatically this method at unmarshalling time.
      Specified by:
      unmarshal in class XmlAdapter<GO_DateTime,Date>
      Parameters:
      value - the adapter for this metadata value.
      Returns:
      a date which represents the metadata value.

    • marshal

      public GO_DateTime marshal(Date value)
      Converts the date to the object to be marshalled in a XML file or stream. JAXB calls automatically this method at marshalling time. The use of <gco:Date> or <gco:DateTime> is determined automatically.
      Specified by:
      marshal in class XmlAdapter<GO_DateTime,Date>
      Parameters:
      value - the date value.
      Returns:
      the adapter for this date.