Package org.apache.sis.metadata.iso.citation

Class DefaultContact

  • All Implemented Interfaces:
    Serializable, Emptiable, Lenient­Comparable, Identified­Object, Contact
    public class DefaultContact
extends ISOMetadata
implements 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
    See Also:
    Serialized Form

    Defined in the sis-metadata module

    • Constructor Detail

      • DefaultContact

        public DefaultContact()
        Constructs an initially empty contact.

      • DefaultContact

        public DefaultContact​(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​(Contact object)
        Constructs a new instance initialized with the values from the specified metadata object. This is a shallow copy constructor, since 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:
        cast­Or­Copy(Contact)

    • Method Detail

      • castOrCopy

        public static DefaultContact castOrCopy​(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 Default­Contact, then it is returned unchanged.
        • Otherwise a new Default­Contact instance is created using the copy constructor and returned. Note that this is a shallow copy operation, since 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.

      • setPhones

        public void setPhones​(Collection<? extends Telephone> newValues)
        Sets telephone numbers at which the organization or individual may be contacted.
        Parameters:
        new­Values - the new telephones.
        Since:
        0.5

      • getPhone

        @Deprecated
public Telephone getPhone()
        Deprecated.
        As of ISO 19115:2014, replaced by get­Phones().
        Returns telephone numbers at which the organization or individual may be contacted. This method returns the first telephone number associated to Telephone­Type​.VOICE or Telephone­Type​.FACSIMILE FACSIMILE.
        Specified by:
        get­Phone in interface Contact
        Returns:
        telephone numbers at which the organization or individual may be contacted, or null.

      • setPhone

        @Deprecated
public void setPhone​(Telephone newValue)
        Deprecated.
        As of ISO 19115:2014, replaced by set­Phones(Collection).
        Sets telephone numbers at which the organization or individual may be contacted. This method delegates to set­Phones(Collection).
        Parameters:
        new­Value - the new telephone, or null if none.

      • setAddresses

        public void setAddresses​(Collection<? extends Address> newValues)
        Sets the physical and email addresses at which the organization or individual may be contacted.
        Parameters:
        new­Values - the new addresses.
        Since:
        0.5

      • getAddress

        @Deprecated
public Address getAddress()
        Deprecated.
        As of ISO 19115:2014, replaced by get­Addresses().
        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:
        get­Address in interface Contact
        Returns:
        physical and email address at which the organization or individual may be contacted, or null.

      • setAddress

        @Deprecated
public void setAddress​(Address newValue)
        Deprecated.
        As of ISO 19115:2014, replaced by set­Addresses(Collection).
        Sets the physical and email address at which the organization or individual may be contacted. This method delegates to set­Addresses(Collection).
        Parameters:
        new­Value - the new address, or null if none.

      • setOnlineResources

        public void setOnlineResources​(Collection<? extends OnlineResource> newValues)
        Sets on-line information that can be used to contact the individual or organization.
        Parameters:
        new­Values - the new online resources.
        Since:
        0.5

      • getOnlineResource

        @Deprecated
public OnlineResource getOnlineResource()
        Deprecated.
        As of ISO 19115:2014, replaced by get­Online­Resources().
        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:
        get­Online­Resource in interface Contact
        Returns:
        on-line information that can be used to contact the individual or organization, or null.

      • getHoursOfService

        public 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:
        get­Hours­Of­Service in interface Contact
        Returns:
        time period when individuals can contact the organization or individual.

      • setHoursOfService

        public void setHoursOfService​(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:
        new­Value - the new hours of service.

      • getContactInstructions

        public InternationalString getContactInstructions()
        Returns supplemental instructions on how or when to contact the individual or organization.
        Specified by:
        get­Contact­Instructions in interface Contact
        Returns:
        supplemental instructions on how or when to contact the individual or organization, or null.

      • setContactInstructions

        public void setContactInstructions​(InternationalString newValue)
        Sets supplemental instructions on how or when to contact the individual or organization.
        Parameters:
        new­Value - the new contact instructions, or null if none.

      • setContactType

        public void setContactType​(InternationalString newValue)
        Sets new type of the contact.
        Parameters:
        new­Value - the new type of the contact.
        Since:
        0.5