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:

org.sakaiproject.entity.api.EntityProducer, org.sakaiproject.service.gradebook.shared.GradebookService, org.springframework.beans.factory.InitializingBean

public class GradebookServiceHibernateImpl
extends BaseHibernateManager
implements org.sakaiproject.service.gradebook.shared.GradebookService

A Hibernate implementation of GradebookService.

Nested Class Summary

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

org.sakaiproject.service.gradebook.shared.GradebookService.PointsPossibleValidation

Field Summary

Fields

Modifier and Type	Field	Description
protected org.sakaiproject.component.api.ServerConfigurationService	serverConfigService
protected org.sakaiproject.site.api.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, org.sakaiproject.service.gradebook.shared.Assignment assignmentDefinition)
void	applyDropScores(Collection<org.sakaiproject.tool.gradebook.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<org.sakaiproject.service.gradebook.shared.CategoryScoreData>	calculateCategoryScore(Long gradebookId, String studentUuid, Long categoryId, boolean includeNonReleasedItems, int categoryType, Boolean equalWeightAssignments)
Optional<org.sakaiproject.service.gradebook.shared.CategoryScoreData>	calculateCategoryScore(Object gradebook, String studentUuid, org.sakaiproject.service.gradebook.shared.CategoryDefinition category, List<org.sakaiproject.service.gradebook.shared.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
org.sakaiproject.service.gradebook.shared.Assignment	getAssignment(String gradebookUid, Long assignmentId)
org.sakaiproject.service.gradebook.shared.Assignment	getAssignment(String gradebookUid, String assignmentName)	Deprecated.
org.sakaiproject.service.gradebook.shared.Assignment	getAssignmentByID(Long gradeableObjectID)	Method to retrieve Assignment by ID.
org.sakaiproject.service.gradebook.shared.Assignment	getAssignmentByNameOrId(String gradebookUid, String assignmentName)
List	getAssignments(Long gradebookId, org.sakaiproject.service.gradebook.shared.SortType sortBy, boolean ascending)	Get a list of assignments, sorted
List<org.sakaiproject.service.gradebook.shared.Assignment>	getAssignments(String gradebookUid)
List<org.sakaiproject.service.gradebook.shared.Assignment>	getAssignments(String gradebookUid, org.sakaiproject.service.gradebook.shared.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)
org.sakaiproject.tool.gradebook.facades.Authz	getAuthz()
String	getAverageCourseGrade(String gradebookUid)	Retrieves the calculated average course grade.
List<org.sakaiproject.service.gradebook.shared.CategoryDefinition>	getCategoryDefinitions(String gradebookUid)
protected List<org.sakaiproject.tool.gradebook.GradebookAssignment>	getCountedAssignments(org.hibernate.Session session, Long gradebookId)
org.sakaiproject.tool.gradebook.CourseGrade	getCourseGrade(Long gradebookId)
org.sakaiproject.service.gradebook.shared.CourseGrade	getCourseGradeForStudent(String gradebookUid, String userUuid)
Map<String,org.sakaiproject.service.gradebook.shared.CourseGrade>	getCourseGradeForStudents(String gradebookUid, List<String> userUuids)
Map<String,org.sakaiproject.service.gradebook.shared.CourseGrade>	getCourseGradeForStudents(String gradebookUid, List<String> userUuids, Map<String,Double> gradeMap)
Map	getEnteredCourseGrade(String gradebookUid)
Optional<String>	getEntityUrl(org.sakaiproject.entity.api.Reference ref, org.sakaiproject.entity.api.Entity.UrlType urlType)
org.sakaiproject.service.gradebook.shared.Assignment	getExternalAssignment(String gradebookUid, String externalId)
org.sakaiproject.tool.gradebook.Gradebook	getGradebook(Long id)	Internal method to get a gradebook based on its id.
Set	getGradebookGradeMappings(Long gradebookId)
Set	getGradebookGradeMappings(String gradebookUid)
org.sakaiproject.service.gradebook.shared.GradebookInformation	getGradebookInformation(String gradebookUid)
org.sakaiproject.service.gradebook.shared.GradebookPermissionService	getGradebookPermissionService()
org.sakaiproject.service.gradebook.shared.GradeDefinition	getGradeDefinitionForStudentForItem(String gradebookUid, Long assignmentId, String studentUid)
int	getGradeEntryType(String gradebookUid)
protected Map<String,List<org.sakaiproject.tool.gradebook.AssignmentGradeRecord>>	getGradeRecordMapForStudents(Long gradebookId, Collection<String> studentUids)
List<org.sakaiproject.service.gradebook.shared.GradeDefinition>	getGradesForStudentsForItem(String gradebookUid, Long gradableObjectId, List<String> studentIds)
Map<Long,List<org.sakaiproject.service.gradebook.shared.GradeDefinition>>	getGradesWithoutCommentsForStudentsForItems(String gradebookUid, List<Long> gradableObjectIds, List<String> studentIds)
String	getGradeViewFunctionForUserForStudentForItem(String gradebookUid, Long itemId, String studentUid)
List<org.sakaiproject.tool.gradebook.GradingEvent>	getGradingEvents(String studentId, long assignmentId)
List<org.sakaiproject.tool.gradebook.GradingEvent>	getGradingEvents(List<Long> assignmentIds, Date since)	Return the grade changes made since a given time
String	getLowestPossibleGradeForGbItem(String gradebookUid, Long gradebookItemId)
List	getPointsEarnedCourseGradeRecords(org.sakaiproject.tool.gradebook.CourseGrade courseGrade, Collection studentUids)
org.sakaiproject.site.api.SiteService	getSiteService()
List<org.sakaiproject.service.gradebook.shared.Assignment>	getViewableAssignmentsForCurrentUser(String gradebookUid)
List<org.sakaiproject.service.gradebook.shared.Assignment>	getViewableAssignmentsForCurrentUser(String gradebookUid, org.sakaiproject.service.gradebook.shared.SortType sortBy)
List<org.sakaiproject.section.api.coursemanagement.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)
org.sakaiproject.service.gradebook.shared.GradebookService.PointsPossibleValidation	isPointsPossibleValid(String gradebookUid, org.sakaiproject.service.gradebook.shared.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, org.sakaiproject.entity.api.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<org.sakaiproject.service.gradebook.shared.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(org.sakaiproject.tool.gradebook.facades.Authz authz)
void	setGradebookPermissionService(org.sakaiproject.service.gradebook.shared.GradebookPermissionService gradebookPermissionService)
void	setSiteService(org.sakaiproject.site.api.SiteService siteService)
Map<String,String>	transferGradebook(org.sakaiproject.service.gradebook.shared.GradebookInformation gradebookInformation, List<org.sakaiproject.service.gradebook.shared.Assignment> assignments, String toGradebookUid, String fromContext)
void	updateAssignment(String gradebookUid, Long assignmentId, org.sakaiproject.service.gradebook.shared.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, org.sakaiproject.service.gradebook.shared.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 org.sakaiproject.site.api.SiteService siteService

serverConfigService

protected org.sakaiproject.component.api.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 org.sakaiproject.service.gradebook.shared.GradebookService

getEntityUrl

public Optional<String> getEntityUrl(org.sakaiproject.entity.api.Reference ref,
                                     org.sakaiproject.entity.api.Entity.UrlType urlType)

Specified by:

getEntityUrl in interface org.sakaiproject.entity.api.EntityProducer

parseEntityReference

public boolean parseEntityReference(String stringReference,
                                    org.sakaiproject.entity.api.Reference reference)

Specified by:

parseEntityReference in interface org.sakaiproject.entity.api.EntityProducer

isUserAbleToGradeItemForStudent

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

Specified by:

isUserAbleToGradeItemForStudent in interface org.sakaiproject.service.gradebook.shared.GradebookService

isUserAbleToViewItemForStudent

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

Specified by:

isUserAbleToViewItemForStudent in interface org.sakaiproject.service.gradebook.shared.GradebookService

getGradeViewFunctionForUserForStudentForItem

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

Specified by:

getGradeViewFunctionForUserForStudentForItem in interface org.sakaiproject.service.gradebook.shared.GradebookService

getAssignments

public List<org.sakaiproject.service.gradebook.shared.Assignment> getAssignments(String gradebookUid)
                                                                          throws org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

Specified by:

getAssignments in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

getAssignments

public List<org.sakaiproject.service.gradebook.shared.Assignment> getAssignments(String gradebookUid,
                                                                                 org.sakaiproject.service.gradebook.shared.SortType sortBy)
                                                                          throws org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

Specified by:

getAssignments in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

getAssignment

public org.sakaiproject.service.gradebook.shared.Assignment getAssignment(String gradebookUid,
                                                                          Long assignmentId)
                                                                   throws org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

Specified by:

getAssignment in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

getAssignmentByID

public org.sakaiproject.service.gradebook.shared.Assignment getAssignmentByID(Long gradeableObjectID)
                                                                       throws org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

Method to retrieve Assignment by ID.

Specified by:

getAssignmentByID in interface org.sakaiproject.service.gradebook.shared.GradebookService

Parameters:

gradeableObjectID -

Returns:

Throws:

org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

getAssignment

@Deprecated
public org.sakaiproject.service.gradebook.shared.Assignment getAssignment(String gradebookUid,
                                                                          String assignmentName)
                                                                   throws org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

Deprecated.

Specified by:

getAssignment in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

getExternalAssignment

public org.sakaiproject.service.gradebook.shared.Assignment getExternalAssignment(String gradebookUid,
                                                                                  String externalId)
                                                                           throws org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

Specified by:

getExternalAssignment in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

getAssignmentByNameOrId

public org.sakaiproject.service.gradebook.shared.Assignment getAssignmentByNameOrId(String gradebookUid,
                                                                                    String assignmentName)
                                                                             throws org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

Specified by:

getAssignmentByNameOrId in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

getGradeDefinitionForStudentForItem

public org.sakaiproject.service.gradebook.shared.GradeDefinition getGradeDefinitionForStudentForItem(String gradebookUid,
                                                                                                     Long assignmentId,
                                                                                                     String studentUid)

Specified by:

getGradeDefinitionForStudentForItem in interface org.sakaiproject.service.gradebook.shared.GradebookService

getGradebookInformation

public org.sakaiproject.service.gradebook.shared.GradebookInformation getGradebookInformation(String gradebookUid)

Specified by:

getGradebookInformation in interface org.sakaiproject.service.gradebook.shared.GradebookService

transferGradebook

public Map<String,String> transferGradebook(org.sakaiproject.service.gradebook.shared.GradebookInformation gradebookInformation,
                                                  List<org.sakaiproject.service.gradebook.shared.Assignment> assignments,
                                                  String toGradebookUid,
                                                  String fromContext)

Specified by:

transferGradebook in interface org.sakaiproject.service.gradebook.shared.GradebookService

removeAssignment

public void removeAssignment(Long assignmentId)
                      throws org.sakaiproject.service.gradebook.shared.StaleObjectModificationException

Specified by:

removeAssignment in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.StaleObjectModificationException

addAssignment

public Long addAssignment(String gradebookUid,
                          org.sakaiproject.service.gradebook.shared.Assignment assignmentDefinition)

Specified by:

addAssignment in interface org.sakaiproject.service.gradebook.shared.GradebookService

updateAssignment

public void updateAssignment(String gradebookUid,
                             Long assignmentId,
                             org.sakaiproject.service.gradebook.shared.Assignment assignmentDefinition)

Specified by:

updateAssignment in interface org.sakaiproject.service.gradebook.shared.GradebookService

getCourseGrade

public org.sakaiproject.tool.gradebook.CourseGrade getCourseGrade(Long gradebookId)

Overrides:

getCourseGrade in class BaseHibernateManager

getPointsEarnedCourseGradeRecords

public List getPointsEarnedCourseGradeRecords(org.sakaiproject.tool.gradebook.CourseGrade courseGrade,
                                              Collection studentUids)

getGradebook

public org.sakaiproject.tool.gradebook.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 org.sakaiproject.service.gradebook.shared.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,
                           org.sakaiproject.service.gradebook.shared.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<org.sakaiproject.service.gradebook.shared.Assignment> getViewableAssignmentsForCurrentUser(String gradebookUid)
                                                                                                throws org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

Specified by:

getViewableAssignmentsForCurrentUser in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

getViewableAssignmentsForCurrentUser

public List<org.sakaiproject.service.gradebook.shared.Assignment> getViewableAssignmentsForCurrentUser(String gradebookUid,
                                                                                                       org.sakaiproject.service.gradebook.shared.SortType sortBy)
                                                                                                throws org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

Specified by:

getViewableAssignmentsForCurrentUser in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

getViewableStudentsForItemForCurrentUser

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

Specified by:

getViewableStudentsForItemForCurrentUser in interface org.sakaiproject.service.gradebook.shared.GradebookService

getViewableStudentsForItemForUser

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

Specified by:

getViewableStudentsForItemForUser in interface org.sakaiproject.service.gradebook.shared.GradebookService

isGradableObjectDefined

public boolean isGradableObjectDefined(Long gradableObjectId)

Specified by:

isGradableObjectDefined in interface org.sakaiproject.service.gradebook.shared.GradebookService

getViewableSectionUuidToNameMap

public Map getViewableSectionUuidToNameMap(String gradebookUid)

Specified by:

getViewableSectionUuidToNameMap in interface org.sakaiproject.service.gradebook.shared.GradebookService

currentUserHasGradeAllPerm

public boolean currentUserHasGradeAllPerm(String gradebookUid)

Specified by:

currentUserHasGradeAllPerm in interface org.sakaiproject.service.gradebook.shared.GradebookService

isUserAllowedToGradeAll

public boolean isUserAllowedToGradeAll(String gradebookUid,
                                       String userUid)

Specified by:

isUserAllowedToGradeAll in interface org.sakaiproject.service.gradebook.shared.GradebookService

currentUserHasGradingPerm

public boolean currentUserHasGradingPerm(String gradebookUid)

Specified by:

currentUserHasGradingPerm in interface org.sakaiproject.service.gradebook.shared.GradebookService

isUserAllowedToGrade

public boolean isUserAllowedToGrade(String gradebookUid,
                                    String userUid)

Specified by:

isUserAllowedToGrade in interface org.sakaiproject.service.gradebook.shared.GradebookService

currentUserHasEditPerm

public boolean currentUserHasEditPerm(String gradebookUid)

Specified by:

currentUserHasEditPerm in interface org.sakaiproject.service.gradebook.shared.GradebookService

currentUserHasViewOwnGradesPerm

public boolean currentUserHasViewOwnGradesPerm(String gradebookUid)

Specified by:

currentUserHasViewOwnGradesPerm in interface org.sakaiproject.service.gradebook.shared.GradebookService

currentUserHasViewStudentNumbersPerm

public boolean currentUserHasViewStudentNumbersPerm(String gradebookUid)

Specified by:

currentUserHasViewStudentNumbersPerm in interface org.sakaiproject.service.gradebook.shared.GradebookService

getGradesForStudentsForItem

public List<org.sakaiproject.service.gradebook.shared.GradeDefinition> getGradesForStudentsForItem(String gradebookUid,
                                                                                                   Long gradableObjectId,
                                                                                                   List<String> studentIds)

Specified by:

getGradesForStudentsForItem in interface org.sakaiproject.service.gradebook.shared.GradebookService

getGradesWithoutCommentsForStudentsForItems

public Map<Long,List<org.sakaiproject.service.gradebook.shared.GradeDefinition>> getGradesWithoutCommentsForStudentsForItems(String gradebookUid,
                                                                                                                                   List<Long> gradableObjectIds,
                                                                                                                                   List<String> studentIds)

Specified by:

getGradesWithoutCommentsForStudentsForItems in interface org.sakaiproject.service.gradebook.shared.GradebookService

isGradeValid

public boolean isGradeValid(String gradebookUuid,
                            String grade)

Specified by:

isGradeValid in interface org.sakaiproject.service.gradebook.shared.GradebookService

isValidNumericGrade

public boolean isValidNumericGrade(String grade)

Specified by:

isValidNumericGrade in interface org.sakaiproject.service.gradebook.shared.GradebookService

identifyStudentsWithInvalidGrades

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

Specified by:

identifyStudentsWithInvalidGrades in interface org.sakaiproject.service.gradebook.shared.GradebookService

saveGradeAndCommentForStudent

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

Specified by:

saveGradeAndCommentForStudent in interface org.sakaiproject.service.gradebook.shared.GradebookService

saveGradeAndExcuseForStudent

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

Specified by:

saveGradeAndExcuseForStudent in interface org.sakaiproject.service.gradebook.shared.GradebookService

saveGradesAndComments

public void saveGradesAndComments(String gradebookUid,
                                  Long gradableObjectId,
                                  List<org.sakaiproject.service.gradebook.shared.GradeDefinition> gradeDefList)

Specified by:

saveGradesAndComments in interface org.sakaiproject.service.gradebook.shared.GradebookService

getGradeEntryType

public int getGradeEntryType(String gradebookUid)

Specified by:

getGradeEntryType in interface org.sakaiproject.service.gradebook.shared.GradebookService

getEnteredCourseGrade

public Map getEnteredCourseGrade(String gradebookUid)

Specified by:

getEnteredCourseGrade in interface org.sakaiproject.service.gradebook.shared.GradebookService

getAssignmentScoreString

public String getAssignmentScoreString(String gradebookUid,
                                       Long assignmentId,
                                       String studentUid)
                                throws org.sakaiproject.service.gradebook.shared.GradebookNotFoundException,
                                       org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

Specified by:

getAssignmentScoreString in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

getAssignmentScoreString

public String getAssignmentScoreString(String gradebookUid,
                                       String assignmentName,
                                       String studentUid)
                                throws org.sakaiproject.service.gradebook.shared.GradebookNotFoundException,
                                       org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

Specified by:

getAssignmentScoreString in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

getAssignmentScoreStringByNameOrId

public String getAssignmentScoreStringByNameOrId(String gradebookUid,
                                                 String assignmentName,
                                                 String studentUid)
                                          throws org.sakaiproject.service.gradebook.shared.GradebookNotFoundException,
                                                 org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

Specified by:

getAssignmentScoreStringByNameOrId in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

setAssignmentScoreString

public void setAssignmentScoreString(String gradebookUid,
                                     Long assignmentId,
                                     String studentUid,
                                     String score,
                                     String clientServiceDescription)
                              throws org.sakaiproject.service.gradebook.shared.GradebookNotFoundException,
                                     org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

Specified by:

setAssignmentScoreString in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

setAssignmentScoreString

public void setAssignmentScoreString(String gradebookUid,
                                     String assignmentName,
                                     String studentUid,
                                     String score,
                                     String clientServiceDescription)
                              throws org.sakaiproject.service.gradebook.shared.GradebookNotFoundException,
                                     org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

Specified by:

setAssignmentScoreString in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

org.sakaiproject.service.gradebook.shared.AssessmentNotFoundException

finalizeGrades

public void finalizeGrades(String gradebookUid)
                    throws org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

Specified by:

finalizeGrades in interface org.sakaiproject.service.gradebook.shared.GradebookService

Throws:

org.sakaiproject.service.gradebook.shared.GradebookNotFoundException

getLowestPossibleGradeForGbItem

public String getLowestPossibleGradeForGbItem(String gradebookUid,
                                              Long gradebookItemId)

Specified by:

getLowestPossibleGradeForGbItem in interface org.sakaiproject.service.gradebook.shared.GradebookService

getCategoryDefinitions

public List<org.sakaiproject.service.gradebook.shared.CategoryDefinition> getCategoryDefinitions(String gradebookUid)

Specified by:

getCategoryDefinitions in interface org.sakaiproject.service.gradebook.shared.GradebookService

getGradeRecordMapForStudents

protected Map<String,List<org.sakaiproject.tool.gradebook.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<org.sakaiproject.tool.gradebook.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<org.sakaiproject.tool.gradebook.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 org.sakaiproject.service.gradebook.shared.GradebookService.PointsPossibleValidation isPointsPossibleValid(String gradebookUid,
                                                                                                                 org.sakaiproject.service.gradebook.shared.Assignment gradebookItem,
                                                                                                                 Double pointsPossible)

Specified by:

isPointsPossibleValid in interface org.sakaiproject.service.gradebook.shared.GradebookService

getAverageCourseGrade

public String getAverageCourseGrade(String gradebookUid)

Retrieves the calculated average course grade.

Specified by:

getAverageCourseGrade in interface org.sakaiproject.service.gradebook.shared.GradebookService

updateAssignmentOrder

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

Updates the order of an assignment

Specified by:

updateAssignmentOrder in interface org.sakaiproject.service.gradebook.shared.GradebookService

getGradingEvents

public List<org.sakaiproject.tool.gradebook.GradingEvent> getGradingEvents(String studentId,
                                                                           long assignmentId)

Specified by:

getGradingEvents in interface org.sakaiproject.service.gradebook.shared.GradebookService

calculateCategoryScore

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

Specified by:

calculateCategoryScore in interface org.sakaiproject.service.gradebook.shared.GradebookService

calculateCategoryScore

public Optional<org.sakaiproject.service.gradebook.shared.CategoryScoreData> calculateCategoryScore(Long gradebookId,
                                                                                                    String studentUuid,
                                                                                                    Long categoryId,
                                                                                                    boolean includeNonReleasedItems,
                                                                                                    int categoryType,
                                                                                                    Boolean equalWeightAssignments)

Specified by:

calculateCategoryScore in interface org.sakaiproject.service.gradebook.shared.GradebookService

getCourseGradeForStudent

public org.sakaiproject.service.gradebook.shared.CourseGrade getCourseGradeForStudent(String gradebookUid,
                                                                                      String userUuid)

Specified by:

getCourseGradeForStudent in interface org.sakaiproject.service.gradebook.shared.GradebookService

getCourseGradeForStudents

public Map<String,org.sakaiproject.service.gradebook.shared.CourseGrade> getCourseGradeForStudents(String gradebookUid,
                                                                                                         List<String> userUuids)

Specified by:

getCourseGradeForStudents in interface org.sakaiproject.service.gradebook.shared.GradebookService

getCourseGradeForStudents

public Map<String,org.sakaiproject.service.gradebook.shared.CourseGrade> getCourseGradeForStudents(String gradebookUid,
                                                                                                         List<String> userUuids,
                                                                                                         Map<String,Double> gradeMap)

Specified by:

getCourseGradeForStudents in interface org.sakaiproject.service.gradebook.shared.GradebookService

getViewableSections

public List<org.sakaiproject.section.api.coursemanagement.CourseSection> getViewableSections(String gradebookUid)

Specified by:

getViewableSections in interface org.sakaiproject.service.gradebook.shared.GradebookService

updateGradebookSettings

public void updateGradebookSettings(String gradebookUid,
                                    org.sakaiproject.service.gradebook.shared.GradebookInformation gbInfo)

Specified by:

updateGradebookSettings in interface org.sakaiproject.service.gradebook.shared.GradebookService

getAuthz

public org.sakaiproject.tool.gradebook.facades.Authz getAuthz()

setAuthz

public void setAuthz(org.sakaiproject.tool.gradebook.facades.Authz authz)

getGradebookPermissionService

public org.sakaiproject.service.gradebook.shared.GradebookPermissionService getGradebookPermissionService()

setGradebookPermissionService

public void setGradebookPermissionService(org.sakaiproject.service.gradebook.shared.GradebookPermissionService gradebookPermissionService)

setSiteService

public void setSiteService(org.sakaiproject.site.api.SiteService siteService)

getSiteService

public org.sakaiproject.site.api.SiteService getSiteService()

getGradebookGradeMappings

public Set getGradebookGradeMappings(Long gradebookId)

Specified by:

getGradebookGradeMappings in interface org.sakaiproject.service.gradebook.shared.GradebookService

getGradebookGradeMappings

public Set getGradebookGradeMappings(String gradebookUid)

Specified by:

getGradebookGradeMappings in interface org.sakaiproject.service.gradebook.shared.GradebookService

updateCourseGradeForStudent

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

Specified by:

updateCourseGradeForStudent in interface org.sakaiproject.service.gradebook.shared.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 org.sakaiproject.service.gradebook.shared.GradebookService

getGradingEvents

public List<org.sakaiproject.tool.gradebook.GradingEvent> getGradingEvents(List<Long> assignmentIds,
                                                                           Date since)

Return the grade changes made since a given time

Specified by:

getGradingEvents in interface org.sakaiproject.service.gradebook.shared.GradebookService

Parameters:

assignmentIds - ids of assignments to check

since - timestamp from which to check for changes

Returns:

set of changes made