Qt Q_CLASSINFO 宏详解

Q_CLASSINFO 是 Qt 元对象系统中的一个重要宏，用于为类附加额外的元数据信息。以下是详细解析：

基本语法

cpp 复制代码

Q_CLASSINFO("Key", "Value")

核心功能

1. 存储键值对元数据

将字符串键值对附加到类的元对象中
这些信息在运行时可通过 QMetaObject 访问

2. 声明位置

cpp 复制代码

class MyClass : public QObject
{
    Q_OBJECT  // 必须使用 Q_OBJECT
    Q_CLASSINFO("Author", "John Doe")
    Q_CLASSINFO("Version", "1.0.0")
    Q_CLASSINFO("Description", "Custom widget")
    
public:
    // ...
};

访问元数据

1. 运行时访问

cpp 复制代码

const QMetaObject* meta = myObject->metaObject();

// 获取所有类信息
int count = meta->classInfoCount();
for (int i = 0; i < count; ++i) {
    QMetaClassInfo info = meta->classInfo(i);
    qDebug() << info.name() << "=" << info.value();
}

2. 通过索引访问特定信息

cpp 复制代码

QMetaClassInfo info = meta->classInfo(index);
QString key = info.name();
QString value = info.value();

常用场景

1. 插件系统

cpp 复制代码

Q_CLASSINFO("PluginName", "ImageProcessor")
Q_CLASSINFO("PluginVersion", "2.1")
Q_CLASSINFO("PluginInterface", "com.company.ProcessorInterface/1.0")

2. 组件信息

cpp 复制代码

class CustomWidget : public QWidget
{
    Q_OBJECT
    Q_CLASSINFO("WidgetCategory", "Input")
    Q_CLASSINFO("MinSize", "100x50")
    Q_CLASSINFO("DefaultPalette", "Light")
};

3. 序列化配置

cpp 复制代码

Q_CLASSINFO("Serializable", "true")
Q_CLASSINFO("SerializeFormat", "JSON")
Q_CLASSINFO("VersionField", "appVersion")

4. RPC/网络服务

cpp 复制代码

class Service : public QObject
{
    Q_OBJECT
    Q_CLASSINFO("D-Bus Interface", "com.example.Service")
    Q_CLASSINFO("D-Bus Introspection", "...")
};

高级用法

1. 与属性系统结合

cpp 复制代码

class Config : public QObject
{
    Q_OBJECT
    Q_CLASSINFO("TableName", "settings")
    Q_PROPERTY(QString username READ username WRITE setUsername)
    Q_CLASSINFO("FieldType", "VARCHAR(255)")
    // ...
};

2. 动态信息查询

cpp 复制代码

// 检查特定元信息
bool hasFeature(const QObject* obj, const QString& feature)
{
    const QMetaObject* meta = obj->metaObject();
    int count = meta->classInfoCount();
    for (int i = 0; i < count; ++i) {
        QMetaClassInfo info = meta->classInfo(i);
        if (info.name() == feature) {
            return info.value() == "true";
        }
    }
    return false;
}

注意事项

Q_OBJECT 必需
- 必须与 Q_OBJECT 宏一起使用
- 需要在有信号/槽的类中使用
编译时处理
- 信息在编译时确定，运行时不能修改
- 会被 Qt 的 moc 工具处理
字符串限制
- 键值都必须是字符串字面量
- 不支持运行时动态字符串
性能考虑
- 元数据存储在静态内存中
- 访问开销很小

实际示例

完整的类定义

cpp 复制代码

class DocumentProcessor : public QObject
{
    Q_OBJECT
    Q_CLASSINFO("ComponentID", "DocProcessor_v1")
    Q_CLASSINFO("SupportedFormats", "PDF,DOCX,TXT")
    Q_CLASSINFO("MaxFileSize", "10485760")  // 10MB
    Q_CLASSINFO("ThreadSafe", "true")
    
public:
    enum ProcessingMode { Fast, Accurate, Draft };
    Q_ENUM(ProcessingMode)
    
    Q_INVOKABLE QString processDocument(const QString& path);
    
signals:
    void progressChanged(int percent);
};

使用示例

cpp 复制代码

// 运行时读取元数据
void printClassInfo(QObject* obj)
{
    const QMetaObject* meta = obj->metaObject();
    
    qDebug() << "Class:" << meta->className();
    qDebug() << "Class Info:";
    
    for (int i = meta->classInfoOffset(); i < meta->classInfoCount(); ++i) {
        QMetaClassInfo info = meta->classInfo(i);
        qDebug() << "  " << info.name() << ":" << info.value();
    }
}

与其他宏的关系

Q_OBJECT: 必需的基础宏
Q_PROPERTY: 用于声明属性
Q_ENUM/Q_ENUM_NS: 用于枚举元数据
Q_INVOKABLE: 标记可调用方法

总结

Q_CLASSINFO 提供了一种在编译时为类附加元数据的机制，适用于：

插件系统标识
组件配置信息
序列化/反序列化配置
接口版本控制
框架扩展信息

这些元数据可通过 Qt 的反射系统在运行时访问，为构建灵活的、可扩展的应用程序架构提供了有力支持。