Interface DataIdentification

    • Method Detail

      • getLanguages

        @Profile(level=CORE)
        @UML(identifier="language",
             obligation=MANDATORY,
             specification=ISO_19115,
             version=2003)
        Collection<Locale> getLanguages()
        Language(s) used within the resource. The first element in iteration order shall be the default language. All other elements, if any, are alternate language(s) used within the resource.

        XML documents shall format languages using the ISO 639-2 language code as returned by Locale.getISO3Language().

        Returns:
        language(s) used.
        See Also:
        getCharacterSets(), Metadata.getLanguage(), Locale.getISO3Language(), Locale.lookup(List, Collection)
        Departure from OGC/ISO specification:
        ISO 19115:2014 defines defaultLocale and otherLocale(s) attributes, who's data type (PT_Locale) combines the language and character encoding information into a single class. However this design does not fit well with the Java model. For example the character encoding information is irrelevant to InternationalString since the Java language fixes the encoding of all String instances to UTF-16. Consequently GeoAPI keeps the language(s) and characterSet(s) attributes as separated entities, as defined in ISO 19115:2003. GeoAPI also keeps default and other locales in a single collection for compatibility with standard Java methods like Locale.lookup(List<Locale.LanguageRange>, Collection<Locale>), which provides elaborated mechanism for choosing the best suited locale for a user.
      • getCharacterSets

        @Profile(level=CORE)
        @UML(identifier="characterSet",
             obligation=CONDITIONAL,
             specification=ISO_19115,
             version=2003)
        Collection<CharacterSet> getCharacterSets()
        The character coding standard(s) used for the dataset. Instances can be obtained by a call to Charset.forName(String).
        Examples: UCS-2, UCS-4, UTF-7, UTF-8, UTF-16, ISO-8859-1 (a.k.a. ISO-LATIN-1), ISO-8859-2, ISO-8859-3, ISO-8859-4, ISO-8859-5, ISO-8859-6, ISO-8859-7, ISO-8859-8, ISO-8859-9, ISO-8859-10, ISO-8859-11, ISO-8859-12, ISO-8859-13, ISO-8859-14, ISO-8859-15, ISO-8859-16, JIS_X0201, Shift_JIS, EUC-JP, US-ASCII, EBCDIC, EUC-KR, Big5, GB2312.
        Upcoming API change — JDK integration
        As of ISO 19115:2014, CharacterSet is replaced by a reference to the IANA Character Set register, which is represented in Java by Charset. This change may be applied in GeoAPI 4.0.
        Returns:
        the character coding standard(s) used.
        See Also:
        getLanguages(), Metadata.getCharacterSets(), Charset.forName(String)
        Departure from OGC/ISO specification:
        GeoAPI has kept the language and characterSet properties as defined in ISO 19115:2003. See getLanguages() for more information.
      • getEnvironmentDescription

        @UML(identifier="environmentDescription",
             obligation=OPTIONAL,
             specification=ISO_19115)
        InternationalString getEnvironmentDescription()
        Description of the resource in the producer's processing environment, including items such as the software, the computer operating system, file name, and the dataset size.
        Returns:
        description of the resource in the producer's processing environment, or null.