Method valueHandle

app/src/API/Handlers/DataTablesHandler.cpp:734–759

* @brief Resolves a (table, register) pair to a reusable handle for the marshalled fast path. */

 * @brief Resolves a (table, register) pair to a reusable handle for the marshalled fast path.
 */
API::CommandResponse API::Handlers::DataTablesHandler::valueHandle(const QString& id,
                                                                   const QJsonObject& params)
{
  QString table;
  QString name;
  if (!requireString(params, QStringLiteral("table"), table))
    return CommandResponse::makeError(
      id, ErrorCode::MissingParam, QStringLiteral("Missing required parameter: table"));

  if (!requireString(params, QStringLiteral("name"), name))
    return CommandResponse::makeError(
      id, ErrorCode::MissingParam, QStringLiteral("Missing required parameter: name"));

  const auto& store = DataModel::FrameBuilder::instance().tableStore();
  if (!store.isInitialized())
    return CommandResponse::makeError(
      id, ErrorCode::InvalidParam, QStringLiteral("Data-table store not initialized (no project)"));

  const qint64 handle = store.handleOf(table, name);

  QJsonObject result;
  result[QStringLiteral("table")]  = table;
  result[QStringLiteral("name")]   = name;
  result[QStringLiteral("handle")] = static_cast<double>(handle);
  return CommandResponse::makeSuccess(id, result);
}

/**
 * @brief Returns a register's live value by handle; found=false for a stale or invalid handle.