diff --git a/yami-shop-service/src/main/java/com/yami/shop/dao/BrandMapper.java b/yami-shop-service/src/main/java/com/yami/shop/dao/BrandMapper.java index 8f715bd..9406b74 100644 --- a/yami-shop-service/src/main/java/com/yami/shop/dao/BrandMapper.java +++ b/yami-shop-service/src/main/java/com/yami/shop/dao/BrandMapper.java @@ -17,21 +17,29 @@ import org.apache.ibatis.annotations.Param; import java.util.List; /** + * BrandMapper接口,继承自BaseMapper,用于对品牌相关的数据持久化操作进行定义。 + * 该接口提供了针对品牌数据在数据库层面的查询等方法抽象。 * @author lanhai */ public interface BrandMapper extends BaseMapper { - /** - * 根据品牌名称获取品牌 - * @param brandName 品牌名称 - * @return 品牌信息 - */ - Brand getByBrandName(String brandName); + /** + * 根据品牌名称获取品牌信息的方法。 + * 此方法会在数据库中查找与给定品牌名称匹配的品牌记录,并返回对应的品牌信息。 + * 如果数据库中不存在该名称的品牌,将返回null(取决于具体数据库查询的结果情况)。 + * + * @param brandName 要查询的品牌名称,作为查询条件传入数据库查询语句中。 + * @return 返回查找到的Brand类型的品牌信息对象,如果未找到则返回null。 + */ + Brand getByBrandName(String brandName); - /** - * 根据分类id获取品牌列表 - * @param categoryId 分类id - * @return 品牌列表 - */ - List listByCategoryId(@Param("categoryId")Long categoryId); + /** + * 根据分类id获取品牌列表的方法。 + * 它会依据传入的分类id,在数据库中查询出属于该分类下的所有品牌信息,并以列表形式返回。 + * 如果该分类下没有对应的品牌,将返回一个空的列表(List类型,长度为0)。 + * + * @param categoryId 用于指定分类的唯一标识符,通过该参数在数据库中筛选出对应分类下的品牌。 + * @return 返回包含品牌信息的List列表,可能为空列表,代表该分类下无品牌。 + */ + List listByCategoryId(@Param("categoryId")Long categoryId); } \ No newline at end of file