de.xima.fc.interfaces.file

Interface IConsumingFileHandler

All Known Implementing Classes:

ConsumingFileHandlerImpl

public interface IConsumingFileHandler

Utility methods for working with file consuming actions implementing IConsuming. Contains methods for retrieving the files from previous actions and files from uploaded files.

Author:

XIMA MEDIA GmbH, Dresden - awa - Jul 12, 2018

Method Summary

Modifier and Type	Method and Description
List<Attachment>	getAttachmentsFromUploadElements(IUploadConsuming consuming, Aktion action) Same as #getAttachmentsFromUploadElements(List, Aktion, IWorkflowProcessingContext), but takes the arguments from the given IUploadConsuming belonging to the given action.
List<Attachment>	getAttachmentsFromUploadElements(List<String> uploadElements, Aktion action) Returns a list of all attachments for the given upload elements.
File	getDirWithUploadElements(IUploadConsuming consuming, Aktion action) Same as #getDirWithUploadElements(List, Aktion, IWorkflowProcessingContext), but takes the parameters from the given IUploadConsuming corresponding to the given action.
File	getDirWithUploadElements(List<String> uploadElements, Aktion action) Similar to #getFilesFromUploadElements(List, Aktion, IWorkflowProcessingContext), but returns a File for the directory which contains all the uploaded elements.
Map<? super Object,File>	getFileOrDirsFromPreviousActions(IConsuming consuming, Aktion action) For each previous action as specified by IConsuming.getAktionsIdErgebnisse(), find the file or directory created by that action and returns them.
List<File>	getFilesFromPreviousActions(IConsuming consuming, Aktion action) Returns all files from previous actions as specified by the IConsuming.getAktionsIdErgebnisse().
List<File>	getFilesFromUploadElements(IUploadConsuming consuming, Aktion action) Same as #getFilesFromUploadElements(List, Aktion, IWorkflowProcessingContext), but takes the parameters from the given IUploadConsuming corresponding to the given action.
List<File>	getFilesFromUploadElements(List<String> uploadElements, Aktion action) Returns a list of all files from the given upload elements.

Method Detail

getFileOrDirsFromPreviousActions

Map<? super Object,File> getFileOrDirsFromPreviousActions(IConsuming consuming,
                                                          Aktion action)

For each previous action as specified by IConsuming.getAktionsIdErgebnisse(), find the file or directory created by that action and returns them. Actions that did not create a file or directory are omitted.

Parameters:

consuming - The IConsuming belonging to the given action.

action - A file consuming action whose files to get.

wfpc - The current workflow processing context.

Returns:

A map from the ID of each previous action to the file or directory created by that action.

getFilesFromPreviousActions

List<File> getFilesFromPreviousActions(IConsuming consuming,
                                       Aktion action)

Returns all files from previous actions as specified by the IConsuming.getAktionsIdErgebnisse(). This method does not return any File.isDirectory()s. Instead, it recursively walks all directories and only returns the files they contain.

Parameters:

consuming - The IProcessing for the given action.

action - Action for which to get the files.

wfpc - The current workflow processing context.

Returns:

All files without directories from the specified previous actions.

getAttachmentsFromUploadElements

List<Attachment> getAttachmentsFromUploadElements(IUploadConsuming consuming,
                                                  Aktion action)
                                           throws Exception

Same as #getAttachmentsFromUploadElements(List, Aktion, IWorkflowProcessingContext), but takes the arguments from the given IUploadConsuming belonging to the given action.

Throws:

Exception

See Also:

#getAttachmentsFromUploadElements(List, Aktion, IWorkflowProcessingContext)

getAttachmentsFromUploadElements

List<Attachment> getAttachmentsFromUploadElements(List<String> uploadElements,
                                                  Aktion action)
                                           throws Exception

Returns a list of all attachments for the given upload elements. If no file was uploaded for a certain upload element, the attachment is omitted in the returned list.

Parameters:

uploadElements - Upload elements the given action required. Must contain the FormElement.getAlias() of the form upload element.

action - The current action that is being processed.

wfpc - The current workflow processing context.

Returns:

List of attachments.

Throws:

Exception

getFilesFromUploadElements

List<File> getFilesFromUploadElements(IUploadConsuming consuming,
                                      Aktion action)
                               throws Exception

Same as #getFilesFromUploadElements(List, Aktion, IWorkflowProcessingContext), but takes the parameters from the given IUploadConsuming corresponding to the given action.

Throws:

Exception

See Also:

#getFilesFromUploadElements(List, Aktion, IWorkflowProcessingContext)

getFilesFromUploadElements

List<File> getFilesFromUploadElements(List<String> uploadElements,
                                      Aktion action)
                               throws Exception

Returns a list of all files from the given upload elements. Upload elements with no uploaded file are skipped.

Parameters:

uploadElements - Upload elements the given action required. Must contain the FormElement.getAlias() of the form upload element.

action - The current action that is being processed.

wfpc - The current workflow processing context.

Returns:

List of uploaded files.

Throws:

Exception

getDirWithUploadElements

File getDirWithUploadElements(IUploadConsuming consuming,
                              Aktion action)
                       throws Exception

Same as #getDirWithUploadElements(List, Aktion, IWorkflowProcessingContext), but takes the parameters from the given IUploadConsuming corresponding to the given action.

Throws:

Exception

See Also:

#getDirWithUploadElements(List, Aktion, IWorkflowProcessingContext)

getDirWithUploadElements

File getDirWithUploadElements(List<String> uploadElements,
                              Aktion action)
                       throws Exception

Similar to #getFilesFromUploadElements(List, Aktion, IWorkflowProcessingContext), but returns a File for the directory which contains all the uploaded elements.

Parameters:

uploadElements - Upload elements the given action required. Must contain the FormElement.getAlias() of the form upload element.

action - The current action that is being processed.

wfpc - The current workflow processing context.

Returns:

Directory with all the uploaded files.

Throws:

Exception