using Data;
using Managers;
using System;
using System.Collections.Generic;
using UnityEngine;
namespace Item
{
///
/// 表示游戏中的一个物品资源,包含了物品的各项基本属性和数据。
/// 这是一个只读的数据结构,用于存储物品的定义信息。
///
public class ItemResource
{
///
/// 构造函数:通过 ItemDef 对象初始化 ItemResource。
///
/// 物品的定义对象。
/// 如果传入的 ItemDef 为 null,则抛出此异常。
public ItemResource(ItemDef def)
{
// 参数校验:在构造函数中进行参数非空检查至关重要,避免空引用异常。
if (def == null) throw new ArgumentNullException(nameof(def), "创建 ItemResource 时,ItemDef 不能为 null。");
// 从 ItemDef 对象中直接赋值 ItemResource 的所有属性。
// 这将创建 ItemResource 的逻辑完全封装在类内部,外部调用方无需关心具体属性的提取过程。
DefName = def.defName;
Name = def.label;
Description = def.description;
Rarity = def.rarity;
MaxStack = def.maxStack;
IsEquippable = def.ssEquippable;
FPS = def.FPS;
var sprites = new List();
var packID = def.packID;
// 逻辑修改:添加对 def.textures 的非空检查,避免 NullReferenceException
if (def.textures != null)
{
foreach (var texture in def.textures)
{
var spr = PackagesImageManager.Instance.GetSprite(packID, texture);
if (spr)
sprites.Add(spr);
else
// 统一日志信息,说明哪个纹理加载失败
Debug.LogWarning(
$"ItemResource: Failed to load sprite for texture '{texture}' for item '{def.defName}'.");
}
}
else
{
// 仅当 textures 为 null 时警告,因为它可能是预期的数据状态(无图标)
Debug.LogWarning(
$"ItemResource: ItemDef '{def.defName}' has a null textures array. No icons will be loaded.");
}
// 逻辑修改:Icon 属性现在是 IReadOnlyList 类型,确保外部只读访问
Icon = sprites.AsReadOnly(); // 使用 AsReadOnly() 获得一个只读包装器
}
///
/// 物品的定义名称,通常作为其唯一标识符。
///
public string DefName { get; protected set; }
///
/// 物品的显示名称(例如,在UI中显示的名称)。
///
public string Name { get; protected set; }
///
/// 物品的描述文本。
///
public string Description { get; protected set; }
///
/// 物品的图标精灵集合。提供只读访问以保持数据结构不变性。
///
// 逻辑修改:Icon 属性更改为 IReadOnlyList
public IReadOnlyList Icon { get; protected set; }
///
/// 物品的稀有度。
///
public ItemRarity Rarity { get; protected set; }
///
/// 物品的最大堆叠数量。
///
public int MaxStack { get; protected set; }
///
/// 指示物品是否可以被装备。
///
public bool IsEquippable { get; protected set; }
///
/// 物品的帧率(如果适用)。
///
public float FPS { get; protected set; }
public static ItemResource GetDefault()
{
ItemDef defaultDef = new()
{
defName = "default",
label = "错误物品",
description = "你看到这个物品表示加载出错了",
rarity = ItemRarity.Uncommon,
maxStack = 1,
ssEquippable = false
};
return new ItemResource(defaultDef);
}
}
}