package cn.lili.modules.promotion.service;
|
|
import cn.lili.common.enums.PromotionTypeEnum;
|
import cn.lili.common.vo.PageVO;
|
import cn.lili.modules.promotion.entity.dos.BasePromotions;
|
import cn.lili.modules.promotion.entity.dto.search.BasePromotionsSearchParams;
|
import com.baomidou.mybatisplus.core.metadata.IPage;
|
import com.baomidou.mybatisplus.extension.service.IService;
|
|
import java.util.List;
|
|
/**
|
* 抽象通用促销服务
|
* 如需拓展原促销实体字段，新拓展类继承自促销实体即可
|
*
|
* @param <T> 促销类型，继承自促销基础类
|
* @author paulG
|
* @since 2021/11/18
|
**/
|
public interface AbstractPromotionsService<T extends BasePromotions> extends IService<T> {
|
|
/**
|
* 通用促销保存
|
* 调用顺序:
|
* 1. initPromotion 初始化促销信息
|
* 2. checkPromotions 检查促销参数
|
* 3. save 保存促销信息
|
* 4. updatePromotionGoods 更新促销商品信息
|
* 5。 updateEsGoodsIndex 更新商品索引促销信息
|
*
|
* @param promotions 促销信息
|
* @return 是否保存成功
|
*/
|
boolean savePromotions(T promotions);
|
|
/**
|
* 通用促销更新
|
* 调用顺序:
|
* 1. checkStatus 检查促销状态
|
* 2. checkPromotions 检查促销参数
|
* 3. saveOrUpdate 保存促销信息
|
* 4. updatePromotionGoods 更新促销商品信息
|
* 5. updateEsGoodsIndex 更新商品索引促销信息
|
*
|
* @param promotions 促销信息
|
* @return 是否更新成功
|
*/
|
boolean updatePromotions(T promotions);
|
|
/**
|
* 更新促销状态
|
* 如果要更新促销状态为关闭，startTime和endTime置为空即可
|
*
|
* @param ids 促销id集合
|
* @param startTime 开始时间
|
* @param endTime 结束时间
|
* @return 是否更新成功
|
*/
|
boolean updateStatus(List<String> ids, Long startTime, Long endTime);
|
|
/**
|
* 移除促销活动
|
*
|
* @param ids 促销活动id集合
|
* @return 是否移除成功
|
*/
|
boolean removePromotions(List<String> ids);
|
|
/**
|
* 分页查询促销信息
|
*
|
* @param searchParams 查询参数，继承自继承促销查询参数
|
* @param page 分页参数
|
* @param <S> 继承自基础促销查询参数的促销查询参数
|
* @return 分页促销信息
|
*/
|
<S extends BasePromotionsSearchParams> IPage<T> pageFindAll(S searchParams, PageVO page);
|
|
/**
|
* 列表查询促销信息
|
*
|
* @param searchParams 查询参数，继承自继承促销查询参数
|
* @param <S> 继承自基础促销查询参数的促销查询参数
|
* @return 列表促销信息
|
*/
|
<S extends BasePromotionsSearchParams> List<T> listFindAll(S searchParams);
|
|
/**
|
* 初始化促销字段
|
*
|
* @param promotions 促销实体
|
*/
|
void initPromotion(T promotions);
|
|
/**
|
* 检查促销参数
|
*
|
* @param promotions 促销实体
|
*/
|
void checkPromotions(T promotions);
|
|
/**
|
* 检查促销状态
|
*
|
* @param promotions 促销实体
|
*/
|
void checkStatus(T promotions);
|
|
/**
|
* 更新促销商品信息
|
*
|
* @param promotions 促销实体
|
* @return
|
*/
|
boolean updatePromotionsGoods(T promotions);
|
|
/**
|
* 更新促销信息到商品索引
|
*
|
* @param promotions 促销实体
|
*/
|
void updateEsGoodsIndex(T promotions);
|
|
/**
|
* 发送更新商品索引消息
|
*
|
* @param promotions 促销实体
|
*/
|
void sendUpdateEsGoodsMsg(T promotions);
|
|
/**
|
* 当前促销类型
|
*
|
* @return 当前促销类型
|
*/
|
PromotionTypeEnum getPromotionType();
|
|
/**
|
* 是否允许同一时间内存在相同的促销
|
*
|
* @return 是否允许同一时间内存在相同的促销
|
*/
|
boolean allowExistSame();
|
|
}
|
