OpenHarmony分布式调度详解|dmslite_pack.c

往期知识点记录：

• 鸿蒙（HarmonyOS）应用层开发（北向）知识点汇总
• OpenHarmony轻量系统服务管理|samgr_server功能详解(一)
• OpenHarmony轻量系统服务管理|samgr_server功能详解(二)
• OpenHarmony轻量系统服务管理|samgr_server功能详解(三)
• OpenHarmony轻量系统服务管理|samgr_server功能详解(四)
• OpenHarmony轻量系统服务管理|samgr_server功能详解(五)
• OpenHarmony轻量系统服务管理|samgr_server功能详解(六)
• OpenHarmony分布式调度详解|dmslite.c
• OpenHarmony分布式调度详解|dmslite_feature.c 源码阅读
• OpenHarmony分布式调度详解|dmslite_session.c
• OpenHarmony分布式调度详解|dmslite_tlv_common.c
• OpenHarmony分布式调度详解|dmslite_famgr.c
• OpenHarmony分布式调度详解|dmslite_msg_handler.c
• OpenHarmony分布式调度详解|dmslite_pack.c
• 持续更新中……

前言

foundation\distributedschedule\dmsfwk_lite\source\dmslite_pack.c文件中主要是对数据处理的包装和整合，比如转换数据类型、改变数据存储方式（大端转小端）等处理。

代码分析

文件中包含两个全局变量g_buffer和g_counter，并设置了GetPacketSize()和GetPacketBufPtr()供其他模块使用，对数据做相应处理后，保存到全局变量g_buffer中。

static char* g_buffer = NULL;
static uint8_t g_counter = 0;
// 返回全局g_counter
uint16_t GetPacketSize()
{
    return g_counter;
}
// 返回全局g_buffer的首地址
char* GetPacketBufPtr()
{
    return g_buffer;
}

foundation\distributedschedule\dmsfwk_lite\include\dmslite_pack.h文件中声明了数据转换的函数，分别将数据转换为uint8-uint64和int8-int64类型，其中MarshallString()将数据转换为字符串类型：

bool MarshallUint8(uint8_t field, FieldType fieldType);
bool MarshallUint16(uint16_t field, FieldType fieldType);
bool MarshallUint32(uint32_t field, FieldType fieldType);
bool MarshallUint64(uint64_t field, FieldType fieldType);
bool MarshallInt8(int8_t field, FieldType fieldType);
bool MarshallInt16(int16_t field, FieldType fieldType);
bool MarshallInt32(int32_t field, FieldType fieldType);
bool MarshallInt64(int64_t field, FieldType fieldType);
bool MarshallString(const char *field, unit8_t type)

其他函数在以上函数中使用到：

// 将字符串值按字符存储到g_buffer中
static bool StringToHex(const char *stringValue)
{
    if (stringValue == NULL) {
        return false;
    }
    for (uint32_t i = 0; i < strlen(stringValue); i++) {
        char ch = stringValue[i];
        g_buffer[g_counter++] = ch;
    }
    g_buffer[g_counter++] = '\0';
    return true;
}
// 对tlv数据的length做编码处理
static uint8_t EncodeLengthOfTlv(uint16_t length)
{
    uint8_t bytesNum = MIN_BYTE_NUM_OF_LENGTH_FILED; // length的最小字节数为1
    g_buffer[g_counter] = ((length >> TLV_LENGTH_SHIFT_BITS) & LOW_BIT_MASK); // length右移7位并与0x7F做逻辑与
    if (g_buffer[g_counter]) {
        char highByte = (char)((uint8_t)g_buffer[g_counter] | HIGH_BIT_MASK); // 与0x80做逻辑或
        g_buffer[g_counter++] = highByte;
        g_buffer[g_counter++] = (length & LOW_BIT_MASK);
        bytesNum = MAX_BYTE_NUM_OF_LENGTH_FILED; // length的最大字节数为2
    } else {
        g_buffer[g_counter++] = (length & LOW_BIT_MASK);
    }
    return bytesNum;
}
// 将value按字节填入g_buffer中
static void IntToHex(uint64_t value, uint8_t typeSize)
{
    uint8_t *bytes = (uint8_t*)&value;
    /* put byte one by one from low address to high address */
    // 把字节从低地址一个一个d放到高地址
    for (int8_t i = 0; i < typeSize; i++) {
        uint8_t val = bytes[i];
        g_buffer[g_counter++] = val;
    }
}
/**
 * 函数功能：根据typeSize从从小段到大端转换数据类型
 * 函数参数：
 *        dataIn：需要转换的数据
 *        typeSize：需要转换的数据类型
 * 函数返回值：
 *        返回转换后的数据
 */
static uint64_t ConvertIntLittle2Big(const uint8_t *dataIn, uint8_t typeSize)
{
    uint64_t dataOut = 0;
    switch (typeSize) {
        case INT_16:
            Convert16DataLittle2Big(dataIn, (uint8_t*)&dataOut); // 转换为unit_16类型
            break;
        case INT_32:
            Convert32DataLittle2Big(dataIn, (uint8_t*)&dataOut); // 转换为unit_32类型
            break;
        case INT_64:
            Convert64DataLittle2Big(dataIn, (uint8_t*)&dataOut); // 转换为unit_64类型
            break;
        default:
            break;
    }
    return dataOut;
}
/**
 * 函数功能：整合数据（字段、字段类型、字段大小）
 * 函数参数：
 *      field：字段
 *      fieldType：字段类型
 *      fieldSize：字段大小
 * 函数参数：
 *      成功，返回true；失败(字段过大)，返回false
 */
static bool MarshallInt(uint64_t field, FieldType fieldType, uint8_t fieldSize)
{
    if (g_buffer == NULL) { // 首先判断g_buffer是否保存有数据
        return false;
    }
    IntToHex(fieldType, sizeof(uint8_t)); // 将传入的字段类型按字节保存到g_buffer
    uint8_t bytesNum = EncodeLengthOfTlv(fieldSize); // 对tlv数据的length做编码处理
    if (g_counter + (TYPE_FILED_LENGTH + bytesNum + fieldSize) > PACKET_DATA_SIZE) { // 超过限定的最大容量，返回f
        HILOGE("MarshallInt field is too big to fit");
        return false;
    }
    IntToHex(IsBigEndian() ? field : ConvertIntLittle2Big((uint8_t*)&field, fieldSize), fieldSize); // 判断字段是否为大端存储，如果是，则直接按字节保存到g_buffer；否则先转化为大端存储，再按字节保存到g_buffer
    return true;
}

总结

该文件中将整合后的数据存储在g_buffer中，并使用g_counter来做标记，供其他模块访问。

写在最后

如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：

• 点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
• 关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
• 想要获取更多完整鸿蒙最新学习资源，请看下图提示：