Class DefaultContact

All Implemented Interfaces:
Serializable, Emptiable, LenientComparable, IdentifiedObject, org.opengis.metadata.citation.Contact

public class DefaultContact extends ISOMetadata implements org.opengis.metadata.citation.Contact
Information required to enable contact with the responsible person and/or organization.

Limitations

  • Instances of this class are not synchronized for multi-threading. Synchronization, if needed, is caller's responsibility.
  • Serialized objects of this class are not guaranteed to be compatible with future Apache SIS releases. Serialization support is appropriate for short term storage or RMI between applications running the same version of Apache SIS. For long term storage, use XML instead.
Since:
0.3
Version:
1.0
See Also:
  • Field Details

    • serialVersionUID

      private static final long serialVersionUID
      Serial number for inter-operability with different versions.
      See Also:
    • phones

      private Collection<org.opengis.metadata.citation.Telephone> phones
      Telephone numbers at which the organization or individual may be contacted.
    • addresses

      private Collection<org.opengis.metadata.citation.Address> addresses
      Physical and email addresses at which the organization or individual may be contacted.
    • onlineResources

      private Collection<org.opengis.metadata.citation.OnlineResource> onlineResources
      On-line information that can be used to contact the individual or organization.
    • hoursOfService

      private org.opengis.util.InternationalString hoursOfService
      Time period (including time zone) when individuals can contact the organization or individual.
    • contactInstructions

      private org.opengis.util.InternationalString contactInstructions
      Supplemental instructions on how or when to contact the individual or organization.
    • contactType

      private org.opengis.util.InternationalString contactType
      Type of the contact.
  • Constructor Details

    • DefaultContact

      public DefaultContact()
      Constructs an initially empty contact.
    • DefaultContact

      public DefaultContact(org.opengis.metadata.citation.OnlineResource resource)
      Constructs a contact initialized to the specified online resource.
      Parameters:
      resource - the on-line information that can be used to contact the individual or organization, or null if none.
    • DefaultContact

      public DefaultContact(org.opengis.metadata.citation.Contact object)
      Constructs a new instance initialized with the values from the specified metadata object. This is a shallow copy constructor, because the other metadata contained in the given object are not recursively copied.
      Parameters:
      object - the metadata to copy values from, or null if none.
      See Also:
  • Method Details

    • castOrCopy

      public static DefaultContact castOrCopy(org.opengis.metadata.citation.Contact object)
      Returns a SIS metadata implementation with the values of the given arbitrary implementation. This method performs the first applicable action in the following choices:
      • If the given object is null, then this method returns null.
      • Otherwise if the given object is already an instance of DefaultContact, then it is returned unchanged.
      • Otherwise a new DefaultContact instance is created using the copy constructor and returned. Note that this is a shallow copy operation, because the other metadata contained in the given object are not recursively copied.
      Parameters:
      object - the object to get as a SIS implementation, or null if none.
      Returns:
      a SIS implementation containing the values of the given object (may be the given object itself), or null if the argument was null.
    • getPhones

      @UML(identifier="phone", obligation=OPTIONAL, specification=ISO_19115) public Collection<org.opengis.metadata.citation.Telephone> getPhones()
      Returns telephone numbers at which the organization or individual may be contacted.
      Returns:
      telephone numbers at which the organization or individual may be contacted.
      Since:
      0.5
    • setPhones

      public void setPhones(Collection<? extends org.opengis.metadata.citation.Telephone> newValues)
      Sets telephone numbers at which the organization or individual may be contacted.
      Parameters:
      newValues - the new telephones.
      Since:
      0.5
    • getPhone

      @Deprecated public org.opengis.metadata.citation.Telephone getPhone()
      Deprecated.
      As of ISO 19115:2014, replaced by getPhones().
      Returns telephone numbers at which the organization or individual may be contacted. This method returns the first telephone number associated to TelephoneType.VOICE or TelephoneType.FACSIMILE FACSIMILE.
      Specified by:
      getPhone in interface org.opengis.metadata.citation.Contact
      Returns:
      telephone numbers at which the organization or individual may be contacted, or null.
    • setPhone

      @Deprecated public void setPhone(org.opengis.metadata.citation.Telephone newValue)
      Deprecated.
      As of ISO 19115:2014, replaced by setPhones(Collection).
      Sets telephone numbers at which the organization or individual may be contacted. This method delegates to setPhones(Collection).
      Parameters:
      newValue - the new telephone, or null if none.
    • getAddresses

      @UML(identifier="address", obligation=OPTIONAL, specification=ISO_19115) public Collection<org.opengis.metadata.citation.Address> getAddresses()
      Returns the physical and email addresses at which the organization or individual may be contacted.
      Returns:
      physical and email addresses at which the organization or individual may be contacted, or null.
      Since:
      0.5
    • setAddresses

      public void setAddresses(Collection<? extends org.opengis.metadata.citation.Address> newValues)
      Sets the physical and email addresses at which the organization or individual may be contacted.
      Parameters:
      newValues - the new addresses.
      Since:
      0.5
    • getAddress

      @Deprecated public org.opengis.metadata.citation.Address getAddress()
      Deprecated.
      As of ISO 19115:2014, replaced by getAddresses().
      Returns the physical and email address at which the organization or individual may be contacted. This method returns the first adress element, or null if none.
      Specified by:
      getAddress in interface org.opengis.metadata.citation.Contact
      Returns:
      physical and email address at which the organization or individual may be contacted, or null.
    • setAddress

      @Deprecated public void setAddress(org.opengis.metadata.citation.Address newValue)
      Deprecated.
      As of ISO 19115:2014, replaced by setAddresses(Collection).
      Sets the physical and email address at which the organization or individual may be contacted. This method delegates to setAddresses(Collection).
      Parameters:
      newValue - the new address, or null if none.
    • getOnlineResources

      @UML(identifier="onlineResource", obligation=OPTIONAL, specification=ISO_19115) public Collection<org.opengis.metadata.citation.OnlineResource> getOnlineResources()
      Returns on-line information that can be used to contact the individual or organization.
      Returns:
      on-line information that can be used to contact the individual or organization.
      Since:
      0.5
    • setOnlineResources

      public void setOnlineResources(Collection<? extends org.opengis.metadata.citation.OnlineResource> newValues)
      Sets on-line information that can be used to contact the individual or organization.
      Parameters:
      newValues - the new online resources.
      Since:
      0.5
    • getOnlineResource

      @Deprecated public org.opengis.metadata.citation.OnlineResource getOnlineResource()
      Deprecated.
      As of ISO 19115:2014, replaced by getOnlineResources().
      Returns on-line information that can be used to contact the individual or organization. This method returns the first online resource element, or null if none.
      Specified by:
      getOnlineResource in interface org.opengis.metadata.citation.Contact
      Returns:
      on-line information that can be used to contact the individual or organization, or null.
    • setOnlineResource

      @Deprecated public void setOnlineResource(org.opengis.metadata.citation.OnlineResource newValue)
      Deprecated.
      As of ISO 19115:2014, replaced by setOnlineResources(Collection).
      Sets on-line information that can be used to contact the individual or organization. This method delegates to setOnlineResources(Collection).
      Parameters:
      newValue - the new online resource, or null if none.
    • getHoursOfService

      public org.opengis.util.InternationalString getHoursOfService()
      Returns the time period (including time zone) when individuals can contact the organization or individual.
      Upcoming API change — multiplicity
      As of ISO 19115:2014, this singleton has been replaced by a collection. This change will tentatively be applied in GeoAPI 4.0.
      Specified by:
      getHoursOfService in interface org.opengis.metadata.citation.Contact
      Returns:
      time period when individuals can contact the organization or individual.
    • setHoursOfService

      public void setHoursOfService(org.opengis.util.InternationalString newValue)
      Sets time period (including time zone) when individuals can contact the organization or individual.
      Upcoming API change — multiplicity
      As of ISO 19115:2014, this singleton has been replaced by a collection. This change will tentatively be applied in GeoAPI 4.0.
      Parameters:
      newValue - the new hours of service.
    • getContactInstructions

      public org.opengis.util.InternationalString getContactInstructions()
      Returns supplemental instructions on how or when to contact the individual or organization.
      Specified by:
      getContactInstructions in interface org.opengis.metadata.citation.Contact
      Returns:
      supplemental instructions on how or when to contact the individual or organization, or null.
    • setContactInstructions

      public void setContactInstructions(org.opengis.util.InternationalString newValue)
      Sets supplemental instructions on how or when to contact the individual or organization.
      Parameters:
      newValue - the new contact instructions, or null if none.
    • getContactType

      @UML(identifier="contactType", obligation=OPTIONAL, specification=ISO_19115) public org.opengis.util.InternationalString getContactType()
      Type of the contact. Returns null if none.
      Returns:
      type of the contact, or null if none.
      Since:
      0.5
    • setContactType

      public void setContactType(org.opengis.util.InternationalString newValue)
      Sets new type of the contact.
      Parameters:
      newValue - the new type of the contact.
      Since:
      0.5
    • getPhoneList

      private Collection<org.opengis.metadata.citation.Telephone> getPhoneList()
      Invoked by JAXB at both marshalling and unmarshalling time. This attribute has been added by ISO 19115:2014 standard. If (and only if) marshalling an older standard version, we omit this attribute.
    • getAddressList

      private Collection<org.opengis.metadata.citation.Address> getAddressList()
    • getOnlineResourceList

      private Collection<org.opengis.metadata.citation.OnlineResource> getOnlineResourceList()