rest_server.h

Go to the documentation of this file.

// BSD 3-Clause License
// Copyright (c) 2021-2025, 🍀☀🌕🌥 🌊
// See the LICENSE file in the project root for full license information.
 
#pragma once
 
#include "rest_config.h"
 
#include <cstdint>
#include <memory>
 
// Forward declarations for PACS monitoring
namespace kcenon::pacs::monitoring {
class health_checker;
class pacs_metrics;
} // namespace kcenon::pacs::monitoring
 
namespace kcenon::pacs::security {
class access_control_manager;
} // namespace kcenon::pacs::security
 
namespace kcenon::pacs::web::auth {
struct oauth2_config;
class oauth2_middleware;
class jwks_provider;
} // namespace kcenon::pacs::web::auth
 
namespace kcenon::pacs::storage {
class index_database;
class file_storage;
} // namespace kcenon::pacs::storage
 
namespace kcenon::pacs::network {
class dicom_server;
} // namespace kcenon::pacs::network
 
namespace kcenon::pacs::client {
class remote_node_manager;
class job_manager;
class routing_manager;
} // namespace kcenon::pacs::client
 
namespace kcenon::pacs::web {
 
class rest_server {
public:
  rest_server();
 
  explicit rest_server(const rest_server_config &config);
 
  ~rest_server();
 
  rest_server(const rest_server &) = delete;
  rest_server &operator=(const rest_server &) = delete;
 
  rest_server(rest_server &&other) noexcept;
  rest_server &operator=(rest_server &&other) noexcept;
 
  // =========================================================================
  // Configuration
  // =========================================================================
 
  [[nodiscard]] const rest_server_config &config() const noexcept;
 
  void set_config(const rest_server_config &config);
 
  // =========================================================================
  // Integration
  // =========================================================================
 
  void set_health_checker(std::shared_ptr<monitoring::health_checker> checker);
 
  void set_metrics_provider(std::shared_ptr<monitoring::pacs_metrics> metrics);
 
  void set_access_control_manager(
      std::shared_ptr<security::access_control_manager> manager);
 
  void set_database(std::shared_ptr<storage::index_database> database);
 
  void set_file_storage(std::shared_ptr<storage::file_storage> storage);
 
  void set_node_manager(std::shared_ptr<client::remote_node_manager> manager);
 
  void set_job_manager(std::shared_ptr<client::job_manager> manager);
 
  void set_routing_manager(std::shared_ptr<client::routing_manager> manager);
 
  void set_dicom_server(std::shared_ptr<network::dicom_server> server);
 
  void set_oauth2_middleware(
      std::shared_ptr<auth::oauth2_middleware> middleware);
 
  // =========================================================================
  // Lifecycle
  // =========================================================================
 
  void start();
 
  void start_async();
 
  void stop();
 
  [[nodiscard]] bool is_running() const noexcept;
 
  void wait();
 
  [[nodiscard]] std::uint16_t port() const noexcept;
 
private:
  struct impl;
  std::unique_ptr<impl> impl_;
};
 
} // namespace kcenon::pacs::web