Class DefaultRequirement

All Implemented Interfaces:
Serializable, Emptiable, LenientComparable, IdentifiedObject, org.opengis.metadata.acquisition.Requirement

public class DefaultRequirement extends ISOMetadata implements org.opengis.metadata.acquisition.Requirement
Requirement to be satisfied by the planned data acquisition. The following properties are mandatory or conditional (i.e. mandatory under some circumstances) in a well-formed metadata according ISO 19115:
MI_Requirement   ├─identifier……………………………………………………… Unique name, or code, for the requirement.   │   └─code…………………………………………………………… Alphanumeric value identifying an instance in the namespace.   ├─requestor………………………………………………………… Origin of requirement.   │   ├─party………………………………………………………… Information about the parties.   │   │   └─name………………………………………………… Name of the party.   │   └─role…………………………………………………………… Function performed by the responsible party.   ├─recipient………………………………………………………… Person(s), or body(ies), to receive results of requirement.   ├─priority…………………………………………………………… Relative ordered importance, or urgency, of the requirement.   ├─requestedDate……………………………………………… Required or preferred acquisition date and time.   │   ├─requestedDateOfCollection…… Preferred date and time of collection.   │   └─latestAcceptableDate………………… Latest date and time collection must be completed.   └─expiryDate……………………………………………………… Date and time after which collection is no longer valid.

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:
    • citation

      private org.opengis.metadata.citation.Citation citation
      Identification of reference or guidance material for the requirement.
    • requestors

      private Collection<org.opengis.metadata.citation.ResponsibleParty> requestors
      Origin of requirement.
    • recipients

      private Collection<org.opengis.metadata.citation.ResponsibleParty> recipients
      Person(s), or body(ies), to receive results of requirement.
    • priority

      private org.opengis.metadata.acquisition.Priority priority
      Relative ordered importance, or urgency, of the requirement.
    • requestedDate

      private org.opengis.metadata.acquisition.RequestedDate requestedDate
      Required or preferred acquisition date and time.
    • expiryDate

      private long expiryDate
      Date and time after which collection is no longer valid, or Long.MIN_VALUE if none.
    • satisfiedPlans

      private Collection<org.opengis.metadata.acquisition.Plan> satisfiedPlans
      Plan that identifies solution to satisfy the requirement.
  • Constructor Details

    • DefaultRequirement

      public DefaultRequirement()
      Constructs an initially empty requirement.
    • DefaultRequirement

      public DefaultRequirement(org.opengis.metadata.acquisition.Requirement 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 DefaultRequirement castOrCopy(org.opengis.metadata.acquisition.Requirement 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 DefaultRequirement, then it is returned unchanged.
      • Otherwise a new DefaultRequirement 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.
    • getCitation

      public org.opengis.metadata.citation.Citation getCitation()
      Returns the identification of reference or guidance material for the requirement. null if unspecified.
      Specified by:
      getCitation in interface org.opengis.metadata.acquisition.Requirement
      Returns:
      identification of reference or guidance material, or null.
    • setCitation

      public void setCitation(org.opengis.metadata.citation.Citation newValue)
      Sets the identification of reference or guidance material for the requirement.
      Parameters:
      newValue - the new citation value.
    • getIdentifier

      public org.opengis.metadata.Identifier getIdentifier()
      Returns the unique name, or code, for the requirement.
      Specified by:
      getIdentifier in interface org.opengis.metadata.acquisition.Requirement
      Overrides:
      getIdentifier in class ISOMetadata
      Returns:
      unique name or code, or null.
    • setIdentifier

      public void setIdentifier(org.opengis.metadata.Identifier newValue)
      Sets the unique name, or code, for the requirement.
      Overrides:
      setIdentifier in class ISOMetadata
      Parameters:
      newValue - the new identifier value.
    • getRequestors

      public Collection<org.opengis.metadata.citation.ResponsibleParty> getRequestors()
      Returns the origin of requirement.
      Upcoming API change — generalization
      As of ISO 19115:2014, ResponsibleParty is replaced by the Responsibility parent interface. This change will be tentatively applied in GeoAPI 4.0.
      Specified by:
      getRequestors in interface org.opengis.metadata.acquisition.Requirement
      Returns:
      origin of requirement.
    • setRequestors

      public void setRequestors(Collection<? extends org.opengis.metadata.citation.ResponsibleParty> newValues)
      Sets the origin of requirement.
      Upcoming API change — generalization
      As of ISO 19115:2014, ResponsibleParty is replaced by the Responsibility parent interface. This change will be tentatively applied in GeoAPI 4.0.
      Parameters:
      newValues - the new requestors values.
    • getRecipients

      public Collection<org.opengis.metadata.citation.ResponsibleParty> getRecipients()
      Returns the person(s), or body(ies), to receive results of requirement.
      Upcoming API change — generalization
      As of ISO 19115:2014, ResponsibleParty is replaced by the Responsibility parent interface. This change will be tentatively applied in GeoAPI 4.0.
      Specified by:
      getRecipients in interface org.opengis.metadata.acquisition.Requirement
      Returns:
      person(s), or body(ies), to receive results.
    • setRecipients

      public void setRecipients(Collection<? extends org.opengis.metadata.citation.ResponsibleParty> newValues)
      Sets the Person(s), or body(ies), to receive results of requirement.
      Upcoming API change — generalization
      As of ISO 19115:2014, ResponsibleParty is replaced by the Responsibility parent interface. This change will be tentatively applied in GeoAPI 4.0.
      Parameters:
      newValues - the new recipients values.
    • getPriority

      public org.opengis.metadata.acquisition.Priority getPriority()
      Returns the relative ordered importance, or urgency, of the requirement.
      Specified by:
      getPriority in interface org.opengis.metadata.acquisition.Requirement
      Returns:
      relative ordered importance, or urgency, or null.
    • setPriority

      public void setPriority(org.opengis.metadata.acquisition.Priority newValue)
      Sets the relative ordered importance, or urgency, of the requirement.
      Parameters:
      newValue - the new priority value.
    • getRequestedDate

      public org.opengis.metadata.acquisition.RequestedDate getRequestedDate()
      Returns the required or preferred acquisition date and time.
      Specified by:
      getRequestedDate in interface org.opengis.metadata.acquisition.Requirement
      Returns:
      required or preferred acquisition date and time, or null.
    • setRequestedDate

      public void setRequestedDate(org.opengis.metadata.acquisition.RequestedDate newValue)
      Sets the required or preferred acquisition date and time.
      Parameters:
      newValue - the new requested date value.
    • getExpiryDate

      public Date getExpiryDate()
      Returns the date and time after which collection is no longer valid.
      Specified by:
      getExpiryDate in interface org.opengis.metadata.acquisition.Requirement
      Returns:
      date and time after which collection is no longer valid, or null.
    • setExpiryDate

      public void setExpiryDate(Date newValue)
      Sets the date and time after which collection is no longer valid.
      Parameters:
      newValue - the new expiry date.
    • getSatisfiedPlans

      public Collection<org.opengis.metadata.acquisition.Plan> getSatisfiedPlans()
      Returns the plan that identifies solution to satisfy the requirement.
      Specified by:
      getSatisfiedPlans in interface org.opengis.metadata.acquisition.Requirement
      Returns:
      plan that identifies solution to satisfy the requirement.
    • setSatisfiedPlans

      public void setSatisfiedPlans(Collection<? extends org.opengis.metadata.acquisition.Plan> newValues)
      Sets the plan that identifies solution to satisfy the requirement.
      Parameters:
      newValues - the new satisfied plans values.