Class DateVersionSelector

  • All Implemented Interfaces:
    VersionSelector

    public class DateVersionSelector
    extends Object
    implements VersionSelector
    This Class implements a version selector that selects a version by creation date. The selected version is the latest that is older or equal than the given date. If no version could be found null is returned unless the returnLatest flag is set to true, where the latest version is returned.
     V1.0 - 02-Sep-2006
     V1.1 - 03-Sep-2006
     V1.2 - 05-Sep-2006
    
     new DateVersionSelector("03-Sep-2006").select() -> V1.1
     new DateVersionSelector("04-Sep-2006").select() -> V1.1
     new DateVersionSelector("01-Sep-2006").select() -> null
     new DateVersionSelector("01-Sep-2006", true).select() -> V1.2
     new DateVersionSelector(null, true).select() -> V1.2
     
    • Constructor Detail

      • DateVersionSelector

        public DateVersionSelector​(Calendar date)
        Creates a DateVersionSelector that will select the latest version of all those that are older than the given date.
        Parameters:
        date - reference date
      • DateVersionSelector

        public DateVersionSelector​(Calendar date,
                                   boolean returnLatest)
        Creates a DateVersionSelector that will select the latest version of all those that are older than the given date.
        Parameters:
        date - reference date
        returnLatest - if true latest is selected
    • Method Detail

      • getDate

        public Calendar getDate()
        Returns the date hint
        Returns:
        the date hint.
      • setDate

        public void setDate​(Calendar date)
        Sets the date hint
        Parameters:
        date - reference date
      • isReturnLatest

        public boolean isReturnLatest()
        Returns the flag, if the latest version should be selected, if no version can be found using the given hint.
        Returns:
        true if it returns latest.
      • setReturnLatest

        public void setReturnLatest​(boolean returnLatest)
        Sets the flag, if the latest version should be selected, if no version can be found using the given hint.
        Parameters:
        returnLatest - the returnLatest flag
      • select

        public InternalVersion select​(InternalVersionHistory versionHistory)
                               throws RepositoryException
        Selects a version of the given version history. If this VersionSelector is unable to select one, it can return null. Please note, that a version selector is not allowed to return the root version. Selects a version from the given version history using the previously assigned hint in the following order: name, label, date, latest.
        Specified by:
        select in interface VersionSelector
        Parameters:
        versionHistory - version history to select a version from
        Returns:
        A version or null.
        Throws:
        RepositoryException - if an error occurs.
      • toString

        public String toString()
        returns debug information
        Overrides:
        toString in class Object
        Returns:
        debug information