* Copyright (C) 2021 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.
*/
#include "plugin.h"
#include <utility>
#include "image_log.h"
#include "impl_class_mgr.h"
#include "json.hpp"
#include "json_helper.h"
#include "platform_adp.h"
#include "singleton.h"
#include <charconv>
#ifdef _WIN32
#include <windows.h>
HMODULE hDll = NULL;
#endif
#undef LOG_DOMAIN
#define LOG_DOMAIN LOG_TAG_DOMAIN_ID_PLUGIN
#undef LOG_TAG
#define LOG_TAG "Plugin"
namespace OHOS {
namespace MultimediaPlugin {
using nlohmann::json;
using std::istream;
using std::istringstream;
using std::recursive_mutex;
using std::size_t;
using std::string;
using std::weak_ptr;
enum class VersionParseStep : int32_t { STEP_MAJOR = 0, STEP_MINOR, STEP_MICRO, STEP_NANO, STEP_FINISHED };
struct VersionNum {
uint16_t major = 0;
uint16_t minor = 0;
uint16_t micro = 0;
uint16_t nano = 0;
};
Plugin::Plugin()
: platformAdp_(DelayedRefSingleton<PlatformAdp>::GetInstance()),
implClassMgr_(DelayedRefSingleton<ImplClassMgr>::GetInstance()) {}
Plugin::~Plugin()
{
std::unique_lock<std::recursive_mutex> guard(dynDataLock_);
if (refNum_ != 0) {
IMAGE_LOGE("release plugin: refNum: %{public}u.", refNum_);
}
implClassMgr_.DeleteClass(plugin_);
FreeLibrary();
}
uint32_t Plugin::Register(istream &metadata, string &&libraryPath, weak_ptr<Plugin> &plugin)
{
std::unique_lock<std::recursive_mutex> guard(dynDataLock_);
if (state_ != PluginState::PLUGIN_STATE_UNREGISTER) {
IMAGE_LOGI("repeat registration.");
return ERR_INTERNAL;
}
auto ret = RegisterMetadata(metadata, plugin);
if (ret != SUCCESS) {
IMAGE_LOGE("failed to register metadata, ERRNO: %{public}u.", ret);
return ret;
}
libraryPath_ = std::move(libraryPath);
plugin_ = plugin;
state_ = PluginState::PLUGIN_STATE_REGISTERED;
return SUCCESS;
}
bool CfiStartFunc_(PluginStartFunc startFunc_) __attribute__((no_sanitize("cfi")))
{
return startFunc_();
}
uint32_t Plugin::Ref()
{
std::unique_lock<std::recursive_mutex> guard(dynDataLock_);
if (state_ == PluginState::PLUGIN_STATE_REGISTERED) {
if (ResolveLibrary() != SUCCESS) {
guard.unlock();
IMAGE_LOGE("failed to resolve library.");
return ERR_GENERAL;
}
state_ = PluginState::PLUGIN_STATE_RESOLVED;
}
if (state_ == PluginState::PLUGIN_STATE_RESOLVED) {
state_ = PluginState::PLUGIN_STATE_STARTING;
if (!CfiStartFunc_(startFunc_)) {
IMAGE_LOGE("failed to start plugin.");
FreeLibrary();
state_ = PluginState::PLUGIN_STATE_REGISTERED;
return ERR_GENERAL;
}
state_ = PluginState::PLUGIN_STATE_ACTIVE;
}
if (state_ != PluginState::PLUGIN_STATE_ACTIVE) {
IMAGE_LOGE("plugin ref: state error, state: %{public}d.", state_);
return ERR_GENERAL;
}
++refNum_;
IMAGE_LOGD("plugin refNum: %{public}d.", refNum_);
return SUCCESS;
}
void Plugin::DeRef()
{
std::unique_lock<std::recursive_mutex> guard(dynDataLock_);
if (refNum_ == 0) {
guard.unlock();
IMAGE_LOGE("DeRef while RefNum is zero.");
return;
}
--refNum_;
IMAGE_LOGD("plugin refNum: %{public}d.", refNum_);
}
void Plugin::Block()
{
std::unique_lock<std::recursive_mutex> guard(dynDataLock_);
blocked_ = true;
}
void Plugin::Unblock()
{
std::unique_lock<std::recursive_mutex> guard(dynDataLock_);
blocked_ = false;
}
PluginCreateFunc Plugin::GetCreateFunc()
{
std::unique_lock<std::recursive_mutex> guard(dynDataLock_);
if ((state_ != PluginState::PLUGIN_STATE_ACTIVE) || (refNum_ == 0)) {
IMAGE_LOGE("failed to get create func, State: %{public}d, RefNum: %{public}u.", state_, refNum_);
return nullptr;
}
return createFunc_;
}
const string &Plugin::GetLibraryPath() const
{
return libraryPath_;
}
const string &Plugin::GetPackageName() const
{
return packageName_;
}
uint32_t Plugin::ResolveLibrary()
{
std::string pluginStartSymbol = "PluginExternalStart";
std::string pluginStopSymbol = "PluginExternalStop";
std::string pluginCreateSymbol = "PluginExternalCreate";
#ifdef _WIN32
hDll = platformAdp_.AdpLoadLibrary(libraryPath_);
if (hDll == NULL) {
IMAGE_LOGE("failed to load library.");
return ERR_GENERAL;
}
startFunc_ = (PluginStartFunc)platformAdp_.AdpGetSymAddress(hDll, pluginStartSymbol);
stopFunc_ = (PluginStopFunc)platformAdp_.AdpGetSymAddress(hDll, pluginStopSymbol);
createFunc_ = (PluginCreateFunc)platformAdp_.AdpGetSymAddress(hDll, pluginCreateSymbol);
if (startFunc_ == NULL || stopFunc_ == NULL || createFunc_ == NULL) {
IMAGE_LOGE("failed to get export symbol for the plugin.");
FreeLibrary();
return ERR_GENERAL;
}
return SUCCESS;
#elif defined(ANDROID_PLATFORM) || defined(IOS_PLATFORM)
startFunc_ = PluginExternalStart;
stopFunc_ = PluginExternalStop;
createFunc_ = PluginExternalCreate;
return SUCCESS;
#else
IMAGE_LOGD("ResolveLibrary start loading library path %{public}s.", libraryPath_.c_str());
handle_ = platformAdp_.LoadLibrary(libraryPath_);
if (handle_ == nullptr) {
IMAGE_LOGE("failed to load library.");
return ERR_GENERAL;
}
startFunc_ = (PluginStartFunc)platformAdp_.GetSymAddress(handle_, pluginStartSymbol);
stopFunc_ = (PluginStopFunc)platformAdp_.GetSymAddress(handle_, pluginStopSymbol);
createFunc_ = (PluginCreateFunc)platformAdp_.GetSymAddress(handle_, pluginCreateSymbol);
if (startFunc_ == nullptr || stopFunc_ == nullptr || createFunc_ == nullptr) {
IMAGE_LOGE("failed to get export symbol for the plugin.");
FreeLibrary();
return ERR_GENERAL;
}
return SUCCESS;
#endif
}
void Plugin::FreeLibrary()
{
#ifdef _WIN32
if (state_ == PluginState::PLUGIN_STATE_STARTING || state_ == PluginState::PLUGIN_STATE_ACTIVE) {
if (stopFunc_ != NULL) {
stopFunc_();
}
}
if (handle_ == NULL) {
return;
}
platformAdp_.AdpFreeLibrary(hDll);
hDll = NULL;
startFunc_ = NULL;
stopFunc_ = NULL;
createFunc_ = NULL;
#elif defined(ANDROID_PLATFORM) || defined(IOS_PLATFORM)
startFunc_ = nullptr;
stopFunc_ = nullptr;
createFunc_ = nullptr;
#else
if (state_ == PluginState::PLUGIN_STATE_STARTING || state_ == PluginState::PLUGIN_STATE_ACTIVE) {
if (stopFunc_ != nullptr) {
stopFunc_();
}
}
if (handle_ == nullptr) {
return;
}
platformAdp_.FreeLibrary(handle_);
handle_ = nullptr;
startFunc_ = nullptr;
stopFunc_ = nullptr;
createFunc_ = nullptr;
#endif
}
uint32_t Plugin::RegisterMetadata(istream &metadata, weak_ptr<Plugin> &plugin)
{
json root = nlohmann::json::parse(metadata, nullptr, false);
if (root.is_discarded()) {
IMAGE_LOGE("RegisterMetadata parse json failed.");
return ERR_INVALID_PARAMETER;
}
if (JsonHelper::GetStringValue(root, "packageName", packageName_) != SUCCESS) {
IMAGE_LOGE("read packageName failed.");
return ERR_INVALID_PARAMETER;
}
string targetVersion;
if (JsonHelper::GetStringValue(root, "targetVersion", targetVersion) != SUCCESS) {
IMAGE_LOGE("read targetVersion failed.");
return ERR_INVALID_PARAMETER;
}
uint32_t ret = CheckTargetVersion(targetVersion);
if (ret != SUCCESS) {
IMAGE_LOGE("check targetVersion failed, Version: %{public}s, ERRNO: %{public}u.", targetVersion.c_str(), ret);
return ret;
}
if (JsonHelper::GetStringValue(root, "version", version_) != SUCCESS) {
IMAGE_LOGE("read version failed.");
return ERR_INVALID_PARAMETER;
}
VersionNum versionNum;
ret = AnalyzeVersion(version_, versionNum);
if (ret != SUCCESS) {
IMAGE_LOGE("check version failed, Version: %{public}s, ERRNO: %{public}u.", version_.c_str(), ret);
return ret;
}
size_t classNum;
if (JsonHelper::GetArraySize(root, "classes", classNum) != SUCCESS) {
IMAGE_LOGE("get array size of classes failed.");
return ERR_INVALID_PARAMETER;
}
IMAGE_LOGD("parse class num: %{public}zu.", classNum);
for (size_t i = 0; i < classNum; i++) {
const json &classInfo = root["classes"][i];
if (implClassMgr_.AddClass(plugin, classInfo) != SUCCESS) {
IMAGE_LOGE("failed to add class, index: %{public}zu.", i);
continue;
}
}
return SUCCESS;
}
uint32_t Plugin::CheckTargetVersion(const string &targetVersion)
{
VersionNum versionNum;
auto ret = AnalyzeVersion(targetVersion, versionNum);
if (ret != SUCCESS) {
IMAGE_LOGE("failed to analyze version, ERRNO: %{public}u.", ret);
return ret;
}
return SUCCESS;
}
uint32_t Plugin::AnalyzeVersion(const string &versionInfo, VersionNum &versionNum)
{
VersionParseStep step = VersionParseStep::STEP_MAJOR;
istringstream versionInput(versionInfo);
uint16_t versionArray[VERSION_ARRAY_SIZE] = { 0 };
string tmp;
while (getline(versionInput, tmp, '.')) {
auto ret = ExecuteVersionAnalysis(tmp, step, versionArray);
if (ret != SUCCESS) {
IMAGE_LOGE("failed to execute version analysis, ERRNO: %{public}u.", ret);
return ret;
}
}
if (step == VersionParseStep::STEP_NANO) {
IMAGE_LOGD("default nano version 0.");
versionArray[VERSION_NANO_INDEX] = 0;
step = VersionParseStep::STEP_FINISHED;
}
if (step != VersionParseStep::STEP_FINISHED) {
IMAGE_LOGE("analysis version failed, step = %{public}d.", step);
return ERR_INVALID_PARAMETER;
}
versionNum.major = versionArray[VERSION_MAJOR_INDEX];
versionNum.minor = versionArray[VERSION_MINOR_INDEX];
versionNum.micro = versionArray[VERSION_MICRO_INDEX];
versionNum.nano = versionArray[VERSION_NANO_INDEX];
IMAGE_LOGD("analysis result: %{public}u.%{public}u.%{public}u.%{public}u.", versionNum.major,
versionNum.minor, versionNum.micro, versionNum.nano);
return SUCCESS;
}
uint32_t Plugin::ExecuteVersionAnalysis(const string &input, VersionParseStep &step,
uint16_t (&versionNum)[VERSION_ARRAY_SIZE])
{
switch (step) {
case VersionParseStep::STEP_MAJOR: {
auto ret = GetUint16ValueFromDecimal(input, versionNum[VERSION_MAJOR_INDEX]);
if (ret != SUCCESS) {
IMAGE_LOGE("read major version failed, input: %{public}s, ERRNO: %{public}u.", input.c_str(), ret);
return ret;
}
step = VersionParseStep::STEP_MINOR;
break;
}
case VersionParseStep::STEP_MINOR: {
auto ret = GetUint16ValueFromDecimal(input, versionNum[VERSION_MINOR_INDEX]);
if (ret != SUCCESS) {
IMAGE_LOGE("read minor version failed, input: %{public}s, ERRNO: %{public}u.", input.c_str(), ret);
return ret;
}
step = VersionParseStep::STEP_MICRO;
break;
}
case VersionParseStep::STEP_MICRO: {
auto ret = GetUint16ValueFromDecimal(input, versionNum[VERSION_MICRO_INDEX]);
if (ret != SUCCESS) {
IMAGE_LOGE("read micro version failed, input: %{public}s, ERRNO: %{public}u.", input.c_str(), ret);
return ret;
}
step = VersionParseStep::STEP_NANO;
break;
}
case VersionParseStep::STEP_NANO: {
auto ret = GetUint16ValueFromDecimal(input, versionNum[VERSION_NANO_INDEX]);
if (ret != SUCCESS) {
IMAGE_LOGE("read nano version failed, input: %{public}s, ERRNO: %{public}u.", input.c_str(), ret);
return ret;
}
step = VersionParseStep::STEP_FINISHED;
break;
}
default: {
IMAGE_LOGE("read redundant version data, input: %{public}s.", input.c_str());
return ERR_INVALID_PARAMETER;
}
}
return SUCCESS;
}
static bool ConvertToUnsignedLong(const std::string& str, unsigned long& value)
{
auto [ptr, errCode] = std::from_chars(str.data(), str.data() + str.size(), value);
bool ret = errCode == std::errc{} && (ptr == str.data() + str.size());
return ret;
}
uint32_t Plugin::GetUint16ValueFromDecimal(const string &source, uint16_t &result)
{
if (source.empty() || source.size() > UINT16_MAX_DECIMAL_DIGITS) {
IMAGE_LOGE("invalid string of uint16: %{public}s.", source.c_str());
return ERR_INVALID_PARAMETER;
}
for (const auto &character : source) {
if (character < '0' || character > '9') {
IMAGE_LOGE("character out of the range of digital: %{public}s.", source.c_str());
return ERR_INVALID_PARAMETER;
}
}
unsigned long tmp = 0;
if (!ConvertToUnsignedLong(source, tmp)) {
IMAGE_LOGE("source = %{public}s convert string to unsigned long failed", source.c_str());
return ERR_INVALID_PARAMETER;
}
if (tmp > UINT16_MAX_VALUE) {
IMAGE_LOGE("result out of the range of uint16: %{public}s.", source.c_str());
return ERR_INVALID_PARAMETER;
}
result = static_cast<uint16_t>(tmp);
return SUCCESS;
}
}
}