package cn.iocoder.yudao.module.iot.service.product;
|
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.module.iot.controller.admin.product.vo.product.IotProductPageReqVO;
|
import cn.iocoder.yudao.module.iot.controller.admin.product.vo.product.IotProductSaveReqVO;
|
import cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO;
|
import jakarta.validation.Valid;
|
|
import javax.annotation.Nullable;
|
import java.time.LocalDateTime;
|
import java.util.Collection;
|
import java.util.List;
|
import java.util.Map;
|
|
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
|
|
/**
|
* IoT 产品 Service 接口
|
*
|
* @author ahh
|
*/
|
public interface IotProductService {
|
|
/**
|
* 创建产品
|
*
|
* @param createReqVO 创建信息
|
* @return 编号
|
*/
|
Long createProduct(@Valid IotProductSaveReqVO createReqVO);
|
|
/**
|
* 更新产品
|
*
|
* @param updateReqVO 更新信息
|
*/
|
void updateProduct(@Valid IotProductSaveReqVO updateReqVO);
|
|
/**
|
* 删除产品
|
*
|
* @param id 编号
|
*/
|
void deleteProduct(Long id);
|
|
/**
|
* 获得产品
|
*
|
* @param id 编号
|
* @return 产品
|
*/
|
IotProductDO getProduct(Long id);
|
|
/**
|
* 【缓存】获得产品
|
* <p>
|
* 注意：该方法会忽略租户信息，所以调用时，需要确认会不会有跨租户访问的风险！！！
|
*
|
* @param id 编号
|
* @return 产品
|
*/
|
IotProductDO getProductFromCache(Long id);
|
|
/**
|
* 根据产品 key 获得产品
|
*
|
* @param productKey 产品 key
|
* @return 产品
|
*/
|
IotProductDO getProductByProductKey(String productKey);
|
|
/**
|
* 校验产品存在
|
*
|
* @param id 编号
|
* @return 产品
|
*/
|
IotProductDO validateProductExists(Long id);
|
|
/**
|
* 校验产品存在
|
*
|
* @param productKey 产品 key
|
* @return 产品
|
*/
|
IotProductDO validateProductExists(String productKey);
|
|
/**
|
* 获得产品分页
|
*
|
* @param pageReqVO 分页查询
|
* @return 产品分页
|
*/
|
PageResult<IotProductDO> getProductPage(IotProductPageReqVO pageReqVO);
|
|
/**
|
* 更新产品状态
|
*
|
* @param id 编号
|
* @param status 状态
|
*/
|
void updateProductStatus(Long id, Integer status);
|
|
/**
|
* 获得所有产品
|
*
|
* @return 产品列表
|
*/
|
List<IotProductDO> getProductList();
|
|
/**
|
* 根据设备类型获得产品列表
|
*
|
* @param deviceType 设备类型（可选）
|
* @return 产品列表
|
*/
|
List<IotProductDO> getProductList(@Nullable Integer deviceType);
|
|
/**
|
* 获得产品数量
|
*
|
* @param createTime 创建时间，如果为空，则统计所有产品数量
|
* @return 产品数量
|
*/
|
Long getProductCount(@Nullable LocalDateTime createTime);
|
|
/**
|
* 批量获得产品列表
|
*
|
* @param ids 产品编号集合
|
* @return 产品列表
|
*/
|
List<IotProductDO> getProductList(Collection<Long> ids);
|
|
/**
|
* 批量获得产品 Map
|
*
|
* @param ids 产品编号集合
|
* @return 产品 Map（key: 产品编号, value: 产品）
|
*/
|
default Map<Long, IotProductDO> getProductMap(Collection<Long> ids) {
|
return convertMap(getProductList(ids), IotProductDO::getId);
|
}
|
|
/**
|
* 批量校验产品存在
|
*
|
* @param ids 产品编号集合
|
*/
|
void validateProductsExist(Collection<Long> ids);
|
|
/**
|
* 同步产品的 TDengine 表结构
|
*
|
* 目的：当 MySQL 和 TDengine 不同步时，强制将已发布产品的表结构同步到 TDengine 中
|
*/
|
void syncProductPropertyTable();
|
|
}
|
