admin
2021-01-15 5405154d6979f1b50ce2d881bb164b1acca80b6d
facade-lucky/src/main/java/com/ks/lucky/remote/service/LuckyActivityService.java
@@ -1,8 +1,11 @@
package com.ks.lucky.remote.service;
import com.ks.lucky.exception.LuckyActivityException;
import com.ks.lib.common.exception.ParamsException;
import com.ks.lucky.exception.*;
import com.ks.lucky.pojo.DO.LuckyActivity;
import javax.validation.Valid;
import java.util.Date;
import java.util.List;
/**
@@ -10,28 +13,57 @@
 */
public interface LuckyActivityService {
    public Long addActivity(LuckyActivity activity) throws ParamsException, LuckyActivityException, LuckyActivitySponsorInfoException, LuckyActivityAwardException, LuckyActivityOpenInfoException, LuckySponsorAdException, LuckyActivityAwardMaterialException;
    /**
     * 获取有效的活动列表
     *
     * @param appKey
     * @param appId
     * @param sponsorId
     * @param key
     * @param page
     * @param pageSize
     * @return
     */
    public List<LuckyActivity> getActivityList(String appKey, Long sponsorId, List<Integer> stateList, String key, int page, int pageSize);
    public List<LuckyActivity> getActivityList(Long appId, Long sponsorId, List<Integer> stateList, String key, int page, int pageSize);
    /**
     * 获取有效的活动列表
     *
     * @param appId
     * @param sponsorId
     * @param stateList
     * @param excludeActivityIds 排除某些活动ID
     * @param key
     * @param page
     * @param pageSize
     * @return
     */
    public List<LuckyActivity> getActivityList(Long appId, Long sponsorId, List<Integer> stateList, List<Long> excludeActivityIds, String key, int page, int pageSize);
    /**
     * 有效的活动计数
     *
     * @param appId
     * @param sponsorId
     * @param key
     * @return
     */
    public long countActivity(Long appId, Long sponsorId, List<Integer> stateList, String key);
    /**
     * 有效的活动计数
     *
     * @param appKey
     * @param appId
     * @param sponsorId
     * @param stateList
     * @param key
     * @param excludeActivityIds 排除某些活动ID
     * @return
     */
    public long countActivity(String appKey, Long sponsorId, List<Integer> stateList, String key);
    public long countActivity(Long appId, Long sponsorId, List<Integer> stateList, String key, List<Long> excludeActivityIds);
    /**
@@ -41,7 +73,7 @@
     * @return
     * @throws LuckyActivityException
     */
    public Long createActivity(LuckyActivity activity) throws LuckyActivityException;
    public Long createActivity(@Valid LuckyActivity activity) throws ParamsException, LuckyActivityException;
    /**
@@ -73,6 +105,17 @@
    /**
     * 发布活动
     *
     * @param activityId
     * @param startTime
     * @param finishTime
     * @throws LuckyActivityException
     */
    public void publishActivity(Long activityId, Date startTime, Date finishTime) throws LuckyActivityException;
    /**
     * 开始活动
     *
     * @param activityId
@@ -81,7 +124,7 @@
     */
    public void startActivity(Long activityId, String remarks) throws LuckyActivityException;
    /**
     * 强制结束活动(活动已经开始之后,可强制结束)
     *
@@ -103,6 +146,24 @@
    /**
     * 取消审核
     *
     * @param activityId
     * @throws LuckyActivityException
     */
    public void cancelVerify(Long activityId) throws LuckyActivityException;
    /**
     * 活动简版详情
     *
     * @param id
     * @return
     */
    public LuckyActivity getActivity(Long id);
    /**
     * 获取活动详情
     *
     * @param id
@@ -112,6 +173,15 @@
    /**
     * 获取活动详情
     *
     * @param ids
     * @return
     */
    public List<LuckyActivity> getActivityDetail(List<Long> ids);
    /**
     * 修改活动
     *
     * @param activity
@@ -120,4 +190,19 @@
    public void updateActivity(LuckyActivity activity) throws LuckyActivityException;
    /**
     * 获取推荐活动列表
     *
     * @param appId
     * @param uid
     * @param page
     * @param pageSize
     * @return
     */
    public List<LuckyActivity> getRecommendActivity(Long appId, String uid, int page, int pageSize);
    public Long getRecommendActivityCount(Long appId, String uid);
}