商品标签管理控制器文档

接口信息

• 控制器类: MallItemTagController
• 包路径: com.qisheng.mall.web
• 功能描述: 负责处理商城商品标签的增删改查操作

类图

接口列表

1. 获取商品标签列表

• 请求方式: GET
• URL: /{merchantId}/mall_item_tag
• 功能: 获取商户的商品标签列表
• 参数:
  • merchantId: 商户ID (路径参数)
• 返回: ObjectResponse
• 示例:

GET /82/mall_item_tag

2. 添加商品标签

• 请求方式: POST
• URL: /{merchantId}/mall_item_tag
• 功能: 创建新的商品标签
• 参数:
  • merchantId: 商户ID (路径参数)
  • req: 商品标签请求对象 (请求体)
• 返回: ObjectResponse
• 示例:

POST /82/mall_item_tag
{
  "code": "NEW_ARRIVAL",
  "name": "新品",
  "typeCode": "PRODUCT_FEATURE",
  "typeName": "商品特性"
}

3. 编辑商品标签

• 请求方式: PATCH
• URL: /{merchantId}/mall_item_tag/{id}
• 功能: 更新商品标签信息
• 参数:
  • merchantId: 商户ID (路径参数)
  • id: 标签ID (路径参数)
  • req: 商品标签请求对象 (请求体)
• 返回: BaseResponse
• 示例:

PATCH /82/mall_item_tag/123
{
  "name": "新品上市",
  "typeName": "商品特性标签"
}

4. 删除商品标签

• 请求方式: DELETE
• URL: /{merchantId}/mall_item_tag/{id}
• 功能: 删除商品标签
• 参数:
  • merchantId: 商户ID (路径参数)
  • id: 标签ID (路径参数)
• 返回: BaseResponse
• 示例:

DELETE /82/mall_item_tag/123

调用流程

1. 获取商品标签列表流程

2. 添加商品标签流程

SQL查询

由于没有找到特定的MallItemTag.xml文件，以下是基于MyBatis-Plus框架的可能的SQL操作：

查询商品标签列表SQL

-- 查询商户的所有商品标签
SELECT 
  id, app_id, platform_id, merchant_id, code, name, type_code, type_name,
  create_ts, create_user, last_update_ts, last_update_user
FROM META_MALL_ITEM_TAG
WHERE merchant_id = #{merchantId}
ORDER BY create_ts DESC

添加商品标签SQL

-- 插入新的商品标签
INSERT INTO META_MALL_ITEM_TAG (
  app_id, platform_id, merchant_id, code, name, type_code, type_name,
  create_ts, create_user, last_update_ts, last_update_user
) VALUES (
  #{appId}, #{platformId}, #{merchantId}, #{code}, #{name}, #{typeCode}, #{typeName},
  NOW(), #{createUser}, NOW(), #{lastUpdateUser}
)

更新商品标签SQL

-- 更新商品标签信息
UPDATE META_MALL_ITEM_TAG
SET 
  name = #{name},
  type_code = #{typeCode},
  type_name = #{typeName},
  last_update_ts = NOW(),
  last_update_user = #{lastUpdateUser}
WHERE id = #{id} AND merchant_id = #{merchantId}

删除商品标签SQL

-- 删除商品标签
DELETE FROM META_MALL_ITEM_TAG
WHERE id = #{id} AND merchant_id = #{merchantId}

主要功能说明

商品标签用途

• 商品标签用于对商品进行分类和标记，方便用户查找和筛选商品
• 标签可以按照不同的类型进行分组，如商品特性、促销类型等

商品标签类型

• 商品标签类型通过 typeCode 和 typeName 字段进行区分
• 常见的标签类型包括：商品特性、促销标签、季节标签等

注意事项

1. 数据表说明

• META_MALL_ITEM_TAG: 商品标签表，存储商品标签的基本信息

2. 权限控制

• 商户ID: 通过商户ID进行权限控制，只能操作自己商户的商品标签

3. 业务逻辑

• 标签唯一性: 同一商户下标签code应该保持唯一
• 标签关联: 标签与商品之间的关联关系需要在其他表中维护

4. 元数据刷新

• 使用 @MetaTsFresh 注解标记需要刷新元数据的方法，模块为 MetaType.Mall.META_MALL_ITEM_TAG
• 在添加、编辑和删除标签时会触发元数据刷新