Package at.jku.dke.etutor.task_app.services

Interface SubmissionService<U>

Type Parameters:
U - The type of the submission input used in SubmitSubmissionDto.
All Known Implementing Classes:
BaseSubmissionService
@Validated public interface SubmissionService<U>
Interface for classes that manage Submissions.

  • Method Details

    • enqueue

      UUID enqueue(@Valid @Valid SubmitSubmissionDto<U> submission)
      Enqueues the submission for evaluation.
      Parameters:
      submission - The submission.
      Returns:
      The submission identifier.

    • execute

      GradingResultDto execute(@Valid @Valid SubmitSubmissionDto<U> submission, boolean persist)
      Executes the submission and returns the evaluation results.
      Parameters:
      submission - The submission.
      persist - Whether the submission should be stored permanently.
      Returns:
      The evaluation results.

    • getEvaluationResult

      GradingDto getEvaluationResult(UUID id)
      Returns the evaluation results for the specified submission.
      Parameters:
      id - The submission identifier.
      Returns:
      The evaluation results or null if the result is not available.
      Throws:
      jakarta.persistence.EntityNotFoundException - If the submission does not exist.

    • getSubmissions

      org.springframework.data.domain.Page<SubmissionDto<U>> getSubmissions(org.springframework.data.domain.Pageable page, String userFilter, Long taskFilter, String assignmentFilter, SubmissionMode modeFilter)
      Returns all submissions for the requested page.
      Parameters:
      page - The page and sorting information.
      userFilter - Optional user filter string (applies equals to userId attribute).
      taskFilter - Optional task filter string (applies equals to taskId attribute).
      assignmentFilter - Optional assignment filter string (applies equals to assignmentId attribute).
      modeFilter - Optional mode filter (applies equals to mode attribute).
      Returns:
      List of submissions

    • delete

      void delete(UUID id)
      Deletes the submission with the specified identifier.
      Parameters:
      id - The submission identifier.