Class AbstractAssociation

    • Method Detail

      • getRole

        public DefaultAssociationRole getRole()
        Returns information about the association.
        Warning: In a future SIS version, the return type may be changed to org​.opengis​.feature​.Association­Role. This change is pending GeoAPI revision.
        Returns:
        information about the association.
      • getValues

        public Collection<AbstractFeature> getValues()
        Returns all features, or an empty collection if none. The returned collection is live: changes in the returned collection will be reflected immediately in this Association instance, and conversely.

        The default implementation returns a collection which will delegate its work to get­Value() and set­Value(Object).

        Returns:
        the features in a live collection.
      • setValue

        public abstract void setValue​(AbstractFeature value)
                               throws IllegalArgumentException
        Sets the associated feature.
        Warning: In a future SIS version, the argument type may be changed to org​.opengis​.feature​.Feature. This change is pending GeoAPI revision.
        Validation
        The amount of validation performed by this method is implementation dependent. Usually, only the most basic constraints are verified. This is so for performance reasons and also because some rules may be temporarily broken while constructing a feature. A more exhaustive verification can be performed by invoking the quality() method.
        Parameters:
        value - the new value, or null.
        Throws:
        Illegal­Argument­Exception - if the given feature is not valid for this association.
        See Also:
        Abstract­Feature​.set­Property­Value(String, Object)
      • toString

        public String toString()
        Returns a string representation of this association. The returned string is for debugging purpose and may change in any future SIS version.
        Overrides:
        to­String in class Object
        Returns:
        a string representation of this association for debugging purpose.
      • clone

        public AbstractAssociation clone()
                                  throws CloneNotSupportedException
        Returns a copy of this association. The default implementation returns a shallow copy: the association value is not cloned. However subclasses may choose to do otherwise.
        Overrides:
        clone in class Object
        Returns:
        a clone of this association.
        Throws:
        Clone­Not­Supported­Exception - if this association can not be cloned. The default implementation never throw this exception. However subclasses may throw it.