159ecfcb创建于 2025年8月19日历史提交
/*
 * Copyright (c) 2024 Huawei Device Co., Ltd.
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef OHOS_ABILITY_RUNTIME_JSON_UTILS_H
#define OHOS_ABILITY_RUNTIME_JSON_UTILS_H

#include <string>
#include <map>
#include <optional>
#include <unordered_set>

#include "nlohmann/json.hpp"
#include "singleton.h"

namespace OHOS {
namespace AAFwk {
/**
 * @class JsonUtils
 * provides json utilities.
 */
class JsonUtils {
public:
    /**
     * GetInstance, get an instance of JsonUtils.
     *
     * @return an instance of JsonUtils.
     */
    static JsonUtils &GetInstance()
    {
        static JsonUtils instance;
        return instance;
    }

    /**
     * JsonUtils, destructor.
     *
     */
    ~JsonUtils() = default;

    /**
     * LoadConfiguration, load configuration.
     *
     * @param path The json file path.
     * @param jsonBuf The json buffer to be returned.
     * @param defaultPath The default output path.
     * @return Whether or not the load operation succeeds.
     */
    bool LoadConfiguration(const std::string& path, nlohmann::json& jsonBuf, const std::string& defaultPath = "");

    /**
     * IsEqual, check if json object contains certain key.
     *
     * @param jsonObject The json object.
     * @param key The key.
     * @param value The string value.
     * @param checkEmpty The flag indicates whether the value can be empty.
     * @return Whether or not the json object contains certain key.
     */
    bool IsEqual(nlohmann::json &jsonObject, const std::string &key,
        const std::string &value, bool checkEmpty = false);
    
    /**
     * IsEqual, check if json object contains certain key.
     *
     * @param jsonObject The json object.
     * @param key The key.
     * @param value The int32_t value.
     * @return Whether or not the json object contains certain key.
     */
    bool IsEqual(nlohmann::json &jsonObject, const std::string &key, int32_t value);

    /**
     * parse json to optional bool.
     *
     * @param jsonObject The json object.
     * @param key The key.
     * @return optional boolean value.
     */
    std::optional<bool> JsonToOptionalBool(const nlohmann::json &jsonObject, const std::string &key);

    /**
     * parse json to bool.
     *
     * @param jsonObject The json object.
     * @param key The key.
     * @return boolean value.
     */
    bool JsonToBool(const nlohmann::json &jsonObject, const std::string &key, bool defaultValue);

    /**
     * parse json to unordered string set.
     *
     * @param jsonObject The json object.
     * @param key The key.
     * @param set The input set.
     */
    void JsonToUnorderedStrSet(const nlohmann::json &jsonObject, const std::string &key,
        std::unordered_set<std::string> &set);

private:
    std::string GetConfigPath(const std::string& path, const std::string& defaultPath);
    bool ReadFileInfoJson(const std::string &filePath, nlohmann::json &jsonBuf);
    JsonUtils() = default;
    DISALLOW_COPY_AND_MOVE(JsonUtils);
};
}  // namespace AAFwk
}  // namespace OHOS
#endif  // OHOS_ABILITY_RUNTIME_JSON_UTILS_H