package cn.iocoder.yudao.module.pay.service.app;
|
|
import cn.iocoder.yudao.framework.common.exception.ServiceException;
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
|
import cn.iocoder.yudao.module.pay.controller.admin.app.vo.PayAppCreateReqVO;
|
import cn.iocoder.yudao.module.pay.controller.admin.app.vo.PayAppPageReqVO;
|
import cn.iocoder.yudao.module.pay.controller.admin.app.vo.PayAppUpdateReqVO;
|
import cn.iocoder.yudao.module.pay.dal.dataobject.app.PayAppDO;
|
import jakarta.validation.Valid;
|
|
import java.util.Collection;
|
import java.util.List;
|
import java.util.Map;
|
|
/**
|
* 支付应用 Service 接口
|
*
|
* @author 芋艿
|
*/
|
public interface PayAppService {
|
|
/**
|
* 创建支付应用
|
*
|
* @param createReqVO 创建
|
* @return 编号
|
*/
|
Long createApp(@Valid PayAppCreateReqVO createReqVO);
|
|
/**
|
* 更新支付应用
|
*
|
* @param updateReqVO 更新
|
*/
|
void updateApp(@Valid PayAppUpdateReqVO updateReqVO);
|
|
/**
|
* 修改应用状态
|
*
|
* @param id 应用编号
|
* @param status 状态
|
*/
|
void updateAppStatus(Long id, Integer status);
|
|
/**
|
* 删除支付应用
|
*
|
* @param id 编号
|
*/
|
void deleteApp(Long id);
|
|
/**
|
* 获得支付应用
|
*
|
* @param id 编号
|
* @return 支付应用
|
*/
|
PayAppDO getApp(Long id);
|
|
/**
|
* 获得支付应用列表
|
*
|
* @param ids 编号
|
* @return 支付应用列表
|
*/
|
List<PayAppDO> getAppList(Collection<Long> ids);
|
|
/**
|
* 获得支付应用列表
|
*
|
* @return 支付应用列表
|
*/
|
List<PayAppDO> getAppList();
|
|
/**
|
* 获得支付应用分页
|
*
|
* @param pageReqVO 分页查询
|
* @return 支付应用分页
|
*/
|
PageResult<PayAppDO> getAppPage(PayAppPageReqVO pageReqVO);
|
|
/**
|
* 获得指定编号的商户 Map
|
*
|
* @param ids 应用编号集合
|
* @return 商户 Map
|
*/
|
default Map<Long, PayAppDO> getAppMap(Collection<Long> ids) {
|
List<PayAppDO> list = getAppList(ids);
|
return CollectionUtils.convertMap(list, PayAppDO::getId);
|
}
|
|
/**
|
* 支付应用的合法性
|
* <p>
|
* 如果不合法，抛出 {@link ServiceException} 业务异常
|
*
|
* @param id 应用编号
|
* @return 应用
|
*/
|
PayAppDO validPayApp(Long id);
|
|
/**
|
* 支付应用的合法性
|
* <p>
|
* 如果不合法，抛出 {@link ServiceException} 业务异常
|
*
|
* @param appKey 应用标识
|
* @return 应用
|
*/
|
PayAppDO validPayApp(String appKey);
|
|
}
|
