course-service 0.2.0

Course Service — a course-administration microservice modelled on schema.org/Course; interoperates with the course-matcher crate
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

//! Shared application state passed to every REST handler.

use std::sync::Arc;

use sea_orm::DatabaseConnection;

use crate::config::Config;
use crate::db::{
    CourseRepository, SeaOrmCourseRepository, audit::AuditLogRepository,
};
use crate::matching::CourseMatcher;
use crate::search::SearchEngine;
use crate::streaming::{EventPublisher, InMemoryEventPublisher};

/// Shared, cheaply-cloneable handle to every service the REST handlers
/// need. Cloned per request by Axum; the inner services are `Arc`-shared.
#[derive(Clone)]
pub struct AppState {
    /// Raw connection pool (for ad-hoc queries outside the repository).
    pub db: DatabaseConnection,
    /// Course CRUD repository.
    pub course_repository: Arc<dyn CourseRepository>,
    /// Audit-log repository.
    pub audit_log: Arc<AuditLogRepository>,
    /// Event-stream publisher.
    pub event_publisher: Arc<dyn EventPublisher>,
    /// Full-text search engine.
    pub search_engine: Arc<SearchEngine>,
    /// Record matcher.
    pub matcher: Arc<CourseMatcher>,
    /// Loaded service configuration.
    pub config: Arc<Config>,
}

impl AppState {
    /// Assemble state from the externally-built services, constructing
    /// the SeaORM repository, audit log, and in-memory event publisher
    /// from the shared connection.
    pub fn new(
        db: DatabaseConnection,
        search_engine: SearchEngine,
        matcher: CourseMatcher,
        config: Config,
    ) -> Self {
        let course_repository: Arc<dyn CourseRepository> =
            Arc::new(SeaOrmCourseRepository::new(db.clone()));
        let audit_log = Arc::new(AuditLogRepository::new(db.clone()));
        let event_publisher: Arc<dyn EventPublisher> = Arc::new(InMemoryEventPublisher::new());
        Self {
            db,
            course_repository,
            audit_log,
            event_publisher,
            search_engine: Arc::new(search_engine),
            matcher: Arc::new(matcher),
            config: Arc::new(config),
        }
    }
}