Hanami backend/fi.aalto.cs.hanami.courses/CourseService

CourseService

class CourseService : AutoCloseable(source)

Serves authorization-scoped course data and owns the process-local course caches.

Callers pass a current AuthorizedCourseRequest before any student, points, or structure cache can be read. Course invalidation also rejects results from older in-flight loads.

Properties

aplusWebUrl

val aplusWebUrl: String

Functions

cachedOrOptimisticAvailability

fun cachedOrOptimisticAvailability(courseId: Long, token: String): Boolean

open override fun close()

invalidate

fun invalidate(courseId: Long)

invalidateStudentProgress

fun invalidateStudentProgress(courseId: Long, studentIds: Collection<Long>)

ownsExercise

suspend fun ownsExercise(request: AuthorizedCourseRequest, exerciseId: Long): Boolean

preload

fun preload(request: AuthorizedCourseRequest)

requireExercise

suspend fun requireExercise(request: AuthorizedCourseRequest, exerciseId: Long)

searchStudents

suspend fun searchStudents(request: AuthorizedCourseRequest, query: String, tag: String?, limit: Int): StudentsResponse

snapshot

suspend fun snapshot(request: AuthorizedCourseRequest, lang: String): CourseSnapshot

student

suspend fun student(request: AuthorizedCourseRequest, studentId: Long): StudentView?

studentBest

suspend fun studentBest(request: AuthorizedCourseRequest, lang: String, studentId: String): StudentBestSnapshot

studentPointsSummary

suspend fun studentPointsSummary(request: AuthorizedCourseRequest, studentId: String): StudentPointsSummary

students

suspend fun students(request: AuthorizedCourseRequest): List<StudentView>

visibleTags

fun visibleTags(request: AuthorizedCourseRequest): List<CourseTag>

weekFileUrls

suspend fun weekFileUrls(request: AuthorizedCourseRequest, lang: String, studentId: String, weekId: Long): WeekFileUrls