edu.ksu.canvas.interfaces.MigrationIssueReader Maven / Gradle / Ivy

Go to download
package edu.ksu.canvas.interfaces;

import edu.ksu.canvas.model.MigrationIssue;

import java.io.IOException;
import java.util.List;
import java.util.Optional;

public interface MigrationIssueReader extends CanvasReader {

    /**
     * Returns a list migration issues.
     * @param courseId The destination course ID for the migration
     * @param migrationId The Canvas ID of the content migration
     * @return List of migration issues
     * @throws IOException When there is an error communicating with Canvas
     */
    List getCourseMigrationIssues(String courseId, Integer migrationId) throws IOException;

    /**
     * Returns a migration issue.
     * @param courseId The destination course ID for the migration
     * @param migrationId The Canvas ID of the content migration
     * @param issueId The Canvas ID of the migration issue
     * @return A migration issue
     * @throws IOException When there is an error communicating with Canvas
     */
    Optional getCourseMigrationIssue(String courseId, Integer migrationId, Integer issueId) throws IOException;

    /**
     * Returns a list migration issues.
     * @param userId The user ID for the migration
     * @param migrationId The Canvas ID of the content migration
     * @return List of migration issues
     * @throws IOException When there is an error communicating with Canvas
     */
    List getUserMigrationIssues(String userId, Integer migrationId) throws IOException;

    /**
     * Returns a migration issue.
     * @param userId The user ID for the migration
     * @param migrationId The Canvas ID of the content migration
     * @param issueId The Canvas ID of the migration issue
     * @return A migration issue
     * @throws IOException When there is an error communicating with Canvas
     */
    Optional getUserMigrationIssue(String userId, Integer migrationId, Integer issueId) throws IOException;

    /**
     * Returns a list migration issues.
     * @param groupId The group ID for the migration
     * @param migrationId The Canvas ID of the content migration
     * @return List of migration issues
     * @throws IOException When there is an error communicating with Canvas
     */
    List getGroupMigrationIssues(String groupId, Integer migrationId) throws IOException;

    /**
     * Returns a migration issue.
     * @param groupId The group ID for the migration
     * @param migrationId The Canvas ID of the content migration
     * @param issueId The Canvas ID of the migration issue
     * @return A migration issue
     * @throws IOException When there is an error communicating with Canvas
     */
    Optional getGroupMigrationIssue(String groupId, Integer migrationId, Integer issueId) throws IOException;

    /**
     * Returns a list migration issues.
     * @param accountId The account ID for the migration
     * @param migrationId The Canvas ID of the content migration
     * @return List of migration issues
     * @throws IOException When there is an error communicating with Canvas
     */
    List getAccountMigrationIssues(String accountId, Integer migrationId) throws IOException;

    /**
     * Returns a migration issue.
     * @param accountId The account ID for the migration
     * @param migrationId The Canvas ID of the content migration
     * @param issueId The Canvas ID of the migration issue
     * @return A migration issue
     * @throws IOException When there is an error communicating with Canvas
     */
    Optional getAccountMigrationIssue(String accountId, Integer migrationId, Integer issueId) throws IOException;
}