65 lines
1.6 KiB
C++
65 lines
1.6 KiB
C++
|
#ifndef MALL_PRODUCT_HPP
|
|||
|
|
#define MALL_PRODUCT_HPP
|
|||
|
|
|
|||
|
|
#include <string>
|
|||
|
|
#include <cstdint>
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 商品类，表示商城中的一件商品。
|
|||
|
|
*/
|
|||
|
|
class Product {
|
|||
|
|
public:
|
|||
|
|
/**
|
|||
|
|
* @brief 默认构造函数，构造一个空商品。
|
|||
|
|
*/
|
|||
|
|
Product() = default;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 构造商品。
|
|||
|
|
* @param id 商品唯一编号
|
|||
|
|
* @param name 商品名称
|
|||
|
|
* @param price 商品单价（元）
|
|||
|
|
* @param stock 库存数量
|
|||
|
|
*/
|
|||
|
|
Product(uint64_t id, std::string name, double price, int stock);
|
|||
|
|
|
|||
|
|
/** @brief 获取商品编号 */
|
|||
|
|
uint64_t getId() const noexcept { return id_; }
|
|||
|
|
|
|||
|
|
/** @brief 获取商品名称 */
|
|||
|
|
const std::string& getName() const noexcept { return name_; }
|
|||
|
|
|
|||
|
|
/** @brief 获取商品单价 */
|
|||
|
|
double getPrice() const noexcept { return price_; }
|
|||
|
|
|
|||
|
|
/** @brief 获取库存数量 */
|
|||
|
|
int getStock() const noexcept { return stock_; }
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 减少库存。
|
|||
|
|
* @param quantity 减少数量
|
|||
|
|
* @return true 扣减成功，false 库存不足
|
|||
|
|
*/
|
|||
|
|
bool reduceStock(int quantity);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 增加库存。
|
|||
|
|
* @param quantity 增加数量
|
|||
|
|
*/
|
|||
|
|
void addStock(int quantity);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 返回商品简要信息字符串。
|
|||
|
|
* @return 例如 "[#1001] 苹果 ¥5.50 (库存:20)"
|
|||
|
|
*/
|
|||
|
|
std::string toString() const;
|
|||
|
|
|
|||
|
|
private:
|
|||
|
|
uint64_t id_ = 0; ///< 商品编号
|
|||
|
|
std::string name_; ///< 商品名称
|
|||
|
|
double price_ = 0.0; ///< 单价
|
|||
|
|
int stock_ = 0; ///< 库存数量
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
#endif // MALL_PRODUCT_HPP
|