org.sakaiproject.assignment.api.persistence.AssignmentRepository Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of sakai-assignment-api Show documentation
The newest version!
/**
 * Copyright (c) 2003-2017 The Apereo Foundation
 *
 * Licensed under the Educational Community License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *             http://opensource.org/licenses/ecl2
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.sakaiproject.assignment.api.persistence;

import java.util.Collection;
import java.util.List;
import java.util.Map;
import java.util.Optional;
import java.util.Set;

import org.sakaiproject.assignment.api.model.Assignment;
import org.sakaiproject.assignment.api.model.AssignmentSubmission;
import org.sakaiproject.assignment.api.model.AssignmentSubmissionSubmitter;
import org.sakaiproject.serialization.SerializableRepository;

/**
 * Created by enietzel on 4/12/17.
 */

public interface AssignmentRepository extends SerializableRepository {

    Assignment findAssignment(String id);

    List findAssignmentsBySite(String siteId);

    List findDeletedAssignmentsBySite(String siteId);

    List findAllAssignmentIds();

    void newAssignment(Assignment assignment);

    boolean existsAssignment(String assignmentId);

    void deleteAssignment(String assignmentId);

    void deleteSubmission(String submissionId);

    void softDeleteAssignment(String assignmentId);

    AssignmentSubmission findSubmission(String submissionId);

    void updateSubmission(AssignmentSubmission submission);

    boolean existsSubmission(String submissionId);

    boolean existsSubmissionSubmitter(Long submissionSubmitterId);

    AssignmentSubmission newSubmission(String assignmentId,
                       Optional groupId,
                       Optional> submitters,
                       Optional> feedbackAttachments,
                       Optional> submittedAttachments,
                       Optional> properties);

    AssignmentSubmission findSubmissionForUser(String assignmentId, String userId);

    List findSubmissionForUsers(String assignmentId, List userIds);

    AssignmentSubmission findSubmissionForGroup(String assignmentId, String groupId);

    /**
     * Count submissions for a given assignment.
     * If any of the parameters are null they are not included in the query.
     * @param assignmentId the assignment id whose submissions should be counted
     * @param graded if not null adds the requirement that the submission's graded field matches this value
     * @param hasSubmissionDate if not null adds the requirement of whether the submitted date can be null or not
     * @param userSubmission if not null adds the requirement that the submission's userSubmission field matches this value
     * @return
     */
    long countAssignmentSubmissions(String assignmentId, Boolean graded, Boolean hasSubmissionDate, Boolean userSubmission, List userIds);

    void resetAssignment(Assignment assignment);

    /**
     * Find an assignment that is linked with to a gradebook item
     * @param context the context the assignment is in
     * @param linkId the linked id or name of the gradebook item
     * @return the assignment id or empty if none is found
     */
    Optional findAssignmentIdForGradebookLink(String context, String linkId);

    Collection findGroupsForAssignmentById(String assignmentId);

}