de.xima.fc.api.entity

Class AttachmentAPI

java.lang.Object

de.xima.fc.api.ASubAPI

de.xima.fc.api.entity.AEntityAPI<Attachment>

de.xima.fc.api.entity.AttachmentAPI

public class AttachmentAPI
extends AEntityAPI<Attachment>

API class for manipulation of Attachment entities.

Author:

Michael Kohlsche

Field Summary

Fields inherited from class de.xima.fc.api.entity.AEntityAPI

entityClass

Constructor Summary

Constructors

Constructor and Description
AttachmentAPI()

Method Summary

Modifier and Type	Method and Description
boolean	checkAttachmentsHash(UserContext uc, String prozessId, String sessionId, int hash) Method for checking if the hashkey is correct for the attachments of a Vorgang.
Boolean	delete(UserContext uc, Attachment attachment) Method for deleting a Attachments.
Boolean	delete(UserContext uc, Attachment[] attachments) Method for deleting multiple Attachments.
boolean	deleteByUser(UserContext uc, String username, Attachment... attachments)
List<Attachment>	getAllBy(UserContext uc, Vorgang vorgang, EAttachmentSource source, String uuid)
Attachment	getAttachment(UserContext uc, String prozessId, String sessionId, int hash) Method for resolving a hash key to an attachment name.
InputStream	getAttachmentFileStream(UserContext uc, String prozessID, Number id) Method for reading a attachment file.
InputStream	getAttachmentFileStream(UserContext uc, String prozessID, String name) Method for reading a attachment file.
List<Attachment>	getAttachmentList(UserContext uc, String prozessID) Method for outputting all attachments of a process.
List<Attachment>	getAttachmentListByType(UserContext uc, String prozessID, EAttachmentSource source) Method for outputting all attachments by type of a process.
Attachment	getByName(UserContext uc, Vorgang vorgang, String name)
Attachment	getByUUID(UserContext uc, String atid)
Attachment	getByUUID(UserContext uc, String atid, Vorgang v)
InputStream	getZippedAttachments(UserContext uc, String prozessID) Method for reading of attachments as a InputStream on a ZIP archive.

Methods inherited from class de.xima.fc.api.entity.AEntityAPI

create, create, deleteAllBy, deleteById, deleteById, getAll, getAllBy, getBy, getById, getById, resultTotalCount, update, update

Methods inherited from class de.xima.fc.api.ASubAPI

getHandlerProvider

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AttachmentAPI

public AttachmentAPI()

Method Detail

delete

public Boolean delete(UserContext uc,
                      Attachment[] attachments)

Method for deleting multiple Attachments.

Overrides:

delete in class AEntityAPI<Attachment>

Parameters:

uc - UserContext the user context in which the action is to be performed.

attachments - Array of Attachments which should be deleted.

Returns:

true if the deletion was successful.

Since:

2.4.3

See Also:

AEntityAPI.delete(UserContext, ITransferableEntity[])

getAttachmentFileStream

public InputStream getAttachmentFileStream(UserContext uc,
                                           String prozessID,
                                           String name)
                                    throws FileNotFoundException

Method for reading a attachment file.

Parameters:

uc - UserContext the user context in which the action is to be performed.

prozessID - the process ID of Vorgang for which the attachment should be loaded.

name - of the Attachment, which should be loaded.

Returns:

InputStream of the Attachment

Throws:

FileNotFoundException - if the file couldn't found.

Since:

2.4.3

getAttachmentFileStream

public InputStream getAttachmentFileStream(UserContext uc,
                                           String prozessID,
                                           Number id)
                                    throws FileNotFoundException

Method for reading a attachment file.

Parameters:

uc - UserContext the user context in which the action is to be performed.

prozessID - the process ID of Vorgang for which the attachment should be loaded.

id - of the Attachments, which should be loaded.

Returns:

InputStream of the Attachment.

Throws:

FileNotFoundException - if the file couldn't found.

Since:

2.4.3

getAttachmentList

public List<Attachment> getAttachmentList(UserContext uc,
                                          String prozessID)

Method for outputting all attachments of a process.

Parameters:

uc - UserContext the user context in which the action is to be performed.

prozessID - the process ID of Vorgang for which the attachment should be loaded.

Returns:

List with Attachments of a Vorgang.

Since:

2.4.3

getAttachmentListByType

public List<Attachment> getAttachmentListByType(UserContext uc,
                                                String prozessID,
                                                EAttachmentSource source)

Method for outputting all attachments by type of a process.

Parameters:

uc - UserContext the user context in which the action is to be performed.

prozessID - the process ID of Vorgang for which the attachment should be loaded.

source - EAttachmentSource type of the attachment.

Returns:

List with Attachments of a Vorgang.

Since:

3.1.7

getZippedAttachments

public InputStream getZippedAttachments(UserContext uc,
                                        String prozessID)
                                 throws IOException

Method for reading of attachments as a InputStream on a ZIP archive.

Parameters:

uc - UserContext the user context in which the action is to be performed.

prozessID - the process ID of Vorgang for which the attachment should be loaded.

Returns:

InputStream on all Attachments of the Vorgang as a ZIP

Throws:

IOException - if a error occurs while reading the file.

Since:

2.4.3

delete

public Boolean delete(UserContext uc,
                      Attachment attachment)

Method for deleting a Attachments.

Overrides:

delete in class AEntityAPI<Attachment>

Parameters:

uc - UserContext the user context in which the action is to be performed.

attachment - which should be deleted.

Returns:

true if the deletion was successful.

Since:

2.4.3

See Also:

AEntityAPI.delete(UserContext, ITransferableEntity)

deleteByUser

public boolean deleteByUser(UserContext uc,
                            String username,
                            Attachment... attachments)

checkAttachmentsHash

public boolean checkAttachmentsHash(UserContext uc,
                                    String prozessId,
                                    String sessionId,
                                    int hash)

Method for checking if the hashkey is correct for the attachments of a Vorgang.

Parameters:

uc - UserContext the user context in which the action is to be performed.

prozessId - the process ID of Vorgang for which the attachment should be loaded.

sessionId - the current session ID of the user.

hash - to be tested against.

Returns:

true if the hash values are identical.

Since:

2.4.3

getAttachment

public Attachment getAttachment(UserContext uc,
                                String prozessId,
                                String sessionId,
                                int hash)

Method for resolving a hash key to an attachment name.

Parameters:

uc - UserContext the user context in which the action is to be performed.

prozessId - the process ID of Vorgang for which the attachment should be loaded.

sessionId - the current session ID of the user.

hash - value used to verify the the correct Attachment is being delivered.

Returns:

Attachment if Vorgang exist and the Attachment exist, otherwise null

Since:

2.4.3

getByUUID

public Attachment getByUUID(UserContext uc,
                            String atid)

getByUUID

public Attachment getByUUID(UserContext uc,
                            String atid,
                            Vorgang v)

getByName

public Attachment getByName(UserContext uc,
                            Vorgang vorgang,
                            String name)

getAllBy

public List<Attachment> getAllBy(UserContext uc,
                                 Vorgang vorgang,
                                 EAttachmentSource source,
                                 String uuid)