Package org.sakaiproject.component.gradebook

Class GradebookServiceHibernateImpl

java.lang.Object

org.springframework.dao.support.DaoSupport

org.springframework.orm.hibernate5.support.HibernateDaoSupport

org.sakaiproject.component.gradebook.BaseHibernateManager

org.sakaiproject.component.gradebook.GradebookServiceHibernateImpl

All Implemented Interfaces:

EntityProducer, GradebookService, org.springframework.beans.factory.InitializingBean

public class GradebookServiceHibernateImpl
extends BaseHibernateManager
implements GradebookService

A Hibernate implementation of GradebookService.

Nested Class Summary

Nested classes/interfaces inherited from interface org.sakaiproject.service.gradebook.shared.GradebookService

GradebookService.PointsPossibleValidation

Field Summary

Fields

Modifier and Type	Field	Description
protected ServerConfigurationService	serverConfigService
protected SiteService	siteService

Fields inherited from class org.sakaiproject.component.gradebook.BaseHibernateManager

authn, eventTrackingService, externalAssessmentService, propertiesMap, sectionAwareness, serverConfigurationService

Fields inherited from class org.springframework.dao.support.DaoSupport

logger

Fields inherited from interface org.sakaiproject.service.gradebook.shared.GradebookService

CATEGORY_TYPE_NO_CATEGORY, CATEGORY_TYPE_ONLY_CATEGORY, CATEGORY_TYPE_WEIGHTED_CATEGORY, enableLetterGradeString, GRADE_TYPE_LETTER, GRADE_TYPE_PERCENTAGE, GRADE_TYPE_POINTS, gradePermission, INVALID_CHARS_AT_START_OF_GB_ITEM_NAME, lettergradeComparator, MATH_CONTEXT, noPermission, REFERENCE_ROOT, SAKAI_GBASSIGNMENT, validLetterGrade, viewPermission

Constructor Summary

Constructors

Constructor	Description
GradebookServiceHibernateImpl()

Method Summary

Modifier and Type	Method	Description
Long	addAssignment(String gradebookUid, Assignment assignmentDefinition)
void	applyDropScores(Collection<AssignmentGradeRecord> gradeRecords, int categoryType)	set the droppedFromGrade attribute of each of the n highest and the n lowest scores of a student based on the assignment's category
Optional<CategoryScoreData>	calculateCategoryScore(Long gradebookId, String studentUuid, Long categoryId, boolean includeNonReleasedItems, int categoryType, Boolean equalWeightAssignments)
Optional<CategoryScoreData>	calculateCategoryScore(Object gradebook, String studentUuid, CategoryDefinition category, List<Assignment> categoryAssignments, Map<Long,String> gradeMap, boolean includeNonReleasedItems)
boolean	checkStudentsNotSubmitted(String gradebookUid)
boolean	currentUserHasEditPerm(String gradebookUid)
boolean	currentUserHasGradeAllPerm(String gradebookUid)
boolean	currentUserHasGradingPerm(String gradebookUid)
boolean	currentUserHasViewOwnGradesPerm(String gradebookUid)
boolean	currentUserHasViewStudentNumbersPerm(String gradebookUid)
void	finalizeGrades(String gradebookUid)
List	getAllAssignmentGradeRecords(Long gradebookId, Collection studentUids)	Get all assignment grade records for the given students
Assignment	getAssignment(String gradebookUid, Long assignmentId)
Assignment	getAssignment(String gradebookUid, String assignmentName)	Deprecated.
Assignment	getAssignmentByID(Long gradeableObjectID)	Method to retrieve Assignment by ID.
Assignment	getAssignmentByNameOrId(String gradebookUid, String assignmentName)
List	getAssignments(Long gradebookId, SortType sortBy, boolean ascending)	Get a list of assignments, sorted
List<Assignment>	getAssignments(String gradebookUid)
List<Assignment>	getAssignments(String gradebookUid, SortType sortBy)
String	getAssignmentScoreString(String gradebookUid, Long assignmentId, String studentUid)
String	getAssignmentScoreString(String gradebookUid, String assignmentName, String studentUid)
String	getAssignmentScoreStringByNameOrId(String gradebookUid, String assignmentName, String studentUid)
Authz	getAuthz()
String	getAverageCourseGrade(String gradebookUid)	Retrieves the calculated average course grade.
List<CategoryDefinition>	getCategoryDefinitions(String gradebookUid)
protected List<GradebookAssignment>	getCountedAssignments(org.hibernate.Session session, Long gradebookId)
CourseGrade	getCourseGrade(Long gradebookId)
CourseGrade	getCourseGradeForStudent(String gradebookUid, String userUuid)
Map<String,CourseGrade>	getCourseGradeForStudents(String gradebookUid, List<String> userUuids)
Map<String,CourseGrade>	getCourseGradeForStudents(String gradebookUid, List<String> userUuids, Map<String,Double> gradeMap)
Map	getEnteredCourseGrade(String gradebookUid)
Optional<String>	getEntityUrl(Reference ref, Entity.UrlType urlType)
Assignment	getExternalAssignment(String gradebookUid, String externalId)
Gradebook	getGradebook(Long id)	Internal method to get a gradebook based on its id.
Set	getGradebookGradeMappings(Long gradebookId)
Set	getGradebookGradeMappings(String gradebookUid)
GradebookInformation	getGradebookInformation(String gradebookUid)
GradebookPermissionService	getGradebookPermissionService()
GradeDefinition	getGradeDefinitionForStudentForItem(String gradebookUid, Long assignmentId, String studentUid)
int	getGradeEntryType(String gradebookUid)
protected Map<String,List<AssignmentGradeRecord>>	getGradeRecordMapForStudents(Long gradebookId, Collection<String> studentUids)
List<GradeDefinition>	getGradesForStudentsForItem(String gradebookUid, Long gradableObjectId, List<String> studentIds)
Map<Long,List<GradeDefinition>>	getGradesWithoutCommentsForStudentsForItems(String gradebookUid, List<Long> gradableObjectIds, List<String> studentIds)
String	getGradeViewFunctionForUserForStudentForItem(String gradebookUid, Long itemId, String studentUid)
List<GradingEvent>	getGradingEvents(String studentId, long assignmentId)
List<GradingEvent>	getGradingEvents(List<Long> assignmentIds, Date since)	Return the grade changes made since a given time
String	getLowestPossibleGradeForGbItem(String gradebookUid, Long gradebookItemId)
List	getPointsEarnedCourseGradeRecords(CourseGrade courseGrade, Collection studentUids)
SiteService	getSiteService()
List<Assignment>	getViewableAssignmentsForCurrentUser(String gradebookUid)
List<Assignment>	getViewableAssignmentsForCurrentUser(String gradebookUid, SortType sortBy)
List<CourseSection>	getViewableSections(String gradebookUid)
Map	getViewableSectionUuidToNameMap(String gradebookUid)
Map<String,String>	getViewableStudentsForItemForCurrentUser(String gradebookUid, Long gradableObjectId)
Map<String,String>	getViewableStudentsForItemForUser(String userUid, String gradebookUid, Long gradableObjectId)
List<String>	identifyStudentsWithInvalidGrades(String gradebookUid, Map<String,String> studentIdToGradeMap)
void	init()
boolean	isAssignmentDefined(String gradebookUid, String assignmentName)
boolean	isGradableObjectDefined(Long gradableObjectId)
boolean	isGradeValid(String gradebookUuid, String grade)
GradebookService.PointsPossibleValidation	isPointsPossibleValid(String gradebookUid, Assignment gradebookItem, Double pointsPossible)
boolean	isUserAbleToGradeItemForStudent(String gradebookUid, Long itemId, String studentUid)
boolean	isUserAbleToViewItemForStudent(String gradebookUid, Long itemId, String studentUid)
boolean	isUserAllowedToGrade(String gradebookUid, String userUid)
boolean	isUserAllowedToGradeAll(String gradebookUid, String userUid)
boolean	isValidNumericGrade(String grade)
boolean	parseEntityReference(String stringReference, Reference reference)
void	removeAssignment(Long assignmentId)
void	saveGradeAndCommentForStudent(String gradebookUid, Long gradableObjectId, String studentUid, String grade, String comment)
void	saveGradeAndExcuseForStudent(String gradebookUid, Long gradableObjectId, String studentUid, String grade, boolean excuse)
void	saveGradesAndComments(String gradebookUid, Long gradableObjectId, List<GradeDefinition> gradeDefList)
void	setAssignmentScoreString(String gradebookUid, Long assignmentId, String studentUid, String score, String clientServiceDescription)
void	setAssignmentScoreString(String gradebookUid, String assignmentName, String studentUid, String score, String clientServiceDescription)
void	setAuthz(Authz authz)
void	setGradebookPermissionService(GradebookPermissionService gradebookPermissionService)
void	setSiteService(SiteService siteService)
Map<String,String>	transferGradebook(GradebookInformation gradebookInformation, List<Assignment> assignments, String toGradebookUid, String fromContext)
void	updateAssignment(String gradebookUid, Long assignmentId, Assignment assignmentDefinition)
void	updateAssignmentCategorizedOrder(String gradebookUid, Long categoryId, Long assignmentId, Integer order)	Updates the categorized order of an assignment
void	updateAssignmentOrder(String gradebookUid, Long assignmentId, Integer order)	Updates the order of an assignment
void	updateCourseGradeForStudent(String gradebookUid, String studentUuid, String grade, String gradeScale)
void	updateGradebookSettings(String gradebookUid, GradebookInformation gbInfo)

Methods inherited from class org.sakaiproject.component.gradebook.BaseHibernateManager

addPermission, assignmentNameExists, calculateEquivalentPercent, calculateEquivalentPointValueForPercent, convertPointsToLetterGrade, convertPointsToPercentage, createAssignment, createAssignmentForCategory, createCategory, createCategory, createDefaultLetterGradePercentMapping, createOrUpdateDefaultLetterGradePercentMapping, createUngradedAssignment, createUngradedAssignmentForCategory, deletePermission, filterGradeRecordsByStudents, finalizeNullGradeRecords, getAllStudentUids, getAssignment, getAssignmentById, getAssignmentGradeRecord, getAssignments, getAssignmentScoreComment, getAssignmentsForCategory, getAssignmentWithoutStats, getAssignmentWithoutStats, getAuthn, getCategories, getCategoriesWithAssignments, getCategory, getComments, getCountedStudentGradeRecords, getCourseGradeOverrides, getCourseGradeRecord, getDefaultLetterGradePercentMapping, getEventTrackingService, getGradebook, getGradebookExternalAssessmentService, getGradebookUid, getIsAssignmentExcused, getLetterGradePercentMapping, getPermissionsForGB, getPermissionsForGBForCategoryIds, getPermissionsForUser, getPermissionsForUserAnyCategory, getPermissionsForUserAnyGroup, getPermissionsForUserAnyGroupAnyCategory, getPermissionsForUserAnyGroupForCategory, getPermissionsForUserForCategory, getPermissionsForUserForGoupsAnyCategory, getPermissionsForUserForGroup, getPropertyValue, getSectionAwareness, getServerConfigurationService, getUserUid, getVisibleExternalAssignments, isAssignmentDefined, isExplicitlyEnteredCourseGradeRecords, isGradebookDefined, postEvent, removeCategory, saveNewAssignment, saveOrUpdateLetterGradePercentMapping, setAssignmentScoreComment, setAuthn, setEventTrackingService, setGradebookExternalAssessmentService, setPropertyValue, setSectionAwareness, setServerConfigurationService, studentCanView, updateAssignment, updateCategory, updateGradebook, updateGradeMapping, updatePermission, updatePermission, validateLetterGradeMapping

Methods inherited from class org.springframework.orm.hibernate5.support.HibernateDaoSupport

checkDaoConfig, createHibernateTemplate, currentSession, getHibernateTemplate, getSessionFactory, setHibernateTemplate, setSessionFactory

Methods inherited from class org.springframework.dao.support.DaoSupport

afterPropertiesSet, initDao

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.sakaiproject.entity.api.EntityProducer

archive, getEntity, getEntityAuthzGroups, getEntityDescription, getEntityResourceProperties, getEntityUrl, getHttpAccess, getLabel, merge, willArchiveMerge

Methods inherited from interface org.sakaiproject.service.gradebook.shared.GradebookService

getAssignmentScoreComment, getCategories, getGradebook, getIsAssignmentExcused, isGradebookDefined, removeCategory, setAssignmentScoreComment

Field Detail

siteService

protected SiteService siteService

serverConfigService

protected ServerConfigurationService serverConfigService

Constructor Detail

GradebookServiceHibernateImpl

public GradebookServiceHibernateImpl()

Method Detail

init

public void init()

isAssignmentDefined

public boolean isAssignmentDefined(String gradebookUid,
                                   String assignmentName)

Specified by:

isAssignmentDefined in interface GradebookService

getEntityUrl

public Optional<String> getEntityUrl(Reference ref,
                                     Entity.UrlType urlType)

Specified by:

getEntityUrl in interface EntityProducer

parseEntityReference

public boolean parseEntityReference(String stringReference,
                                    Reference reference)

Specified by:

parseEntityReference in interface EntityProducer

isUserAbleToGradeItemForStudent

public boolean isUserAbleToGradeItemForStudent(String gradebookUid,
                                               Long itemId,
                                               String studentUid)

Specified by:

isUserAbleToGradeItemForStudent in interface GradebookService

isUserAbleToViewItemForStudent

public boolean isUserAbleToViewItemForStudent(String gradebookUid,
                                              Long itemId,
                                              String studentUid)

Specified by:

isUserAbleToViewItemForStudent in interface GradebookService

getGradeViewFunctionForUserForStudentForItem

public String getGradeViewFunctionForUserForStudentForItem(String gradebookUid,
                                                           Long itemId,
                                                           String studentUid)

Specified by:

getGradeViewFunctionForUserForStudentForItem in interface GradebookService

getAssignments

public List<Assignment> getAssignments(String gradebookUid)
                                throws GradebookNotFoundException

Specified by:

getAssignments in interface GradebookService

Throws:

GradebookNotFoundException

getAssignments

public List<Assignment> getAssignments(String gradebookUid,
                                       SortType sortBy)
                                throws GradebookNotFoundException

Specified by:

getAssignments in interface GradebookService

Throws:

GradebookNotFoundException

getAssignment

public Assignment getAssignment(String gradebookUid,
                                Long assignmentId)
                         throws AssessmentNotFoundException

Specified by:

getAssignment in interface GradebookService

Throws:

AssessmentNotFoundException

getAssignmentByID

public Assignment getAssignmentByID(Long gradeableObjectID)
                             throws AssessmentNotFoundException

Method to retrieve Assignment by ID.

Specified by:

getAssignmentByID in interface GradebookService

Parameters:

gradeableObjectID -

Returns:

Throws:

AssessmentNotFoundException

getAssignment

@Deprecated
public Assignment getAssignment(String gradebookUid,
                                String assignmentName)
                         throws AssessmentNotFoundException

Deprecated.

Specified by:

getAssignment in interface GradebookService

Throws:

AssessmentNotFoundException

getExternalAssignment

public Assignment getExternalAssignment(String gradebookUid,
                                        String externalId)
                                 throws GradebookNotFoundException

Specified by:

getExternalAssignment in interface GradebookService

Throws:

GradebookNotFoundException

getAssignmentByNameOrId

public Assignment getAssignmentByNameOrId(String gradebookUid,
                                          String assignmentName)
                                   throws AssessmentNotFoundException

Specified by:

getAssignmentByNameOrId in interface GradebookService

Throws:

AssessmentNotFoundException

getGradeDefinitionForStudentForItem

public GradeDefinition getGradeDefinitionForStudentForItem(String gradebookUid,
                                                           Long assignmentId,
                                                           String studentUid)

Specified by:

getGradeDefinitionForStudentForItem in interface GradebookService

getGradebookInformation

public GradebookInformation getGradebookInformation(String gradebookUid)

Specified by:

getGradebookInformation in interface GradebookService

transferGradebook

public Map<String,String> transferGradebook(GradebookInformation gradebookInformation,
                                                  List<Assignment> assignments,
                                                  String toGradebookUid,
                                                  String fromContext)

Specified by:

transferGradebook in interface GradebookService

removeAssignment

public void removeAssignment(Long assignmentId)
                      throws StaleObjectModificationException

Specified by:

removeAssignment in interface GradebookService

Throws:

StaleObjectModificationException

addAssignment

public Long addAssignment(String gradebookUid,
                          Assignment assignmentDefinition)

Specified by:

addAssignment in interface GradebookService

updateAssignment

public void updateAssignment(String gradebookUid,
                             Long assignmentId,
                             Assignment assignmentDefinition)

Specified by:

updateAssignment in interface GradebookService

getCourseGrade

public CourseGrade getCourseGrade(Long gradebookId)

Overrides:

getCourseGrade in class BaseHibernateManager

getPointsEarnedCourseGradeRecords

public List getPointsEarnedCourseGradeRecords(CourseGrade courseGrade,
                                              Collection studentUids)

getGradebook

public Gradebook getGradebook(Long id)

Internal method to get a gradebook based on its id.

Parameters:

id -

Returns:

NOTE: When the UI changes, this is to be turned private again

checkStudentsNotSubmitted

public boolean checkStudentsNotSubmitted(String gradebookUid)

Specified by:

checkStudentsNotSubmitted in interface GradebookService

getAllAssignmentGradeRecords

public List getAllAssignmentGradeRecords(Long gradebookId,
                                         Collection studentUids)

Get all assignment grade records for the given students

Parameters:

gradebookId -

studentUids -

Returns:

NOTE When the UI changes, this needs to be made private again

getAssignments

public List getAssignments(Long gradebookId,
                           SortType sortBy,
                           boolean ascending)

Get a list of assignments, sorted

Parameters:

gradebookId -

sortBy -

ascending -

Returns:

NOTE: When the UI changes, this needs to go back to private

getViewableAssignmentsForCurrentUser

public List<Assignment> getViewableAssignmentsForCurrentUser(String gradebookUid)
                                                      throws GradebookNotFoundException

Specified by:

getViewableAssignmentsForCurrentUser in interface GradebookService

Throws:

GradebookNotFoundException

getViewableAssignmentsForCurrentUser

public List<Assignment> getViewableAssignmentsForCurrentUser(String gradebookUid,
                                                             SortType sortBy)
                                                      throws GradebookNotFoundException

Specified by:

getViewableAssignmentsForCurrentUser in interface GradebookService

Throws:

GradebookNotFoundException

getViewableStudentsForItemForCurrentUser

public Map<String,String> getViewableStudentsForItemForCurrentUser(String gradebookUid,
                                                                         Long gradableObjectId)

Specified by:

getViewableStudentsForItemForCurrentUser in interface GradebookService

getViewableStudentsForItemForUser

public Map<String,String> getViewableStudentsForItemForUser(String userUid,
                                                                  String gradebookUid,
                                                                  Long gradableObjectId)

Specified by:

getViewableStudentsForItemForUser in interface GradebookService

isGradableObjectDefined

public boolean isGradableObjectDefined(Long gradableObjectId)

Specified by:

isGradableObjectDefined in interface GradebookService

getViewableSectionUuidToNameMap

public Map getViewableSectionUuidToNameMap(String gradebookUid)

Specified by:

getViewableSectionUuidToNameMap in interface GradebookService

currentUserHasGradeAllPerm

public boolean currentUserHasGradeAllPerm(String gradebookUid)

Specified by:

currentUserHasGradeAllPerm in interface GradebookService

isUserAllowedToGradeAll

public boolean isUserAllowedToGradeAll(String gradebookUid,
                                       String userUid)

Specified by:

isUserAllowedToGradeAll in interface GradebookService

currentUserHasGradingPerm

public boolean currentUserHasGradingPerm(String gradebookUid)

Specified by:

currentUserHasGradingPerm in interface GradebookService

isUserAllowedToGrade

public boolean isUserAllowedToGrade(String gradebookUid,
                                    String userUid)

Specified by:

isUserAllowedToGrade in interface GradebookService

currentUserHasEditPerm

public boolean currentUserHasEditPerm(String gradebookUid)

Specified by:

currentUserHasEditPerm in interface GradebookService

currentUserHasViewOwnGradesPerm

public boolean currentUserHasViewOwnGradesPerm(String gradebookUid)

Specified by:

currentUserHasViewOwnGradesPerm in interface GradebookService

currentUserHasViewStudentNumbersPerm

public boolean currentUserHasViewStudentNumbersPerm(String gradebookUid)

Specified by:

currentUserHasViewStudentNumbersPerm in interface GradebookService

getGradesForStudentsForItem

public List<GradeDefinition> getGradesForStudentsForItem(String gradebookUid,
                                                         Long gradableObjectId,
                                                         List<String> studentIds)

Specified by:

getGradesForStudentsForItem in interface GradebookService

getGradesWithoutCommentsForStudentsForItems

public Map<Long,List<GradeDefinition>> getGradesWithoutCommentsForStudentsForItems(String gradebookUid,
                                                                                         List<Long> gradableObjectIds,
                                                                                         List<String> studentIds)

Specified by:

getGradesWithoutCommentsForStudentsForItems in interface GradebookService

isGradeValid

public boolean isGradeValid(String gradebookUuid,
                            String grade)

Specified by:

isGradeValid in interface GradebookService

isValidNumericGrade

public boolean isValidNumericGrade(String grade)

Specified by:

isValidNumericGrade in interface GradebookService

identifyStudentsWithInvalidGrades

public List<String> identifyStudentsWithInvalidGrades(String gradebookUid,
                                                      Map<String,String> studentIdToGradeMap)

Specified by:

identifyStudentsWithInvalidGrades in interface GradebookService

saveGradeAndCommentForStudent

public void saveGradeAndCommentForStudent(String gradebookUid,
                                          Long gradableObjectId,
                                          String studentUid,
                                          String grade,
                                          String comment)

Specified by:

saveGradeAndCommentForStudent in interface GradebookService

saveGradeAndExcuseForStudent

public void saveGradeAndExcuseForStudent(String gradebookUid,
                                         Long gradableObjectId,
                                         String studentUid,
                                         String grade,
                                         boolean excuse)

Specified by:

saveGradeAndExcuseForStudent in interface GradebookService

saveGradesAndComments

public void saveGradesAndComments(String gradebookUid,
                                  Long gradableObjectId,
                                  List<GradeDefinition> gradeDefList)

Specified by:

saveGradesAndComments in interface GradebookService

getGradeEntryType

public int getGradeEntryType(String gradebookUid)

Specified by:

getGradeEntryType in interface GradebookService

getEnteredCourseGrade

public Map getEnteredCourseGrade(String gradebookUid)

Specified by:

getEnteredCourseGrade in interface GradebookService

getAssignmentScoreString

public String getAssignmentScoreString(String gradebookUid,
                                       Long assignmentId,
                                       String studentUid)
                                throws GradebookNotFoundException,
                                       AssessmentNotFoundException

Specified by:

getAssignmentScoreString in interface GradebookService

Throws:

GradebookNotFoundException

AssessmentNotFoundException

getAssignmentScoreString

public String getAssignmentScoreString(String gradebookUid,
                                       String assignmentName,
                                       String studentUid)
                                throws GradebookNotFoundException,
                                       AssessmentNotFoundException

Specified by:

getAssignmentScoreString in interface GradebookService

Throws:

GradebookNotFoundException

AssessmentNotFoundException

getAssignmentScoreStringByNameOrId

public String getAssignmentScoreStringByNameOrId(String gradebookUid,
                                                 String assignmentName,
                                                 String studentUid)
                                          throws GradebookNotFoundException,
                                                 AssessmentNotFoundException

Specified by:

getAssignmentScoreStringByNameOrId in interface GradebookService

Throws:

GradebookNotFoundException

AssessmentNotFoundException

setAssignmentScoreString

public void setAssignmentScoreString(String gradebookUid,
                                     Long assignmentId,
                                     String studentUid,
                                     String score,
                                     String clientServiceDescription)
                              throws GradebookNotFoundException,
                                     AssessmentNotFoundException

Specified by:

setAssignmentScoreString in interface GradebookService

Throws:

GradebookNotFoundException

AssessmentNotFoundException

setAssignmentScoreString

public void setAssignmentScoreString(String gradebookUid,
                                     String assignmentName,
                                     String studentUid,
                                     String score,
                                     String clientServiceDescription)
                              throws GradebookNotFoundException,
                                     AssessmentNotFoundException

Specified by:

setAssignmentScoreString in interface GradebookService

Throws:

GradebookNotFoundException

AssessmentNotFoundException

finalizeGrades

public void finalizeGrades(String gradebookUid)
                    throws GradebookNotFoundException

Specified by:

finalizeGrades in interface GradebookService

Throws:

GradebookNotFoundException

getLowestPossibleGradeForGbItem

public String getLowestPossibleGradeForGbItem(String gradebookUid,
                                              Long gradebookItemId)

Specified by:

getLowestPossibleGradeForGbItem in interface GradebookService

getCategoryDefinitions

public List<CategoryDefinition> getCategoryDefinitions(String gradebookUid)

Specified by:

getCategoryDefinitions in interface GradebookService

getGradeRecordMapForStudents

protected Map<String,List<AssignmentGradeRecord>> getGradeRecordMapForStudents(Long gradebookId,
                                                                                     Collection<String> studentUids)

Parameters:

gradebookId -

studentUids -

Returns:

a map of studentUid to a list of that student's AssignmentGradeRecords for the given studentUids list in the given gradebook. the grade records are all recs for assignments that are not removed and have a points possible > 0

getCountedAssignments

protected List<GradebookAssignment> getCountedAssignments(org.hibernate.Session session,
                                                          Long gradebookId)

Parameters:

session -

gradebookId -

Returns:

a list of Assignments that have not been removed, are "counted", graded, and have a points possible > 0

applyDropScores

public void applyDropScores(Collection<AssignmentGradeRecord> gradeRecords,
                            int categoryType)

set the droppedFromGrade attribute of each of the n highest and the n lowest scores of a student based on the assignment's category

Parameters:

gradeRecords - NOTE: When the UI changes, this needs to be made private again

isPointsPossibleValid

public GradebookService.PointsPossibleValidation isPointsPossibleValid(String gradebookUid,
                                                                       Assignment gradebookItem,
                                                                       Double pointsPossible)

Specified by:

isPointsPossibleValid in interface GradebookService

getAverageCourseGrade

public String getAverageCourseGrade(String gradebookUid)

Retrieves the calculated average course grade.

Specified by:

getAverageCourseGrade in interface GradebookService

updateAssignmentOrder

public void updateAssignmentOrder(String gradebookUid,
                                  Long assignmentId,
                                  Integer order)

Updates the order of an assignment

Specified by:

updateAssignmentOrder in interface GradebookService

getGradingEvents

public List<GradingEvent> getGradingEvents(String studentId,
                                           long assignmentId)

Specified by:

getGradingEvents in interface GradebookService

calculateCategoryScore

public Optional<CategoryScoreData> calculateCategoryScore(Object gradebook,
                                                          String studentUuid,
                                                          CategoryDefinition category,
                                                          List<Assignment> categoryAssignments,
                                                          Map<Long,String> gradeMap,
                                                          boolean includeNonReleasedItems)

Specified by:

calculateCategoryScore in interface GradebookService

calculateCategoryScore

public Optional<CategoryScoreData> calculateCategoryScore(Long gradebookId,
                                                          String studentUuid,
                                                          Long categoryId,
                                                          boolean includeNonReleasedItems,
                                                          int categoryType,
                                                          Boolean equalWeightAssignments)

Specified by:

calculateCategoryScore in interface GradebookService

getCourseGradeForStudent

public CourseGrade getCourseGradeForStudent(String gradebookUid,
                                            String userUuid)

Specified by:

getCourseGradeForStudent in interface GradebookService

getCourseGradeForStudents

public Map<String,CourseGrade> getCourseGradeForStudents(String gradebookUid,
                                                               List<String> userUuids)

Specified by:

getCourseGradeForStudents in interface GradebookService

getCourseGradeForStudents

public Map<String,CourseGrade> getCourseGradeForStudents(String gradebookUid,
                                                               List<String> userUuids,
                                                               Map<String,Double> gradeMap)

Specified by:

getCourseGradeForStudents in interface GradebookService

getViewableSections

public List<CourseSection> getViewableSections(String gradebookUid)

Specified by:

getViewableSections in interface GradebookService

updateGradebookSettings

public void updateGradebookSettings(String gradebookUid,
                                    GradebookInformation gbInfo)

Specified by:

updateGradebookSettings in interface GradebookService

getAuthz

public Authz getAuthz()

setAuthz

public void setAuthz(Authz authz)

getGradebookPermissionService

public GradebookPermissionService getGradebookPermissionService()

setGradebookPermissionService

public void setGradebookPermissionService(GradebookPermissionService gradebookPermissionService)

setSiteService

public void setSiteService(SiteService siteService)

getSiteService

public SiteService getSiteService()

getGradebookGradeMappings

public Set getGradebookGradeMappings(Long gradebookId)

Specified by:

getGradebookGradeMappings in interface GradebookService

getGradebookGradeMappings

public Set getGradebookGradeMappings(String gradebookUid)

Specified by:

getGradebookGradeMappings in interface GradebookService

updateCourseGradeForStudent

public void updateCourseGradeForStudent(String gradebookUid,
                                        String studentUuid,
                                        String grade,
                                        String gradeScale)

Specified by:

updateCourseGradeForStudent in interface GradebookService

updateAssignmentCategorizedOrder

public void updateAssignmentCategorizedOrder(String gradebookUid,
                                             Long categoryId,
                                             Long assignmentId,
                                             Integer order)

Updates the categorized order of an assignment

Specified by:

updateAssignmentCategorizedOrder in interface GradebookService

getGradingEvents

public List<GradingEvent> getGradingEvents(List<Long> assignmentIds,
                                           Date since)

Return the grade changes made since a given time

Specified by:

getGradingEvents in interface GradebookService

Parameters:

assignmentIds - ids of assignments to check

since - timestamp from which to check for changes

Returns:

set of changes made