Package com.bytedesk.service.queue_member

Class QueueMemberRestService

java.lang.Object

com.bytedesk.core.base.BaseRestService<T,TRequest,TResponse>

com.bytedesk.core.base.BaseRestServiceWithExport<QueueMemberEntity,QueueMemberRequest,QueueMemberResponse,QueueMemberExcel>

com.bytedesk.service.queue_member.QueueMemberRestService

@Service
public class QueueMemberRestService
extends BaseRestServiceWithExport<QueueMemberEntity,QueueMemberRequest,QueueMemberResponse,QueueMemberExcel>

Field Summary

Fields

Modifier and Type	Field	Description
private final org.modelmapper.ModelMapper	modelMapper
private final QueueMemberRepository	queueMemberRepository
private final ThreadRestService	threadRestService
private final org.springframework.transaction.PlatformTransactionManager	transactionManager
private final UidUtils	uidUtils

Fields inherited from class com.bytedesk.core.base.BaseRestService

authService

Constructor Summary

Constructors

Constructor	Description
QueueMemberRestService()

Method Summary

Modifier and Type	Method	Description
QueueMemberExcel	convertToExcel(QueueMemberEntity entity)	转换为Excel对象 子类必须实现此方法
QueueMemberResponse	convertToResponse(QueueMemberEntity entity)
int	countQueuingByAgentQueueUid(String agentQueueUid)	统计客服队列中处于排队状态的会话数
int	countUnassignedQueuingByWorkgroupQueueUids(List<String> workgroupQueueUids)	统计工作组队列中未分配客服且处于排队状态的会话数
QueueMemberResponse	create(QueueMemberRequest request)
ThreadEntity	createAgentQueueThread(AgentEntity agent)	客服排队会话：org/queue/{agent_uid}
protected org.springframework.data.jpa.domain.Specification<QueueMemberEntity>	createSpecification(QueueMemberRequest request)	创建Specification对象，子类必须实现 用于queryByOrg的通用实现
void	delete(QueueMemberRequest entity)
void	deleteAll()
void	deleteByUid(String uid)
protected QueueMemberEntity	doSave(QueueMemberEntity entity)	子类实现具体的保存逻辑
protected org.springframework.data.domain.Page<QueueMemberEntity>	executePageQuery(org.springframework.data.jpa.domain.Specification<QueueMemberEntity> spec, org.springframework.data.domain.Pageable pageable)	执行分页查询，子类必须实现 用于queryByOrg的通用实现
org.springframework.data.domain.Page<QueueMemberResponse>	findAgentQueueMembers(String agentQueueUid, org.springframework.data.domain.Pageable pageable)
Optional<QueueMemberEntity>	findByThreadUid(String threadUid)
Optional<QueueMemberEntity>	findByUid(String uid)
Optional<QueueMemberEntity>	findEarliestAgentQueueMember(String agentQueueUid)
Optional<QueueMemberEntity>	findEarliestAgentQueueMemberForUpdate(String agentQueueUid)
Optional<QueueMemberEntity>	findEarliestRobotQueueMember(String robotQueueUid)
Optional<QueueMemberEntity>	findEarliestWorkgroupQueueMember(String workgroupQueueUid)
List<QueueMemberEntity>	findQueuingMembersByWorkgroupQueueUid(String workgroupQueueUid)
QueueMemberEntity	handleOptimisticLockingFailureException(org.springframework.orm.ObjectOptimisticLockingFailureException e, QueueMemberEntity entity)
int	nextQueueNumber(QueueEntity queue, QueueTypeEnum queueType)
void	saveAsyncBestEffort(QueueMemberEntity entity)	QueueMember 的部分更新并不要求强一致（例如：acceptedAt、offline 标记、计数等）。
QueueMemberResponse	update(QueueMemberRequest request)

Methods inherited from class com.bytedesk.core.base.BaseRestServiceWithExport

queryByOrgEntity

Methods inherited from class com.bytedesk.core.base.BaseRestService

deleteByOrgUid, findByOrgUid, getUidFromRequest, queryByOrg, queryByUid, queryByUser, recover, save, setUserUidToRequest

Methods inherited from class java.lang.Object

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

Field Details

queueMemberRepository

private final QueueMemberRepository queueMemberRepository

modelMapper

private final org.modelmapper.ModelMapper modelMapper

uidUtils

private final UidUtils uidUtils

threadRestService

private final ThreadRestService threadRestService

transactionManager

private final org.springframework.transaction.PlatformTransactionManager transactionManager

Constructor Details

QueueMemberRestService

public QueueMemberRestService()

Method Details

findByUid

public Optional<QueueMemberEntity> findByUid(String uid)

Specified by:

findByUid in class BaseRestService<QueueMemberEntity,QueueMemberRequest,QueueMemberResponse>

findByThreadUid

public Optional<QueueMemberEntity> findByThreadUid(String threadUid)

create

public QueueMemberResponse create(QueueMemberRequest request)

Specified by:

create in class BaseRestService<QueueMemberEntity,QueueMemberRequest,QueueMemberResponse>

update

public QueueMemberResponse update(QueueMemberRequest request)

Specified by:

update in class BaseRestService<QueueMemberEntity,QueueMemberRequest,QueueMemberResponse>

doSave

protected QueueMemberEntity doSave(QueueMemberEntity entity)

Description copied from class: BaseRestService

子类实现具体的保存逻辑

Specified by:

doSave in class BaseRestService<QueueMemberEntity,QueueMemberRequest,QueueMemberResponse>

saveAsyncBestEffort

@Async
public void saveAsyncBestEffort(QueueMemberEntity entity)

QueueMember 的部分更新并不要求强一致（例如：acceptedAt、offline 标记、计数等）。 将这些更新放到异步 + 新事务中 best-effort 执行： - 避免乐观锁冲突把主流程事务标记为 rollback-only - 冲突时仅记录日志，不影响主流程

deleteByUid

@CacheEvict(value="queue_member",
            key="#uid")
public void deleteByUid(String uid)

Specified by:

deleteByUid in class BaseRestService<QueueMemberEntity,QueueMemberRequest,QueueMemberResponse>

delete

public void delete(QueueMemberRequest entity)

Specified by:

delete in class BaseRestService<QueueMemberEntity,QueueMemberRequest,QueueMemberResponse>

deleteAll

public void deleteAll()

handleOptimisticLockingFailureException

public QueueMemberEntity handleOptimisticLockingFailureException(org.springframework.orm.ObjectOptimisticLockingFailureException e,
 QueueMemberEntity entity)

Specified by:

handleOptimisticLockingFailureException in class BaseRestService<QueueMemberEntity,QueueMemberRequest,QueueMemberResponse>

convertToResponse

public QueueMemberResponse convertToResponse(QueueMemberEntity entity)

Specified by:

convertToResponse in class BaseRestService<QueueMemberEntity,QueueMemberRequest,QueueMemberResponse>

convertToExcel

public QueueMemberExcel convertToExcel(QueueMemberEntity entity)

Description copied from class: BaseRestServiceWithExport

转换为Excel对象 子类必须实现此方法

Specified by:

convertToExcel in class BaseRestServiceWithExport<QueueMemberEntity,QueueMemberRequest,QueueMemberResponse,QueueMemberExcel>

createSpecification

protected org.springframework.data.jpa.domain.Specification<QueueMemberEntity> createSpecification(QueueMemberRequest request)

Description copied from class: BaseRestService

创建Specification对象，子类必须实现 用于queryByOrg的通用实现

Specified by:

createSpecification in class BaseRestService<QueueMemberEntity,QueueMemberRequest,QueueMemberResponse>

executePageQuery

protected org.springframework.data.domain.Page<QueueMemberEntity> executePageQuery(org.springframework.data.jpa.domain.Specification<QueueMemberEntity> spec,
 org.springframework.data.domain.Pageable pageable)

Description copied from class: BaseRestService

执行分页查询，子类必须实现 用于queryByOrg的通用实现

Specified by:

executePageQuery in class BaseRestService<QueueMemberEntity,QueueMemberRequest,QueueMemberResponse>

nextQueueNumber

public int nextQueueNumber(QueueEntity queue,
 QueueTypeEnum queueType)

findEarliestAgentQueueMember

public Optional<QueueMemberEntity> findEarliestAgentQueueMember(String agentQueueUid)

findEarliestAgentQueueMemberForUpdate

public Optional<QueueMemberEntity> findEarliestAgentQueueMemberForUpdate(String agentQueueUid)

findEarliestWorkgroupQueueMember

public Optional<QueueMemberEntity> findEarliestWorkgroupQueueMember(String workgroupQueueUid)

findQueuingMembersByWorkgroupQueueUid

public List<QueueMemberEntity> findQueuingMembersByWorkgroupQueueUid(String workgroupQueueUid)

findEarliestRobotQueueMember

public Optional<QueueMemberEntity> findEarliestRobotQueueMember(String robotQueueUid)

findAgentQueueMembers

public org.springframework.data.domain.Page<QueueMemberResponse> findAgentQueueMembers(String agentQueueUid,
 org.springframework.data.domain.Pageable pageable)

countQueuingByAgentQueueUid

public int countQueuingByAgentQueueUid(String agentQueueUid)

统计客服队列中处于排队状态的会话数

Parameters:

agentQueueUid - 客服队列UID

Returns:

排队中的会话数

countUnassignedQueuingByWorkgroupQueueUids

public int countUnassignedQueuingByWorkgroupQueueUids(List<String> workgroupQueueUids)

统计工作组队列中未分配客服且处于排队状态的会话数

Parameters:

workgroupQueueUids - 工作组队列UID列表

Returns:

未分配客服的排队会话数

createAgentQueueThread

public ThreadEntity createAgentQueueThread(AgentEntity agent)

客服排队会话：org/queue/{agent_uid}