Method HandlePUT_mxnLayout

Modules/RESTAPI/src/mitkRenderingController.cpp:1801–1861

}

void RenderingController::HandlePUT_mxnLayout(const httplib::Request& req, httplib::Response& res) const
{
  if (req.body.empty())
  {
    const auto error = ErrorResponse::InvalidRequest(
      "Request body must be a v2.0 layout document.", req.path);
    this->SendErrorResponse(res, 400, error);
    return;
  }

  // Pre-parse the body for syntax validation. Schema / structural validation
  // is done by the engine's ApplyLayout via the bridge; duplicating it here
  // would drift. nlohmann::parse failures surface as 400.
  try
  {
    [[maybe_unused]] const auto parsed = nlohmann::json::parse(req.body);
  }
  catch (const nlohmann::json::exception& e)
  {
    const auto error = ErrorResponse::InvalidRequest(
      std::string("Invalid JSON body: ") + e.what(), req.path);
    this->SendErrorResponse(res, 400, error);
    return;
  }

  if (m_RenderWindowBridge == nullptr || !m_RenderWindowBridge->HasMxNLayoutSetter())
  {
    const auto error = ErrorResponse::RenderWindowNotAvailable(req.path);
    this->SendErrorResponse(res, 503, error);
    return;
  }

  std::string serialized;
  try
  {
    serialized = m_RenderWindowBridge->SetMxNLayout(req.body);
  }
  // Layout-specific catch: every mitk::Exception from ApplyLayout is treated
  // as a document-shape failure. Caught BEFORE the generic std::exception so
  // we don't fall through to MapBridgeException, which would map it to 422.
  // If the engine broadens ApplyLayout's failure model in the future, narrow
  // this catch.
  catch (const mitk::Exception& e)
  {
    const auto error = ErrorResponse::InvalidRequest(
      std::string("Layout document rejected: ") + e.what(), req.path);
    this->SendErrorResponse(res, 400, error);
    return;
  }
  catch (const std::exception& e)
  {
    const auto [status, payload] = MapBridgeException(e, req.path);
    this->SendErrorResponse(res, status, payload);
    return;
  }

  // 200 + body (not 204): clients can refresh their cell name list from the
  // response without an additional GET.