OpenHarmony实战：使用宏、std::bind 巧妙实现进出函数日志打印

news/2024/7/21 12:30:44 标签: harmonyos, 鸿蒙, linux, 鸿蒙系统, 前端, android, OpenHarmony

背景

我们始终渴望了解模块的调用、时序逻辑，每个人都会轻易地想到在函数的入口打印一条进入 enter 相关的日志，在函数的出口打印一条离开 leave 相关的日志。不能有遗漏，我们会复制这条日志到所有关心的函数中，为了表明是哪个模块，哪个类和哪个函数我们需要逐个将这些参数写入。
这样不可避免地出现第一个问题，每个函数至少添加两条日志，第二个问题当一个函数有多个出口(return)，我们将要打印多条 leave 用以区分。
如果碰到复杂模块，我们仍然简单地这样操作，工作量会让你崩溃，这根本不是一个开发者的追求。有什么简单易行、以逸待劳的好办法？

一、打印函数进出日志的原理

如何在函数的入口只打印一条日志，出口不用打印，却自动产生进入、离开两条日志？我们知道函数内部变量的生命周期遵循的是先进后出原则。进入函数首先就定义一个局部对象，在离开这个函数的时刻自动释放这个对象。如果这个对象是类对象，则在定义时会进入构造函数，离开时进入析构函数。于是在构造函数和析构函数分别打印进出日志，测试结果表明的确是这样。
如何区分来自哪个模块、哪个类、哪个函数？很简单，将模块的 id、类名称 Tag 作为参数传入，函数名则用系统宏 __FUNCTION__ 即可。
经过一番操作，发现所有的进出函数日志名称、参数写的一模一样，低级重复不是一个开发者的追求，能不能不写参数。于是用一个宏去代替这条日志函数，参数仅写一次，最终效果达到预期......
如果能够管控不同级别的进出日志，就更加完美了。神奇的 std::bind()函数就能实现原函数的二次封装，在重新包装原函数成新接口（新规范）能力方面，这个功能特别有用。下面将对原理提及的知识点逐步进行讲解。

二、实现函数进出打印功能

第一步，日志类在共用头文件里面实现

例如，sensors 模块就在 utils\common 目录下的 sensors_errors.h 文件
.\base\sensors\miscdevice\utils\common\include\sensors_errors.h

第二步，实现一个简易的只包含构造和析构函数的类

里面会调用 HiviewDFX 日志模块 HiLog::Debug()函数，包含 #include "hilog/log.h"

#include "hilog/log.h"
class InnerFunctionTracer {
public:
    InnerFunctionTracer(const OHOS::HiviewDFX::HiLogLabel &label, const char *func)
        : label_ { label }, func_ { func }
    {
        OHOS::HiviewDFX::HiLog::Debug(label_, "wyyxiu in %{public}s, enter_func", func_);
    }
    ~InnerFunctionTracer()
    {
        OHOS::HiviewDFX::HiLog::Debug(label_, "wyyxiu in %{public}s, leave_func", func_);
    }
private:
    const OHOS::HiviewDFX::HiLogLabel &label_;
    const char *func_ { nullptr };
};

第三步，InnerFunctionTracer 的构造函数参数是通过下面定义对象时将参数传入的

#define CALL_LOG_ENTER InnerFunctionTracer ___innerFuncTracer___ { LABEL, __FUNCTION__ }
LABEL: 是通过宏 CALL_LOG_ENTER 替换时传入的
__FUNCTION__: 是通过宏 CALL_LOG_ENTER 替换时传入的

第四步，调用 CALL_LOG_ENTER 宏就会打印出这个函数进出日志

LABEL: 需要按照给定格式声明，最后一个字符串一般为该类名
__FUNCTION__: 是调用者的函数名称

// 首先，包含声明宏的头文件 sensors_errors.h；
#include "sensors_errors.h"

namespace Sensors {
using namespace OHOS::HiviewDFX;

namespace {
// 其次，声明 LABEL；
constexpr HiLogLabel LABEL = { LOG_CORE, MISC_LOG_DOMAIN, "MiscdeviceServiceStub" };
}  // namespace

// 最后，将 CALL_LOG_ENTER放置在需要打印进出日志的那个函数开头；
int32_t MiscdeviceServiceStub::PlayPatternStub(MessageParcel &data, MessageParcel &reply)
{
    CALL_LOG_ENTER;
    // ......
    return PlayPattern(pattern.value(), usage, parameter.value());
}

三、现在，看一个更加复杂一点的进出日志函数实现

参考示例的头文件如下

.\base\msdp\device_status\utils\common\include\fi_log.h，或者
.\foundation\multimodalinput\input\util\common\include\mmi_log.h

有两个显著不同点

  1. 在构造和析构函数中可以打印任意级别的日志，它是将日志函数作为参数传入的，赋值给 logfn_
  2. 通过日志系统函数 HiLogIsLoggable()，过滤允许级别的日志
class InnerFunctionTracer {
public:
    using HilogFunc = std::function<int(const char *)>;

public:
    InnerFunctionTracer(HilogFunc logfn, const char* tag, LogLevel level)
        : logfn_ { logfn }, tag_ { tag }, level_ { level }
    {
        if (HiLogIsLoggable(OHOS::MMI::MMI_LOG_DOMAIN, tag_, level_)) {
            if (logfn_ != nullptr) {
                logfn_("wyyxiu in %{public}s, enter_func");
            }
        }
    }
    ~InnerFunctionTracer()
    {
        if (HiLogIsLoggable(OHOS::MMI::MMI_LOG_DOMAIN, tag_, level_)) {
            if (logfn_ != nullptr) {
                logfn_("wyyxiu in %{public}s, leave_func");
            }
        }
    }
private:
    HilogFunc logfn_ { nullptr };
    const char* tag_ { nullptr };
    LogLevel level_ { LOG_LEVEL_MIN };
};

奇妙的地方是采用了 std::bind()函数，将不同级别日志函数作为参数传入类中

需要过滤将日志级别 LogLevel 传入，关于 std::bind() 用法如后所述

#define CALL_DEBUG_ENTER        ::OHOS::MMI::InnerFunctionTracer ___innerFuncTracer_Debug___    \
    { std::bind(&::OHOS::HiviewDFX::HiLog::Debug, LABEL, std::placeholders::_1, __FUNCTION__), LABEL.tag, LOG_DEBUG }

#define CALL_INFO_TRACE         ::OHOS::MMI::InnerFunctionTracer ___innerFuncTracer_Info___     \
    { std::bind(&::OHOS::HiviewDFX::HiLog::Info, LABEL, std::placeholders::_1, __FUNCTION__), LABEL.tag, LOG_INFO }

HiLogIsLoggable()函数的系统实现

  • 只有系统使能了模块 DEBUG 日志，这类 CALL_DEBUG_ENTER 才被打印输出。
  • 以多模输入为例，需要在 hdc shell 窗口输入 hilog -b I -D 0xD002800，使能 DEBUG 级别，0xD002800 代表 OHOS::MMI::MMI_LOG_DOMAIN。
  • 如果有编译环境，有一个省事的方法，将 HiLog::Debug 改为 HiLog::Info，LOG_DEBUG 修改为 LOG_INFO，该日志一般都会被打印出来，如 CALL_INFO_TRACE 所示。
  • HiLogIsLoggable()函数的实现在这个文件： .\base\hiviewdfx\hilog\frameworks\libhilog\hilog_printf.cpp

.\base\hiviewdfx\hilog\frameworks\libhilog\hilog_printf.cpp

/**
 * @brief Check whether log of a specified domain, tag and level can be printed.
 *
 * @param domain macro:LOG_DOMAIN
 * @param tag macro:LOG_TAG
 * @param level enum:LogLevel
 */
bool HiLogIsLoggable(unsigned int domain, const char *tag, LogLevel level)
{
    if ((level <= LOG_LEVEL_MIN) || (level >= LOG_LEVEL_MAX) || (tag == nullptr) || (domain >= DOMAIN_OS_MAX)) {
        return false;
    }
    if (level < GetFinalLevel(domain, tag)) {
        return false;
    }
    return true;
}

四、std::bind()函数的用法

c++11 及以上支持 std::bind

包含头文件 #include <functional>

使用示例

  1. std::bind 就是一个对原函数和函数参数的重新绑定。
  2. std::placeholders 是新函数的占位符标记。
  3. std::placeholders::_n 中的，_n 表示的是新函数的第 n 个参数，将代替原函数声明位置时的参数。
  4. 未出现 std::placeholders 的原函数位置，必须有默认值。
#include <iostream>
#include <functional>
using namespace std;

int TestFunc(int i, char c, float f)
{
    cout << i << endl;
    cout << c << endl;
    cout << f << endl;

    return i;
}

int main()
{
    auto bindFunc1 = bind(TestFunc, std::placeholders::_1, 'A', 999.9);
    bindFunc1(16);
    auto bindFunc2 = bind(TestFunc, std::placeholders::_2, std::placeholders::_1, 999.9);
    bindFunc2('B', 16);
    auto bindFunc3 = bind(TestFunc, std::placeholders::_2, std::placeholders::_3, std::placeholders::_1);
    auto ret = bindFunc3(999.9, 32, 'C');
    cout << ret << endl;
    return 0;
}

五、预期效果

为了方便查找进出日志，加入了特别字段，例如 "_func" 和 "wyyxiu"。

  • 首先出现 enter_func, 然后出现 leave_func, enter_func 和 leave_func 成对出现，打印出的日志片段如下：
  • 如果止步于看到日志，还有一点可惜。按照日志名称、出现规律，经过一番操作，很容易从日志文件整理出函数调用的时序图。
  • 如何快速将日志文件整理出函数调用的时序图，关注我、等待后续文章。

六、总结

本文巧妙使用了三个知识点完成了函数进出日志打印。首先利用函数局部类对象实现在函数的入口只打印一条日志，出口不用打印，却自动产生进入、离开两条日志的目的；其次利用宏替换将模块 id、类名称 Tag、函数名称写在宏函数中，实现了所有参数只写一次的目的；最后利用 std::bind()函数管控不同级别进出日志打印。

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。 


http://www.niftyadmin.cn/n/5470770.html

相关文章

算法——矩阵：对于边界元素的处理

算法——矩阵：对于边界元素的处理

. - 力扣&#xff08;LeetCode&#xff09; 题目简述&#xff1a;扫雷&#xff0c;点击一个格子&#xff0c;返回整个地图的下一个状态。 对于边界元素&#xff0c;可以设置两个数组&#xff0c;index_row&#xff0c;index_col&#xff0c;遍历到一个格子需要搜索其周围格子…
阅读更多...
记一道文件上传

记一道文件上传

林深时遇见鹿&#xff0c;海蓝时遇见鲸。 首先先随便上传一个文件&#xff0c; 经测试php相关后缀都不能上传&#xff0c;且<?被过滤。 而且.user.ini里的file也被过滤了 所以只能使用.htaccess了 但是<?被过滤了&#xff0c;所以我们可以使用php伪协议来用base64加…
阅读更多...
富格林：正规思路实现得益出金

富格林：正规思路实现得益出金

富格林悉知&#xff0c;随着金融市场的不断发展&#xff0c;黄金作为一种正规投资品种被越来越多投资者认识&#xff0c;在黄金投资市场中&#xff0c;有各种各样复杂的信息&#xff0c;投资者要懂得明辨是非&#xff0c;树立正规做单思路避免受害亏损。以下也为大家总结几点正…
阅读更多...
Golang | Leetcode Golang题解之第6题Z字形变换

Golang | Leetcode Golang题解之第6题Z字形变换

题目&#xff1a; 题解&#xff1a; func convert(s string, numRows int) string {n, r : len(s), numRowsif r 1 || r > n {return s}t : r*2 - 2ans : make([]byte, 0, n)for i : 0; i < r; i { // 枚举矩阵的行for j : 0; ji < n; j t { // 枚举每个周期的起始…
阅读更多...
电荷泵如何实现升压原来

电荷泵如何实现升压原来

电荷泵如何实现升压原来 某芯片自举栅极驱动内部原理图迪克森电荷泵 某芯片自举栅极驱动内部原理图 迪克森电荷泵 迪克森电荷泵&#xff08;Dickson Charge Pump&#xff09;是一种电压倍增器电路&#xff0c;可以将低电压升高到较高电压&#xff0c;相对于其他电压升压电路&a…
阅读更多...
先进电气技术 —— （控制理论）何为稳定性？

先进电气技术 —— （控制理论）何为稳定性？

一、系统稳定性 在控制理论中&#xff0c;系统稳定性是一个非常关键的概念&#xff0c;它主要涉及系统对外界扰动或内部变动的响应行为。以下是与系统稳定性相关的一些核心名词及其解释&#xff1a; 基本概念 稳定性&#xff08;Stability&#xff09; 系统稳定性是指当系统受…
阅读更多...
【GEE实践应用】GEE下载遥感数据以及下载后在ArcGIS中的常见显示问题处理（以下载哨兵2号数据为例）

【GEE实践应用】GEE下载遥感数据以及下载后在ArcGIS中的常见显示问题处理（以下载哨兵2号数据为例）

本期内容我们使用GEE进行遥感数据的下载&#xff0c;使用的相关代码如下所示&#xff0c;其中table是我们提前导入的下载遥感数据的研究区域的矢量边界数据。 var district table;var dsize district.size(); print(dsize);var district_geometry district.geometry();Map.…
阅读更多...
DockerCompose从入门到熟悉

DockerCompose从入门到熟悉

一、DockerCompose是什么&#xff1f; Compose 项目是 Docker 官方的开源项目&#xff0c;负责实现对 Docker 容器集群的快速编排。使用前面介绍的Dockerfile我们很容易定义一个单独的应用容器。然而在日常开发工作中&#xff0c;经常会碰到需要多个容器相互配合来完成某项任务…
阅读更多...
最新文章

Copyright @ 2022~2023