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

Class DefaultResponsibleParty

java.lang.Object
org.apache.sis.metadata.AbstractMetadata
org.apache.sis.metadata.ModifiableMetadata
org.apache.sis.metadata.iso.ISOMetadata
org.apache.sis.metadata.iso.citation.DefaultResponsibility
org.apache.sis.metadata.iso.citation.DefaultResponsibleParty
All Implemented Interfaces:
Serializable, Emptiable, LenientComparable, IdentifiedObject, org.opengis.metadata.citation.ResponsibleParty
public class DefaultResponsibleParty extends DefaultResponsibility implements org.opengis.metadata.citation.ResponsibleParty
Identification of, and means of communication with, person(s) and organizations associated with the dataset. The following properties are mandatory or conditional (i.e. mandatory under some circumstances) in a well-formed metadata according ISO 19115:
CI_ResponsibleParty   ├─role…………………………… Function performed by the responsible party.   └─party………………………… Information about the parties.       └─name………………… Name of the party.
Upcoming API change — deprecation
As of ISO 19115:2014, the ResponsibleParty type has been replaced by Responsibility to allow more flexible associations of individuals, organisations, and roles. This ResponsibleParty interface may be deprecated in GeoAPI 4.0.
Since:
0.3
Version:
1.1
See Also:

  • Field Details

    • serialVersionUID

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

  • Constructor Details

    • DefaultResponsibleParty

      public DefaultResponsibleParty()
      Constructs an initially empty responsible party.

    • DefaultResponsibleParty

      public DefaultResponsibleParty(org.opengis.metadata.citation.Role role)
      Constructs a responsibility party with the given role.
      Parameters:
      role - the function performed by the responsible party, or null.

    • DefaultResponsibleParty

      public DefaultResponsibleParty(DefaultResponsibility 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.

    • DefaultResponsibleParty

      public DefaultResponsibleParty(org.opengis.metadata.citation.ResponsibleParty 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:

  • Method Details

    • castOrCopy

      public static DefaultResponsibleParty castOrCopy(org.opengis.metadata.citation.ResponsibleParty 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 DefaultResponsibleParty, then it is returned unchanged.
      • Otherwise a new DefaultResponsibleParty 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.

    • getIndividual

      private org.opengis.util.InternationalString getIndividual(boolean position)
      Returns the name or the position of the first individual. If no individual is found in the list of parties, then this method will search in the list of organization members. The latter structure is used by our netCDF reader.
      Parameters:
      position - true for returning the position name instead of individual name.
      Returns:
      the name or position of the first individual, or null.
      See Also:

    • getName

      private static org.opengis.util.InternationalString getName(Collection<? extends AbstractParty> parties, Class<? extends AbstractParty> type, boolean position)
      Returns the name of the first party of the given type, or null if none.
      Parameters:
      position - true for returning the position name instead of individual name.
      Returns:
      the name or position of the first individual, or null.
      See Also:

    • setName

      private void setName(Class<? extends AbstractParty> type, boolean position, org.opengis.util.InternationalString name, Function<org.opengis.util.InternationalString,AbstractParty> creator)
      Sets the name of the first party of the given type. If no existing party is found, generate a new party using the given creator.

    • getIndividualName

      @Deprecated public String getIndividualName()
      Deprecated.
      As of ISO 19115:2014, replaced by getName() in DefaultIndividual.
      Returns the name of the responsible person- surname, given name, title separated by a delimiter. Only one of individualName, organisationName and positionName shall be provided.

      This implementation returns the name of the first Individual found in the collection of parties. If no individual is found in the parties, then this method fallbacks on the first organisation member.

      Specified by:
      getIndividualName in interface org.opengis.metadata.citation.ResponsibleParty
      Returns:
      name, surname, given name and title of the responsible person, or null.

    • setIndividualName

      @Deprecated public void setIndividualName(String newValue)
      Deprecated.
      As of ISO 19115:2014, replaced by setName(InternationalString) in DefaultIndividual.
      Sets the name of the responsible person- surname, given name, title separated by a delimiter. Only one of individualName, organisationName and positionName shall be provided.

      This implementation sets the name of the first Individual found in the collection of parties, or create a new individual if no existing instance was found.

      Parameters:
      newValue - the new individual name, or null if none.

    • individual

      private static AbstractParty individual(org.opengis.util.InternationalString name)
      Generates a new individual from the given name.

    • getOrganisationName

      @Deprecated public org.opengis.util.InternationalString getOrganisationName()
      Deprecated.
      As of ISO 19115:2014, replaced by getName() in DefaultOrganisation.
      Returns the name of the responsible organization. Only one of individualName, organisationName and positionName shall be provided.

      This implementation returns the name of the first Organisation found in the collection of parties.

      Specified by:
      getOrganisationName in interface org.opengis.metadata.citation.ResponsibleParty
      Returns:
      name of the responsible organization, or null.

    • setOrganisationName

      @Deprecated public void setOrganisationName(org.opengis.util.InternationalString newValue)
      Deprecated.
      As of ISO 19115:2014, replaced by setName(InternationalString) in DefaultOrganisation.
      Sets the name of the responsible organization. Only one of individualName, organisationName and positionName shall be provided.

      This implementation sets the name of the first Organisation found in the collection of parties, or create a new organization if no existing instance was found.

      Parameters:
      newValue - the new organization name, or null if none.

    • organisation

      private static AbstractParty organisation(org.opengis.util.InternationalString name)
      Generates a new organization from the given name.

    • getPositionName

      @Deprecated public org.opengis.util.InternationalString getPositionName()
      Deprecated.
      As of ISO 19115:2014, replaced by DefaultIndividual.getPositionName().
      Returns the role or position of the responsible person Only one of individualName, organisationName and positionName shall be provided.

      This implementation returns the position of the first Individual found in the collection of parties. If no individual is found in the parties, then this method fallbacks on the first organisation member.

      Specified by:
      getPositionName in interface org.opengis.metadata.citation.ResponsibleParty
      Returns:
      role or position of the responsible person, or null

    • setPositionName

      @Deprecated public void setPositionName(org.opengis.util.InternationalString newValue)
      Deprecated.
      As of ISO 19115:2014, replaced by DefaultIndividual.setPositionName(InternationalString).
      set the role or position of the responsible person Only one of individualName, organisationName and positionName shall be provided.

      This implementation sets the position name of the first Individual found in the collection of parties, or create a new individual if no existing instance was found.

      Parameters:
      newValue - the new position name, or null if none.

    • position

      private static AbstractParty position(org.opengis.util.InternationalString name)
      Generates a new position from the given name.

    • getContactInfo

      @Deprecated public org.opengis.metadata.citation.Contact getContactInfo()
      Deprecated.
      As of ISO 19115:2014, replaced by AbstractParty.getContactInfo().
      Returns the address of the responsible party.

      This implementation returns the first non-null contact found in the collection of parties.

      Specified by:
      getContactInfo in interface org.opengis.metadata.citation.ResponsibleParty
      Returns:
      address of the responsible party, or null.

    • setContactInfo

      @Deprecated public void setContactInfo(org.opengis.metadata.citation.Contact newValue)
      Deprecated.
      As of ISO 19115:2014, replaced by AbstractParty.setContactInfo(Collection).
      Sets the address of the responsible party.

      This implementation sets the contact info in the first party found in the collection of parties.

      Parameters:
      newValue - the new contact info, or null if none.

    • getRole

      public org.opengis.metadata.citation.Role getRole()
      Returns the function performed by the responsible party.
      Specified by:
      getRole in interface org.opengis.metadata.citation.ResponsibleParty
      Overrides:
      getRole in class DefaultResponsibility
      Returns:
      function performed by the responsible party.

    • setRole

      public void setRole(org.opengis.metadata.citation.Role newValue)
      Sets the function performed by the responsible party.
      Overrides:
      setRole in class DefaultResponsibility
      Parameters:
      newValue - the new role.