Package com.finconsgroup.itserr.marketplace.usercommunication.dm.service.impl

Class OfflineMessageServiceImpl

java.lang.Object

com.finconsgroup.itserr.marketplace.usercommunication.dm.service.impl.OfflineMessageServiceImpl

All Implemented Interfaces:

OfflineMessageService

@Service
@Transactional
public class OfflineMessageServiceImpl
extends Object
implements OfflineMessageService

Service implementation handling offline message queuing, notifications, and delivery.

Constructor Summary

Constructors

Constructor	Description
OfflineMessageServiceImpl()

Method Summary

Modifier and Type	Method	Description
void	cleanupOldDeliveredMessages(int daysOld)	Cleanup delivered messages older than a threshold to keep storage tidy.
void	deliverOfflineMessages(UUID userId)	Deliver all queued messages to a user and mark them delivered.
long	getUndeliveredMessageCount(UUID userId)	Count undelivered messages for a user across all conversations.
long	getUndeliveredMessageCount(UUID userId, UUID conversationId)	Count undelivered messages for a user in a specific conversation.
List<OfflineMessage>	getUndeliveredMessages(UUID userId)	Retrieve undelivered messages for a user (oldest first).
OutputUnreadMessageSummaryDto	getUnreadMessageSummary(UUID userId)	Get unread message summary for a user
void	handleMessageDelivery(ChatMessage chatMessage, UUID recipientUserId)	Attempt immediate delivery if user online; otherwise queue for later.
boolean	isUserOnline(UUID userId)	Best-effort check if a user is online (e.g., via WebSocket reachability).
void	notifyUserAboutPendingMessages(UUID userId)	Notify a user that they have pending messages, typically when they connect/subscribe.
void	queueMessageForOfflineUser(ChatMessage chatMessage, UUID recipientUserId)	Queue a message for a recipient who is currently offline (or when direct delivery fails).
void	sendOfflineMessageNotification(UUID userId)	Send a generic offline notification to a user about pending messages.

Methods inherited from class java.lang.Object

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

Constructor Details

OfflineMessageServiceImpl

public OfflineMessageServiceImpl()

Method Details

queueMessageForOfflineUser

public void queueMessageForOfflineUser(ChatMessage chatMessage,
 UUID recipientUserId)

Description copied from interface: OfflineMessageService

Queue a message for a recipient who is currently offline (or when direct delivery fails).

Specified by:

queueMessageForOfflineUser in interface OfflineMessageService

Parameters:

chatMessage - the message to queue

recipientUserId - the offline recipient's user ID

notifyUserAboutPendingMessages

public void notifyUserAboutPendingMessages(UUID userId)

Description copied from interface: OfflineMessageService

Notify a user that they have pending messages, typically when they connect/subscribe.

Specified by:

notifyUserAboutPendingMessages in interface OfflineMessageService

Parameters:

userId - the user to notify

deliverOfflineMessages

public void deliverOfflineMessages(UUID userId)

Description copied from interface: OfflineMessageService

Deliver all queued messages to a user and mark them delivered.

Specified by:

deliverOfflineMessages in interface OfflineMessageService

Parameters:

userId - the recipient user ID

isUserOnline

public boolean isUserOnline(UUID userId)

Description copied from interface: OfflineMessageService

Best-effort check if a user is online (e.g., via WebSocket reachability).

Specified by:

isUserOnline in interface OfflineMessageService

Parameters:

userId - the user ID

Returns:

true if the user appears online

getUndeliveredMessageCount

public long getUndeliveredMessageCount(UUID userId)

Description copied from interface: OfflineMessageService

Count undelivered messages for a user across all conversations.

Specified by:

getUndeliveredMessageCount in interface OfflineMessageService

Parameters:

userId - the user ID

Returns:

number of undelivered messages

getUndeliveredMessageCount

public long getUndeliveredMessageCount(UUID userId,
 UUID conversationId)

Description copied from interface: OfflineMessageService

Count undelivered messages for a user in a specific conversation.

Specified by:

getUndeliveredMessageCount in interface OfflineMessageService

Parameters:

userId - the user ID

conversationId - the conversation ID

Returns:

number of undelivered messages in the conversation

getUndeliveredMessages

public List<OfflineMessage> getUndeliveredMessages(UUID userId)

Description copied from interface: OfflineMessageService

Retrieve undelivered messages for a user (oldest first).

Specified by:

getUndeliveredMessages in interface OfflineMessageService

Parameters:

userId - the user ID

Returns:

list of offline message records

getUnreadMessageSummary

public OutputUnreadMessageSummaryDto getUnreadMessageSummary(UUID userId)

Description copied from interface: OfflineMessageService

Get unread message summary for a user

Specified by:

getUnreadMessageSummary in interface OfflineMessageService

Parameters:

userId - the user ID

Returns:

the unread message summary

cleanupOldDeliveredMessages

public void cleanupOldDeliveredMessages(int daysOld)

Description copied from interface: OfflineMessageService

Cleanup delivered messages older than a threshold to keep storage tidy.

Specified by:

cleanupOldDeliveredMessages in interface OfflineMessageService

Parameters:

daysOld - threshold in days

handleMessageDelivery

public void handleMessageDelivery(ChatMessage chatMessage,
 UUID recipientUserId)

Description copied from interface: OfflineMessageService

Attempt immediate delivery if user online; otherwise queue for later.

Specified by:

handleMessageDelivery in interface OfflineMessageService

Parameters:

chatMessage - the message

recipientUserId - the recipient user ID

sendOfflineMessageNotification

public void sendOfflineMessageNotification(UUID userId)

Description copied from interface: OfflineMessageService

Send a generic offline notification to a user about pending messages. Kept for backward compatibility; notifyUserAboutPendingMessages is preferred.

Specified by:

sendOfflineMessageNotification in interface OfflineMessageService

Parameters:

userId - the user ID