Interface GradeSystem

All Superinterfaces:
Aggregateable, Browsable, Extensible, Identifiable, OsidObject
public interface GradeSystem extends OsidObject, Aggregateable

A GradeSystem represents a grading system. The system can be based on assigned Grades or based on a numeric scale.

  • Method Details

    • isBasedOnGrades

      boolean isBasedOnGrades()
      Tests if the grading system is based on grades.
      Returns:
      true if the grading system is based on grades, false if the system is a numeric score
      Compliance:
      mandatory - This method must be implemented.

    • getGradeIds

      IdList getGradeIds()
      Gets the grade Ids in this system ranked from highest to lowest.
      Returns:
      the list of grades Ids
      Throws:
      IllegalStateException - isBasedOnGrades() is false
      Compliance:
      mandatory - This method must be implemented.

    • getGrades

      GradeList getGrades() throws OperationFailedException
      Gets the grades in this system ranked from highest to lowest.
      Returns:
      the list of grades
      Throws:
      IllegalStateException - isBasedOnGrades() is false
      OperationFailedException - unable to complete request
      Compliance:
      mandatory - This method must be implemented.

    • getLowestNumericScore

      BigDecimal getLowestNumericScore()
      Gets the lowest number in a numeric grading system.
      Returns:
      the lowest number
      Throws:
      IllegalStateException - isBasedOnGrades() is true
      Compliance:
      mandatory - This method must be implemented.

    • getNumericScoreIncrement

      BigDecimal getNumericScoreIncrement()
      Gets the incremental step.
      Returns:
      the increment
      Throws:
      IllegalStateException - isBasedOnGrades() is true
      Compliance:
      mandatory - This method must be implemented.

    • getHighestNumericScore

      BigDecimal getHighestNumericScore()
      Gets the highest number in a numeric grading system.
      Returns:
      the highest number
      Throws:
      IllegalStateException - isBasedOnGrades() is true
      Compliance:
      mandatory - This method must be implemented.

    • getGradeSystemRecord

      GradeSystemRecord getGradeSystemRecord(Type gradeSystemRecordType) throws OperationFailedException
      Gets the grade system record corresponding to the given GradeSystem record Type . This method is used to retrieve an object implementing the requested record. The gradeSystemRecordType may be the Type returned in getRecordTypes() or any of its parents in a Type hierarchy where hasRecordType(gradeSystemRecordType) is true .
      Parameters:
      gradeSystemRecordType - the type of the record to retrieve
      Returns:
      the grade system record
      Throws:
      NullArgumentException - gradeSystemRecordType is null
      OperationFailedException - unable to complete request
      UnsupportedException - hasRecordType(gradeSystemRecordType) is false
      Compliance:
      mandatory - This method must be implemented.