feat: add isReadOnly method to DConfig

1. Added isReadOnly virtual method to DConfigBackend base class with
default implementation returning false
2. Implemented isReadOnly in FileBackend by checking permissions from
config file metadata
3. Implemented isReadOnly in DBusBackend by calling remote permissions
method via D-Bus
4. Added public isReadOnly method to DConfig class that delegates to
backend implementation
5. Updated documentation with Chinese and English API documentation for
the new method
6. Added test configuration items with readwrite and readonly
permissions in test data
7. Added unit tests to verify isReadOnly functionality for both
permission types

Log: Added DConfig.isReadOnly() method to check if configuration items
are read-only

Influence:
1. Test isReadOnly returns true for configuration items with readonly
permissions
2. Test isReadOnly returns false for configuration items with readwrite
permissions
3. Verify isReadOnly works correctly with both FileBackend and
DBusBackend implementations
4. Test isReadOnly returns false when DConfig is in invalid state
5. Verify documentation is properly updated in both English and Chinese
versions

feat: DConfig新增isReadOnly接口

1. 在DConfigBackend基类中添加isReadOnly虚方法，默认实现返回false
2. 在FileBackend中实现isReadOnly，通过检查配置文件元数据中的权限设置
3. 在DBusBackend中实现isReadOnly，通过D-Bus调用远程权限方法
4. 在DConfig类中添加公共isReadOnly方法，委托给后端实现
5. 更新文档，添加中英文API文档说明新方法
6. 在测试数据中添加具有读写和只读权限的测试配置项
7. 添加单元测试验证isReadOnly功能对两种权限类型的处理

Log: 新增DConfig.isReadOnly()方法用于检查配置项是否为只读

Influence:
1. 测试isReadOnly对只读权限配置项返回true
2. 测试isReadOnly对读写权限配置项返回false
3. 验证isReadOnly在FileBackend和DBusBackend实现中都能正常工作
4. 测试当DConfig处于无效状态时isReadOnly返回false
5. 验证中英文文档都已正确更新

Author: 18202781743

docs/global/dconfig.zh_CN.dox

@@ -63,6 +63,14 @@
 @sa DBusBackend::reset()
 @sa QSettingBackend::reset()
 
+@fn bool Dtk::Core::DConfigBackend::isReadOnly(const QString &key)
+@brief 检测指定配置项是否为只读
+@param[in] key 配置项名称
+@return 如果配置项为只读返回true，否则返回false
+@sa DConfig::isReadOnly()
+@sa FileBackend::isReadOnly()
+@sa DBusBackend::isReadOnly()
+
 @fn QString Dtk::Core::DConfigBackend::name() const = 0
 @brief 后端配置的唯一标识
 @sa FileBackend::name()
@@ -384,6 +392,11 @@ sudo make install
 @brief 设置其配置项对应的默认值,此值为经过override机制覆盖后的值,不一定为此配置文件中meta中定义的值
 @param[in] key 配置项名称
 
+@fn bool Dtk::Core::DConfig::isReadOnly(const QString &key)
+@brief 检测指定配置项是否为只读
+@param[in] key 配置项名称
+@return 如果配置项为只读返回true，否则返回false
+
 @fn QString Dtk::Core::DConfig::name()
 @brief 返回配置文件名称
 

include/global/dconfig.h

@@ -23,6 +23,7 @@ class DConfigBackend {
     virtual void reset(const QString &key) { setValue(key, QVariant());}
     virtual QString name() const {return QString("");}
     virtual bool isDefaultValue(const QString &/*key*/) const { return true; }
+    virtual bool isReadOnly(const QString &/*key*/) const { return false; }
 };
 
 class DConfigPrivate;
@@ -61,6 +62,7 @@ class LIBDTKCORESHARED_EXPORT DConfig : public QObject, public DObject
     QVariant value(const QString &key, const QVariant &fallback = QVariant()) const;
     void setValue(const QString &key, const QVariant &value);
     void reset(const QString &key);
+    bool isReadOnly(const QString &key) const;
 
     QString name() const;
     QString subpath() const;

src/dconfig.cpp

@@ -82,6 +82,13 @@ static QString NoAppId;
     @sa DConfig::reset()
  */
 
+ /*!
+ @~english
+     @fn bool DConfigBackend::isReadOnly(const QString &key) const = 0
+
+     @sa DConfig::isReadOnly()
+ */
+
 /*!
 @~english
     @fn QString DConfigBackend::name() const = 0
@@ -230,6 +237,12 @@ class Q_DECL_HIDDEN FileBackend : public DConfigBackend
         setValue(key, QVariant());
     }
 
+    virtual bool isReadOnly(const QString &key) const override
+    {
+        const auto vc = configFile->meta()->permissions(key);
+        return vc == DConfigFile::ReadOnly;
+    }
+
     virtual QString name() const override
     {
         return QString("FileBackend");
@@ -425,6 +438,18 @@ class Q_DECL_HIDDEN DBusBackend : public DConfigBackend
                              << ", error message:" << reply.error();
     }
 
+    virtual bool isReadOnly(const QString &key) const override
+    {
+        auto reply = config->permissions(key);
+        reply.waitForFinished();
+        if (reply.isError()) {
+            qWarning() << "Failed to call `permissions`, key:" << key
+                       << ", error message:" << reply.error().message();
+            return false;
+        }
+        return reply.value() == QLatin1String("readonly");
+    }
+
     virtual QString name() const override
     {
         return QString("DBusBackend");
@@ -821,6 +846,21 @@ void DConfig::reset(const QString &key)
     d->backend->reset(key);
 }
 
+/*!
+ * @~english
+ * @brief Check whether the configuration item is read-only
+ * @param key Configuration Item Name
+ * @return Return `true` if the configuration item is read-only, otherwise return `false`
+ */
+bool DConfig::isReadOnly(const QString &key) const
+{
+    D_DC(DConfig);
+    if (d->invalid())
+        return false;
+
+    return d->backend->isReadOnly(key);
+}
+
 /*!
 @~english
  * @brief Return configuration file name

tests/data/dconf-example.meta.json

@@ -105,6 +105,26 @@
       "description": "I am public configure",
       "permissions": "readwrite",
       "visibility": "private"
+    },
+    "readwrite": {
+      "value": true,
+      "serial": 0,
+      "flags": [],
+      "name": "readwrite configure",
+      "name[zh_CN]": "我是可读写配置",
+      "description": "I am a readwrite configure",
+      "permissions": "readwrite",
+      "visibility": "private"
+    },
+    "readonly": {
+      "value": true,
+      "serial": 0,
+      "flags": [],
+      "name": "readonly configure",
+      "name[zh_CN]": "我是只读配置",
+      "description": "I am a readonly configure",
+      "permissions": "readonly",
+      "visibility": "private"
     }
   }
 }

tests/ut_dconfig.cpp

@@ -226,3 +226,18 @@ TEST_F(ut_DConfig, isDefaultValue) {
         EXPECT_EQ(config.isDefaultValue("key2"), true);
     }
 }
+
+TEST_F(ut_DConfig, isReadOnly) {
+
+    FileCopyGuard guard(":/data/dconf-example.meta.json", metaFilePath);
+    {
+        DConfig config(FILE_NAME);
+        EXPECT_FALSE(config.isValid());
+        ASSERT_EQ(config.isReadOnly("readwrite"), false);
+    }
+    {
+        DConfig config(FILE_NAME);
+        EXPECT_FALSE(config.isValid());
+        EXPECT_EQ(config.isReadOnly("readonly"), true);
+    }
+}