Interface IFileListDescriptor
-
- All Superinterfaces:
Serializable
- All Known Implementing Classes:
FileListDescriptor
public interface IFileListDescriptor extends Serializable
A descriptor for a list of files provided by a workflow trigger or node when the trigger fires or the node gets executed.- Since:
- 8.2.0
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description default boolean
allowsAnyFiles()
Whether the constraints of list descriptor allow any files.IFileListBuilder
builder()
Creates a new builder for configuring a file list conforming to this descriptor.Set<String>
getContentTypes()
The content types of the files that might be contained in the list of files.String
getDescription()
Gets the description for the file.int
getMaxFileCount()
The maximum number of files that will be contained in the list of files.int
getMinFileCount()
The minimum number of files that are contained in the list of files.IFileListDescriptor
intersect(IFileListDescriptor other)
Intersects this file list descriptor with another file list descriptor.boolean
isDescriptionHtml()
Whether thegetDescription()
is an HTML string (make sure it's valid and properly escaped!).boolean
isDescriptionI18nKey()
Whether thegetDescription()
is an I18N key that needs to be looked up in a resource bundle.
-
-
-
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. 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.
-
getDescription
String getDescription()
Gets the description for the file. Can be either a localized message or an I18N key.- Returns:
- I18n key pointing to a description for the file.
-
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 anempty
descriptor.- Parameters:
other
- The other file list descriptor to intersect with.- Returns:
- The intersection of this file list descriptor with the other file list descriptor.
-
isDescriptionHtml
boolean isDescriptionHtml()
Whether thegetDescription()
is an HTML string (make sure it's valid and properly escaped!). When false, the description is treated as plain text.- Returns:
- Whether the description is an HTML string.
-
isDescriptionI18nKey
boolean isDescriptionI18nKey()
Whether thegetDescription()
is an I18N key that needs to be looked up in a resource bundle. When false, the description value is used as-is.- Returns:
- Whether the description is an I18N key (true) or a plain text description (false).
-
-