Package com.bytedesk.service.agent

Class AgentRestService

java.lang.Object

com.bytedesk.core.base.BaseRestService<AgentEntity,AgentRequest,AgentResponse>

com.bytedesk.service.agent.AgentRestService

@Service
public class AgentRestService
extends BaseRestService<AgentEntity,AgentRequest,AgentResponse>

Field Summary

Fields

Modifier and Type	Field	Description
private final AgentRepository	agentRepository
private final AgentSettingsRestService	agentSettingsRestService
private final AuthService	authService
private final BytedeskEventPublisher	bytedeskEventPublisher
private final MemberRestService	memberRestService
private final org.modelmapper.ModelMapper	modelMapper
private final ThreadRestService	threadRestService
private final UidUtils	uidUtils
private final UserService	userService

Constructor Summary

Constructors

Constructor	Description
AgentRestService()

Method Summary

Modifier and Type	Method	Description
ThreadResponseSimple	acceptByAgent(ThreadRequest threadRequest)
AgentExcel	convertToExcel(AgentEntity entity)
AgentResponse	convertToResponse(AgentEntity entity)
AgentResponse	create(AgentRequest request)
void	createFromMember(String mobile, String orgUid)
void	createFromMemberByEmail(String email, String orgUid)
protected org.springframework.data.jpa.domain.Specification<AgentEntity>	createSpecification(AgentRequest request)	创建Specification对象，子类必须实现 用于queryByOrg的通用实现
void	delete(AgentRequest request)
void	deleteByUid(String uid)
protected AgentEntity	doSave(AgentEntity entity)	子类实现具体的保存逻辑
protected org.springframework.data.domain.Page<AgentEntity>	executePageQuery(org.springframework.data.jpa.domain.Specification<AgentEntity> spec, org.springframework.data.domain.Pageable pageable)	执行分页查询，子类必须实现 用于queryByOrg的通用实现
Boolean	existsByUid(String uid)
Boolean	existsByUserUidAndOrgUid(String userUid, String orgUid)
List<AgentEntity>	findAllConnected()
Optional<AgentEntity>	findByEmailAndOrgUid(String email, String orgUid)
Optional<AgentEntity>	findByMobileAndOrgUid(String mobile, String orgUid)
Optional<AgentEntity>	findByUid(String uid)
Optional<AgentEntity>	findByUidFromDatabase(String uid)	强制从数据库加载（绕过 Spring Cache）。
Optional<AgentEntity>	findByUserUid(String userUid)
Optional<AgentEntity>	findByUserUidAndOrgUid(String userUid, String orgUid)
AgentEntity	handleOptimisticLockingFailureException(org.springframework.orm.ObjectOptimisticLockingFailureException e, AgentEntity agent)
AgentResponse	query(AgentRequest request)
AgentResponse	queryByUserUid(AgentRequest request)	根据指定 userUid 查询单个客服信息 - 若传入 orgUid：按 userUid + orgUid 精确查询 - 未传 orgUid：仅按 userUid 查询
AgentResponse	update(AgentRequest request)
AgentResponse	updateAutoReply(AgentRequest request)
AgentResponse	updateAvatar(AgentRequest request)
AgentResponse	updateStatus(AgentRequest request)

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

agentRepository

private final AgentRepository agentRepository

uidUtils

private final UidUtils uidUtils

memberRestService

private final MemberRestService memberRestService

userService

private final UserService userService

authService

private final AuthService authService

bytedeskEventPublisher

private final BytedeskEventPublisher bytedeskEventPublisher

threadRestService

private final ThreadRestService threadRestService

agentSettingsRestService

private final AgentSettingsRestService agentSettingsRestService

modelMapper

private final org.modelmapper.ModelMapper modelMapper

Constructor Details

AgentRestService

public AgentRestService()

Method Details

createSpecification

protected org.springframework.data.jpa.domain.Specification<AgentEntity> createSpecification(AgentRequest request)

Description copied from class: BaseRestService

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

Specified by:

createSpecification in class BaseRestService<AgentEntity,AgentRequest,AgentResponse>

executePageQuery

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

Description copied from class: BaseRestService

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

Specified by:

executePageQuery in class BaseRestService<AgentEntity,AgentRequest,AgentResponse>

query

public AgentResponse query(AgentRequest request)

queryByUserUid

public AgentResponse queryByUserUid(AgentRequest request)

根据指定 userUid 查询单个客服信息 - 若传入 orgUid：按 userUid + orgUid 精确查询 - 未传 orgUid：仅按 userUid 查询

create

@Transactional
public AgentResponse create(AgentRequest request)

Specified by:

create in class BaseRestService<AgentEntity,AgentRequest,AgentResponse>

createFromMember

public void createFromMember(String mobile,
 String orgUid)

createFromMemberByEmail

public void createFromMemberByEmail(String email,
 String orgUid)

update

@Transactional
public AgentResponse update(AgentRequest request)

Specified by:

update in class BaseRestService<AgentEntity,AgentRequest,AgentResponse>

updateAvatar

@Transactional
public AgentResponse updateAvatar(AgentRequest request)

updateStatus

@Transactional
public AgentResponse updateStatus(AgentRequest request)

acceptByAgent

@Transactional
public ThreadResponseSimple acceptByAgent(ThreadRequest threadRequest)

updateAutoReply

@Transactional
public AgentResponse updateAutoReply(AgentRequest request)

doSave

@Cacheable(value="agent",
           key="#entity.uid",
           unless="#result == null")
protected AgentEntity doSave(AgentEntity entity)

Description copied from class: BaseRestService

子类实现具体的保存逻辑

Specified by:

doSave in class BaseRestService<AgentEntity,AgentRequest,AgentResponse>

deleteByUid

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

Specified by:

deleteByUid in class BaseRestService<AgentEntity,AgentRequest,AgentResponse>

delete

public void delete(AgentRequest request)

Specified by:

delete in class BaseRestService<AgentEntity,AgentRequest,AgentResponse>

convertToResponse

public AgentResponse convertToResponse(AgentEntity entity)

Specified by:

convertToResponse in class BaseRestService<AgentEntity,AgentRequest,AgentResponse>

convertToExcel

public AgentExcel convertToExcel(AgentEntity entity)

handleOptimisticLockingFailureException

public AgentEntity handleOptimisticLockingFailureException(org.springframework.orm.ObjectOptimisticLockingFailureException e,
 AgentEntity agent)

Specified by:

handleOptimisticLockingFailureException in class BaseRestService<AgentEntity,AgentRequest,AgentResponse>

findByUid

public Optional<AgentEntity> findByUid(String uid)

Specified by:

findByUid in class BaseRestService<AgentEntity,AgentRequest,AgentResponse>

findByUidFromDatabase

public Optional<AgentEntity> findByUidFromDatabase(String uid)

强制从数据库加载（绕过 Spring Cache）。 说明： - findByUid(String) 带有 @Cacheable，可能直接命中缓存 - 该方法直接走 Repository 查询，用于在缓存对象缺失关联(member/user)时兜底

findByUserUid

public Optional<AgentEntity> findByUserUid(String userUid)

findByMobileAndOrgUid

public Optional<AgentEntity> findByMobileAndOrgUid(String mobile,
 String orgUid)

findByEmailAndOrgUid

public Optional<AgentEntity> findByEmailAndOrgUid(String email,
 String orgUid)

findByUserUidAndOrgUid

public Optional<AgentEntity> findByUserUidAndOrgUid(String userUid,
 String orgUid)

existsByUserUidAndOrgUid

public Boolean existsByUserUidAndOrgUid(String userUid,
 String orgUid)

existsByUid

public Boolean existsByUid(String uid)

findAllConnected

public List<AgentEntity> findAllConnected()