Class FormRecordMessageHandler

java.lang.Object

de.xima.fc.handler.AMSApiHandler

de.xima.fc.handler.entity.GenericHandler

de.xima.fc.handler.entity.FormRecordMessageHandler

All Implemented Interfaces:

IAPIHandler, IFormRecordMessageHandler, IGenericHandler, Serializable

public class FormRecordMessageHandler
extends GenericHandler
implements IFormRecordMessageHandler

Handler implementation for reading and writing FormRecordMessage entities.

Since:

8.2.0

Author:

XIMA Media GmbH

See Also:

• Serialized Form

Field Summary

Fields inherited from class GenericHandler

LOG

Constructor Summary

Constructors

Constructor	Description
FormRecordMessageHandler()

Method Summary

Modifier and Type	Method	Description
IFulfillRequestedUploadResponse	fulfillUploadRequest(UserContext userContext, IFulfillRequestedUploadRequest fulfillRequestUploadRequest)	Fulfills a pending upload request.
PagedResult<FormRecordMessage>	getByChatAndUser(UserContext uc, UUID chatUuid, IUser user, int page, int pageSize)	Deprecated.
List<FormRecordMessage>	getByUser(UserContext uc, IUser user)	Returns all messages the given user has access to.
PagedResult<FormRecordMessage>	getByUser(UserContext uc, IUser user, int page, int pageSize)	Finds all form record messages the user given by the user context has access to.
FormRecordMessage	getByUuid(UserContext uc, UUID uuid)	Finds the message for the given UUID.
FormRecordMessage	getByUuidAndUser(UserContext uc, UUID uuid, IUser user)	Finds the message for the given UUID, which the given user can access.
List<FormRecordMessage>	getChatMessages(UserContext uc, UUID chatUuid)	Returns all messages for the given chat UUID ordered by their sent instant (desc).
DetailedFormRecordMessageDTO	getDetailsByUuidAndUser(UserContext uc, UUID uuid, IUser user, Locale locale)	Finds the detailed message for the given UUID, which the given user can access.
PagedResult<BaseFormRecordMessageDTO>	getMessagePage(UserContext uc, PageQuery pageQuery, FormRecordMessagesQuery messagesQuery, boolean skipCount)	Returns a page of form record messages for the given page query and messages query.
PagedResult<FormRecordMessage>	getUnreadByUser(UserContext uc, IUser user, int page, int pageSize)	Finds all unread form record messages the user given by the user context has access to.
IPostFormRecordMessageResponse	postMessage(UserContext userContext, IPostFormRecordMessageRequest postMessageRequest)	Posts a form record message, either to an existing chat or to a new chat.

Methods inherited from class GenericHandler

create, create, delete, delete, deleteBy, deleteById, deleteById, getAll, getAllBy, getAttributes, getAttributes, getBy, getById, getById, getById, getEntityRefs, getSingleAttributes, getSingleAttributes, resultTotalCount, serializableList, update, update

Methods inherited from class AMSApiHandler

getName

Methods inherited from class Object

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

Methods inherited from interface IAPIHandler

getName

Methods inherited from interface IGenericHandler

create, create, delete, delete, deleteBy, deleteById, deleteById, getAll, getAllBy, getAttributes, getAttributes, getBy, getById, getById, getById, getEntityRefs, getSingleAttributes, getSingleAttributes, resultTotalCount, update, update

Constructor Details

FormRecordMessageHandler

public FormRecordMessageHandler()

Method Details

fulfillUploadRequest

public IFulfillRequestedUploadResponse fulfillUploadRequest(UserContext userContext,
 IFulfillRequestedUploadRequest fulfillRequestUploadRequest)
                                                     throws FulfillRequestedUploadRequestException

Fulfills a pending upload request. This will set the attachments on the upload request. Performs all necessary actions such as updating the form data, triggering workflow events etc. The upload request must be pending.

Specified by:

fulfillUploadRequest in interface IFormRecordMessageHandler

Parameters:

userContext - The user context for accessing the database

fulfillRequestUploadRequest - The request with the data to fulfill the upload request.

Returns:

The response of the post message request

Throws:

FulfillRequestedUploadRequestException - If the upload request could not be fulfilled.

getByChatAndUser

@Deprecated
public PagedResult<FormRecordMessage> getByChatAndUser(UserContext uc,
 UUID chatUuid,
 IUser user,
 int page,
 int pageSize)

Deprecated.

Description copied from interface: IFormRecordMessageHandler

Finds the messages for the form record chat given by its UUID if the given user can access the chat.

Specified by:

getByChatAndUser in interface IFormRecordMessageHandler

Parameters:

uc - user context for accessing the database.

chatUuid - the UUID of the chat

user - to get the form record messages for.

page - to get.

pageSize - size of the page to get.

Returns:

a list of form record messages the user has access to ordered by their sent instant (desc). null if the chat given by the UUID could not be found.

See Also:

• IFormRecordMessageHandler.getMessagePage(UserContext, PageQuery, FormRecordMessagesQuery, boolean)

getByUser

public PagedResult<FormRecordMessage> getByUser(UserContext uc,
 IUser user,
 int page,
 int pageSize)

Description copied from interface: IFormRecordMessageHandler

Finds all form record messages the user given by the user context has access to.

Specified by:

getByUser in interface IFormRecordMessageHandler

Parameters:

uc - user context holding the requesting user.

user - to get the form record messages for.

page - to get.

pageSize - size of the page to get.

Returns:

a list of form record messages the user has access to ordered by their creation instant (desc).

See Also:

• IFormRecordMessageHandler.getByUser(UserContext, IUser)

getMessagePage

public PagedResult<BaseFormRecordMessageDTO> getMessagePage(UserContext uc,
 PageQuery pageQuery,
 FormRecordMessagesQuery messagesQuery,
 boolean skipCount)

Description copied from interface: IFormRecordMessageHandler

Returns a page of form record messages for the given page query and messages query.

Specified by:

getMessagePage in interface IFormRecordMessageHandler

Parameters:

uc - user context for database transactions.

pageQuery - page query to get the messages.

messagesQuery - messagesQuery to apply to the messages.

skipCount - whether to skip the count query.

Returns:

a list of form record messages in the order defined by the messages query.

getByUser

public List<FormRecordMessage> getByUser(UserContext uc,
 IUser user)

Description copied from interface: IFormRecordMessageHandler

Returns all messages the given user has access to. The user has access to all messages of chats they have access to.

Specified by:

getByUser in interface IFormRecordMessageHandler

Parameters:

uc - user context holding the requesting user.

user - to get the form record messages for.

Returns:

a list of form record messages the user has access to ordered by their sent instant (desc).

See Also:

• IFormRecordChatHandler.getByUser(UserContext, de.xima.fc.interfaces.user.IUser)

getByUuid

public FormRecordMessage getByUuid(UserContext uc,
 UUID uuid)

Description copied from interface: IFormRecordMessageHandler

Finds the message for the given UUID.

Specified by:

getByUuid in interface IFormRecordMessageHandler

Parameters:

uc - user context for accessing the database

uuid - the UUID of the message

Returns:

The message with the given UUID

getByUuidAndUser

public FormRecordMessage getByUuidAndUser(UserContext uc,
 UUID uuid,
 IUser user)

Description copied from interface: IFormRecordMessageHandler

Finds the message for the given UUID, which the given user can access.

Specified by:

getByUuidAndUser in interface IFormRecordMessageHandler

Parameters:

uc - user context holding the requesting user.

uuid - the UUID of the message

user - to get the form record message for.

Returns:

The message with the given UUID which the user can access and null otherwise.

getDetailsByUuidAndUser

public DetailedFormRecordMessageDTO getDetailsByUuidAndUser(UserContext uc,
 UUID uuid,
 IUser user,
 Locale locale)

Description copied from interface: IFormRecordMessageHandler

Finds the detailed message for the given UUID, which the given user can access.

Specified by:

getDetailsByUuidAndUser in interface IFormRecordMessageHandler

Parameters:

uc - user context holding the requesting user.

uuid - the UUID of the message

user - to get the form record message for.

locale - the locale for which to return the message (metadata)

Returns:

The message with the given UUID which the user can access and null otherwise.

getChatMessages

public List<FormRecordMessage> getChatMessages(UserContext uc,
 UUID chatUuid)

Description copied from interface: IFormRecordMessageHandler

Returns all messages for the given chat UUID ordered by their sent instant (desc). This is intended for displaying the chat in the backoffice inbox.

Specified by:

getChatMessages in interface IFormRecordMessageHandler

Parameters:

uc - user context for accessing the database

chatUuid - the UUID of the chat

Returns:

a list of all form record messages for the chat ordered by their sent instant (desc).

getUnreadByUser

public PagedResult<FormRecordMessage> getUnreadByUser(UserContext uc,
 IUser user,
 int page,
 int pageSize)

Description copied from interface: IFormRecordMessageHandler

Finds all unread form record messages the user given by the user context has access to. Unread messages can only be gotten for users with UserProfiles. For users without a profile all messages will be returned.

Specified by:

getUnreadByUser in interface IFormRecordMessageHandler

Parameters:

uc - user context holding the requesting user.

user - to get the unread form record messages for.

page - to get.

pageSize - size of the page to get.

Returns:

a list of unread form record messages the user has access to ordered by their creation instant (desc).

See Also:

• IFormRecordMessageHandler.getByUser(UserContext, IUser)

postMessage

public IPostFormRecordMessageResponse postMessage(UserContext userContext,
 IPostFormRecordMessageRequest postMessageRequest)
                                           throws PostFormRecordMessageException

Description copied from interface: IFormRecordMessageHandler

Posts a form record message, either to an existing chat or to a new chat. Performs all necessary actions such as triggering workflow events etc.

Specified by:

postMessage in interface IFormRecordMessageHandler

Parameters:

userContext - The user context of the user who initiated the post message request.

postMessageRequest - The request to post the message.

Returns:

The response of the post message request.

Throws:

PostFormRecordMessageException - If the message could not be posted.