Interface IFileListDescriptor

    • Method Detail

      • allowsAnyFiles

        default boolean allowsAnyFiles()
        Whether the constraints of list descriptor allow any files. For example, no files are allowed when the content types are empty; or when the minimum file count is less than the maximum file count.
        Returns:
        Whether the constraints of list descriptor allow any files.
      • builder

        IFileListBuilder builder()
        Creates a new builder for configuring a file list conforming to this descriptor.
        Returns:
        A new builder for configuring a file list conforming to this descriptor.
      • getContentTypes

        Set<String> getContentTypes()
        The content types of the files that might be contained in the list of files. Each content type is a MIME type. Use "*/*" when the content type is unknown or any type of file might be contained in the list. Use an asterisk as a wildcard to allow a range of content types, e.g. "image/*". An empty set allows no files.

        null is treated as if the empty set had been returned.

        Returns:
        The content types of the files that might be contained in the list of files.
      • getExtensions

        Set<String> getExtensions()
        The file extensions of the files that can be contained in the list of files. Each extension is a string without a leading dot, e.g. "pdf" or "png". Use the empty string "" to allow files without an extension. Use a set with a single entry "*" when the extension is unknown or any extension is allowed. An empty set allows no files.

        Implementations should normalize extensions to lower case, so that this method always returns lower case extensions.

        null is treated as if the empty set had been returned.

        Returns:
        The file extensions of the files that can be contained in the list of files.
      • getMaxFileCount

        int getMaxFileCount()
        The maximum number of files that will be contained in the list of files. MAX_VALUE when there is no limit.
        Returns:
        The maximum number of files that will be contained in the list of files.
      • getMinFileCount

        int getMinFileCount()
        The minimum number of files that are contained in the list of files. 0 when the list might be empty, 1 if the list will contain at least one file.
        Returns:
        The minimum number of files that are contained in the list of files.
      • intersect

        IFileListDescriptor intersect​(IFileListDescriptor other)
        Intersects this file list descriptor with another file list descriptor. The intersection of two file list descriptors is a new file list descriptor that only allows files that are allowed by both file list descriptors. When the two file list descriptors are incompatible, returns an empty descriptor.

        This operation is, for the most part, symmetric / commutative. The only exception is the attribute map of the files. When both input descriptors have an attribute with the same key but different values, the value from the right hand side is used.

        Parameters:
        other - The other file list descriptor to intersect with.
        Returns:
        The intersection of this file list descriptor with the other file list descriptor.