OHOS HDF 图谱-2-HdfObject对象构造器

OHOS HDF 图谱-2-HdfObject对象构造器

梁开祝 2022.05.09

【说明： “OHOS HDF 图谱”系列文章，是《沉浸式剖析OpenHarmony源代码》一书第9章内容的补充材料。本系列文章将会给出大量的高清图片，要么是无法印刷到书里的超级大图，要么是书籍定稿后新近整理的图片。书籍中如已经有对图片的详细解释，本系列文章将只做简单介绍；如书中没有详细解释，本系列文章将补充详细说明。】

系列文章列表：

《与OpenHarmony共同成长：一年的历程和成果展示》

《OHOS HDF 图谱-1-驱动配置信息树状图》

OpenHarmony驱动框架，是采用C语言加面向对象编程模型来实现的（C语言如何为实现面向对象编程，请小伙伴们自行网络搜索和学习）。C 面向对象编程中，是通过构造函数来对具体类的对象进行构造和初始化的；C语言实现的驱动框架，在重要数据结构(类)实例的构造和初始化的时候，则是采用了通过objectId来查表，在对象构造器列表中调用匹配objectId的对象构造函数来生成对应的数据结构(类)实例并做初始化。本文主要用图的形式来展示驱动框架中，使用三个HdfObject对象构造器所分别生成的几个重要类对象的快照（数据结构接口）。

1.对象构造器总入口

在驱动框架实现代码中，我们经常会看到类似XxxxGetInstance()或者XxxxNewInstance()这样的调用，以此获取对应类型的类对象实例。

以获取DevmgrService类型实例的struct IDevmgrService *instance = DevmgrServiceGetInstance()为例：


struct IDevmgrService *DevmgrServiceGetInstance(void)
{


static struct IDevmgrService *instance = NULL;


if (instance == NULL) {


instance = (struct IDevmgrService *)


HdfObjectManagerGetObject(HDF_OBJECT_ID_DEVMGR_SERVICE);  // 0


}


return instance;


}

这里的**HdfObjectManagerGetObject()**就是所有对象构造器的总入口，通过参数指定构造哪个类的对象。

整个驱动框架（包括内核态和用户态），有三个对象构造器，通过HdfObjectManagerGetCreators(objectId)函数根据当前调用者所在的进程上下文环境，选用对应的对象构造器，再根据objectId参数来匹配对应的类的构造函数：


struct HdfObject *HdfObjectManagerGetObject(int objectId)
{

struct HdfObject *object = NULL;

const struct HdfObjectCreator *targetCreator = HdfObjectManagerGetCreators(objectId);
if ((targetCreator != NULL) && (targetCreator->Create != NULL)) {

//1. kernel:       driversframeworkcorecommonsrcdevlite_object_config.c

// get the g_liteObjectCreators[objectId].Create to creat a HdfObject

//2. user dev_mgr: driversadapteruhdf2managersrcdevmgr_object_config.c

// get the g_fullDevMgrObjectCreators[objectId].Create to creat a HdfObject

//3. user dev_host:driversadapteruhdf2hostsrcdevhost_object_config.c

// get the g_fullDevHostObjectCreators[objectId].Create to creat a HdfObject

object = targetCreator->Create();

if (object != NULL) {

object->objectId = objectId;

}

}

return object;

}