org.sakaiproject.component.gradebook

Class BaseHibernateManager

java.lang.Object

org.springframework.dao.support.DaoSupport

org.springframework.orm.hibernate3.support.HibernateDaoSupport

org.sakaiproject.component.gradebook.BaseHibernateManager

All Implemented Interfaces:

org.springframework.beans.factory.InitializingBean

Direct Known Subclasses:

GradebookExternalAssessmentServiceImpl, GradebookFrameworkServiceImpl, GradebookPermissionServiceImpl, GradebookServiceHibernateImpl

public abstract class BaseHibernateManager
extends org.springframework.orm.hibernate3.support.HibernateDaoSupport

Provides methods which are shared between service business logic and application business logic, but not exposed to external callers.

Field Summary

Fields

Modifier and Type	Field and Description
protected Authn	authn
protected EventTrackingService	eventTrackingService
protected GradebookExternalAssessmentService	externalAssessmentService
static int	MAX_NUMBER_OF_SQL_PARAMETERS_IN_LIST
protected Map	propertiesMap
protected SectionAwareness	sectionAwareness
protected ServerConfigurationService	serverConfigurationService

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

logger

Constructor Summary

Constructors

Constructor and Description
BaseHibernateManager()

Method Summary

Modifier and Type	Method and Description
Long	addPermission(Long gradebookId, String userId, String function, Long categoryId, String groupId)
protected boolean	assignmentNameExists(org.hibernate.Session session, String name, Gradebook gradebook)
protected Double	calculateEquivalentPercent(Double doublePointsPossible, Double doublePointsEarned)
protected Double	calculateEquivalentPointValueForPercent(Double doublePointsPossible, Double doublePercentEarned)
protected List	convertPointsToLetterGrade(Gradebook gradebook, List studentRecordsFromDB) Converts points to letter grade for the given AssignmentGradeRecords
protected List	convertPointsToPercentage(Gradebook gradebook, List studentRecordsFromDB) Converts points to percentage for the given AssignmentGradeRecords
Long	createAssignment(Long gradebookId, String name, Double points, Date dueDate, Boolean isNotCounted, Boolean isReleased, Boolean isExtraCredit)
Long	createAssignmentForCategory(Long gradebookId, Long categoryId, String name, Double points, Date dueDate, Boolean isNotCounted, Boolean isReleased, Boolean isExtraCredit)
Long	createCategory(Long gradebookId, String name, Double weight, Integer drop_lowest, Integer dropHighest, Integer keepHighest, Boolean is_extra_credit)
Long	createCategory(Long gradebookId, String name, Double weight, Integer drop_lowest, Integer dropHighest, Integer keepHighest, Boolean is_extra_credit, Integer categoryOrder)
void	createDefaultLetterGradePercentMapping(Map gradeMap)
void	createOrUpdateDefaultLetterGradePercentMapping(Map gradeMap)
Long	createUngradedAssignment(Long gradebookId, String name, Date dueDate, Boolean isNotCounted, Boolean isReleased)
Long	createUngradedAssignmentForCategory(Long gradebookId, Long categoryId, String name, Date dueDate, Boolean isNotCounted, Boolean isReleased)
void	deletePermission(Permission perm) Deprecated.
protected List	filterGradeRecordsByStudents(Collection gradeRecords, Collection studentUids) Oracle has a low limit on the maximum length of a parameter list in SQL queries of the form "WHERE tbl.col IN (:paramList)".
protected void	finalizeNullGradeRecords(Gradebook gradebook)
protected Set	getAllStudentUids(String gradebookUid)
Assignment	getAssignment(Long gradableObjectId)
protected AssignmentGradeRecord	getAssignmentGradeRecord(Assignment assignment, String studentUid, org.hibernate.Session session)
protected List	getAssignments(Long gradebookId, org.hibernate.Session session)
CommentDefinition	getAssignmentScoreComment(String gradebookUid, Long assignmentId, String studentUid)
List	getAssignmentsForCategory(Long categoryId)
protected Assignment	getAssignmentWithoutStats(String gradebookUid, Long assignmentId, org.hibernate.Session session)
protected Assignment	getAssignmentWithoutStats(String gradebookUid, String assignmentName, org.hibernate.Session session) Deprecated.
Authn	getAuthn()
List	getCategories(Long gradebookId)
List	getCategoriesWithAssignments(Long gradebookId)
Category	getCategory(Long categoryId)
List	getComments(Assignment assignment, Collection studentIds)
protected List	getCountedStudentGradeRecords(Long gradebookId, String studentId, org.hibernate.Session session)
CourseGrade	getCourseGrade(Long gradebookId)
protected List<CourseGradeRecord>	getCourseGradeOverrides(Gradebook gradebook, org.hibernate.Session session) Get's all course grade overrides for a given gradebook
protected CourseGradeRecord	getCourseGradeRecord(Gradebook gradebook, String studentId, org.hibernate.Session session) Gets the course grade record for a student, or null if it does not yet exist.
LetterGradePercentMapping	getDefaultLetterGradePercentMapping()
protected EventTrackingService	getEventTrackingService()
Gradebook	getGradebook(String uid)
protected GradebookExternalAssessmentService	getGradebookExternalAssessmentService()
String	getGradebookUid(Long id)
LetterGradePercentMapping	getLetterGradePercentMapping(Gradebook gradebook)
List	getPermissionsForGB(Long gradebookId) Deprecated.
List	getPermissionsForGBForCategoryIds(Long gradebookId, List cateIds)
List<Permission>	getPermissionsForUser(Long gradebookId, String userId)
List<Permission>	getPermissionsForUserAnyCategory(Long gradebookId, String userId)
List<Permission>	getPermissionsForUserAnyGroup(Long gradebookId, String userId)
List	getPermissionsForUserAnyGroupAnyCategory(Long gradebookId, String userId)
List<Permission>	getPermissionsForUserAnyGroupForCategory(Long gradebookId, String userId, List cateIds)
List<Permission>	getPermissionsForUserForCategory(Long gradebookId, String userId, List cateIds)
List	getPermissionsForUserForGoupsAnyCategory(Long gradebookId, String userId, List groupIds)
List	getPermissionsForUserForGroup(Long gradebookId, String userId, List groupIds)
protected Map	getPropertiesMap()
String	getPropertyValue(String name)
protected SectionAwareness	getSectionAwareness()
protected ServerConfigurationService	getServerConfigurationService()
protected String	getUserUid()
protected Map<String,Set<Assignment>>	getVisibleExternalAssignments(Gradebook gradebook, Collection<String> studentIds, List<Assignment> assignments)
boolean	isAssignmentDefined(Long gradableObjectId)
boolean	isExplicitlyEnteredCourseGradeRecords(Long gradebookId)
boolean	isGradebookDefined(String gradebookUid)
void	postEvent(String message, String objectReference)
void	removeCategory(Long categoryId)
protected Long	saveNewAssignment(Long gradebookId, Long categoryId, Assignment asn)
void	saveOrUpdateLetterGradePercentMapping(Map gradeMap, Gradebook gradebook)
void	setAssignmentScoreComment(String gradebookUid, Long assignmentId, String studentUid, String commentText)
void	setAuthn(Authn authn)
void	setEventTrackingService(EventTrackingService eventTrackingService)
void	setGradebookExternalAssessmentService(GradebookExternalAssessmentService externalAssessmentService)
void	setPropertyValue(String name, String value)
void	setSectionAwareness(SectionAwareness sectionAwareness)
void	setServerConfigurationService(ServerConfigurationService serverConfigurationService)
protected boolean	studentCanView(String studentId, Assignment assignment)
protected void	updateAssignment(Assignment assignment, org.hibernate.Session session)
void	updateCategory(Category category)
protected void	updateCategory(Category category, org.hibernate.Session session)
void	updateGradebook(Gradebook gradebook)
void	updateGradeMapping(Long gradeMappingId, Map<String,Double> gradeMap)
void	updatePermission(Collection perms) Deprecated.
void	updatePermission(Permission perm) Deprecated.
protected boolean	validateLetterGradeMapping(Map gradeMap)

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

checkDaoConfig, convertHibernateAccessException, createHibernateTemplate, getHibernateTemplate, getSession, getSession, getSessionFactory, releaseSession, 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

Field Detail

MAX_NUMBER_OF_SQL_PARAMETERS_IN_LIST

public static int MAX_NUMBER_OF_SQL_PARAMETERS_IN_LIST

sectionAwareness

protected SectionAwareness sectionAwareness

authn

protected Authn authn

eventTrackingService

protected EventTrackingService eventTrackingService

serverConfigurationService

protected ServerConfigurationService serverConfigurationService

externalAssessmentService

protected GradebookExternalAssessmentService externalAssessmentService

propertiesMap

protected Map propertiesMap

Constructor Detail

BaseHibernateManager

public BaseHibernateManager()

Method Detail

getGradebook

public Gradebook getGradebook(String uid)
                       throws GradebookNotFoundException

Throws:

GradebookNotFoundException

isGradebookDefined

public boolean isGradebookDefined(String gradebookUid)

getAssignments

protected List getAssignments(Long gradebookId,
                              org.hibernate.Session session)
                       throws org.hibernate.HibernateException

Throws:

org.hibernate.HibernateException

getCountedStudentGradeRecords

protected List getCountedStudentGradeRecords(Long gradebookId,
                                             String studentId,
                                             org.hibernate.Session session)
                                      throws org.hibernate.HibernateException

Throws:

org.hibernate.HibernateException

getCourseGrade

public CourseGrade getCourseGrade(Long gradebookId)

getCourseGradeRecord

protected CourseGradeRecord getCourseGradeRecord(Gradebook gradebook,
                                                 String studentId,
                                                 org.hibernate.Session session)
                                          throws org.hibernate.HibernateException

Gets the course grade record for a student, or null if it does not yet exist.

Parameters:

studentId - The student ID

session - The hibernate session

Returns:

A List of grade records

Throws:

org.hibernate.HibernateException

getGradebookUid

public String getGradebookUid(Long id)

getAllStudentUids

protected Set getAllStudentUids(String gradebookUid)

getPropertiesMap

protected Map getPropertiesMap()

getPropertyValue

public String getPropertyValue(String name)

setPropertyValue

public void setPropertyValue(String name,
                             String value)

filterGradeRecordsByStudents

protected List filterGradeRecordsByStudents(Collection gradeRecords,
                                            Collection studentUids)

Oracle has a low limit on the maximum length of a parameter list in SQL queries of the form "WHERE tbl.col IN (:paramList)". Since enrollment lists can sometimes be very long, we've replaced such queries with full selects followed by filtering. This helper method filters out unwanted grade records. (Typically they're not wanted because they're either no longer officially enrolled in the course or they're not members of the selected section.)

getAssignmentWithoutStats

@Deprecated
protected Assignment getAssignmentWithoutStats(String gradebookUid,
                                                           String assignmentName,
                                                           org.hibernate.Session session)
                                                    throws org.hibernate.HibernateException

Deprecated.

Throws:

org.hibernate.HibernateException

getAssignmentWithoutStats

protected Assignment getAssignmentWithoutStats(String gradebookUid,
                                               Long assignmentId,
                                               org.hibernate.Session session)
                                        throws org.hibernate.HibernateException

Throws:

org.hibernate.HibernateException

updateAssignment

protected void updateAssignment(Assignment assignment,
                                org.hibernate.Session session)
                         throws ConflictingAssignmentNameException,
                                org.hibernate.HibernateException

Throws:

ConflictingAssignmentNameException

org.hibernate.HibernateException

getAssignmentGradeRecord

protected AssignmentGradeRecord getAssignmentGradeRecord(Assignment assignment,
                                                         String studentUid,
                                                         org.hibernate.Session session)
                                                  throws org.hibernate.HibernateException

Throws:

org.hibernate.HibernateException

createAssignment

public Long createAssignment(Long gradebookId,
                             String name,
                             Double points,
                             Date dueDate,
                             Boolean isNotCounted,
                             Boolean isReleased,
                             Boolean isExtraCredit)
                      throws ConflictingAssignmentNameException,
                             StaleObjectModificationException

Throws:

ConflictingAssignmentNameException

StaleObjectModificationException

createAssignmentForCategory

public Long createAssignmentForCategory(Long gradebookId,
                                        Long categoryId,
                                        String name,
                                        Double points,
                                        Date dueDate,
                                        Boolean isNotCounted,
                                        Boolean isReleased,
                                        Boolean isExtraCredit)
                                 throws ConflictingAssignmentNameException,
                                        StaleObjectModificationException,
                                        IllegalArgumentException

Throws:

ConflictingAssignmentNameException

StaleObjectModificationException

IllegalArgumentException

saveNewAssignment

protected Long saveNewAssignment(Long gradebookId,
                                 Long categoryId,
                                 Assignment asn)
                          throws ConflictingAssignmentNameException

Throws:

ConflictingAssignmentNameException

updateGradebook

public void updateGradebook(Gradebook gradebook)
                     throws StaleObjectModificationException

Throws:

StaleObjectModificationException

isExplicitlyEnteredCourseGradeRecords

public boolean isExplicitlyEnteredCourseGradeRecords(Long gradebookId)

getAuthn

public Authn getAuthn()

setAuthn

public void setAuthn(Authn authn)

getUserUid

protected String getUserUid()

getSectionAwareness

protected SectionAwareness getSectionAwareness()

setSectionAwareness

public void setSectionAwareness(SectionAwareness sectionAwareness)

getServerConfigurationService

protected ServerConfigurationService getServerConfigurationService()

setServerConfigurationService

public void setServerConfigurationService(ServerConfigurationService serverConfigurationService)

getEventTrackingService

protected EventTrackingService getEventTrackingService()

setEventTrackingService

public void setEventTrackingService(EventTrackingService eventTrackingService)

getGradebookExternalAssessmentService

protected GradebookExternalAssessmentService getGradebookExternalAssessmentService()

setGradebookExternalAssessmentService

public void setGradebookExternalAssessmentService(GradebookExternalAssessmentService externalAssessmentService)

postEvent

public void postEvent(String message,
                      String objectReference)

createCategory

public Long createCategory(Long gradebookId,
                           String name,
                           Double weight,
                           Integer drop_lowest,
                           Integer dropHighest,
                           Integer keepHighest,
                           Boolean is_extra_credit)

createCategory

public Long createCategory(Long gradebookId,
                           String name,
                           Double weight,
                           Integer drop_lowest,
                           Integer dropHighest,
                           Integer keepHighest,
                           Boolean is_extra_credit,
                           Integer categoryOrder)
                    throws ConflictingCategoryNameException,
                           StaleObjectModificationException

Throws:

ConflictingCategoryNameException

StaleObjectModificationException

getCategories

public List getCategories(Long gradebookId)
                   throws org.hibernate.HibernateException

Throws:

org.hibernate.HibernateException

getCategoriesWithAssignments

public List getCategoriesWithAssignments(Long gradebookId)

getAssignmentsForCategory

public List getAssignmentsForCategory(Long categoryId)
                               throws org.hibernate.HibernateException

Throws:

org.hibernate.HibernateException

getCategory

public Category getCategory(Long categoryId)
                     throws org.hibernate.HibernateException

Throws:

org.hibernate.HibernateException

updateCategory

protected void updateCategory(Category category,
                              org.hibernate.Session session)
                       throws ConflictingAssignmentNameException,
                              org.hibernate.HibernateException

Throws:

ConflictingAssignmentNameException

org.hibernate.HibernateException

updateCategory

public void updateCategory(Category category)
                    throws ConflictingCategoryNameException,
                           StaleObjectModificationException

Throws:

ConflictingCategoryNameException

StaleObjectModificationException

removeCategory

public void removeCategory(Long categoryId)
                    throws StaleObjectModificationException

Throws:

StaleObjectModificationException

getDefaultLetterGradePercentMapping

public LetterGradePercentMapping getDefaultLetterGradePercentMapping()

createOrUpdateDefaultLetterGradePercentMapping

public void createOrUpdateDefaultLetterGradePercentMapping(Map gradeMap)

createDefaultLetterGradePercentMapping

public void createDefaultLetterGradePercentMapping(Map gradeMap)

getLetterGradePercentMapping

public LetterGradePercentMapping getLetterGradePercentMapping(Gradebook gradebook)

saveOrUpdateLetterGradePercentMapping

public void saveOrUpdateLetterGradePercentMapping(Map gradeMap,
                                                  Gradebook gradebook)

validateLetterGradeMapping

protected boolean validateLetterGradeMapping(Map gradeMap)

createUngradedAssignment

public Long createUngradedAssignment(Long gradebookId,
                                     String name,
                                     Date dueDate,
                                     Boolean isNotCounted,
                                     Boolean isReleased)
                              throws ConflictingAssignmentNameException,
                                     StaleObjectModificationException

Throws:

ConflictingAssignmentNameException

StaleObjectModificationException

createUngradedAssignmentForCategory

public Long createUngradedAssignmentForCategory(Long gradebookId,
                                                Long categoryId,
                                                String name,
                                                Date dueDate,
                                                Boolean isNotCounted,
                                                Boolean isReleased)
                                         throws ConflictingAssignmentNameException,
                                                StaleObjectModificationException,
                                                IllegalArgumentException

Throws:

ConflictingAssignmentNameException

StaleObjectModificationException

IllegalArgumentException

addPermission

public Long addPermission(Long gradebookId,
                          String userId,
                          String function,
                          Long categoryId,
                          String groupId)
                   throws IllegalArgumentException

Throws:

IllegalArgumentException

getPermissionsForGB

@Deprecated
public List getPermissionsForGB(Long gradebookId)
                                     throws IllegalArgumentException

Deprecated.

Throws:

IllegalArgumentException

updatePermission

@Deprecated
public void updatePermission(Collection perms)

Deprecated.

updatePermission

@Deprecated
public void updatePermission(Permission perm)
                                  throws IllegalArgumentException

Deprecated.

Throws:

IllegalArgumentException

deletePermission

@Deprecated
public void deletePermission(Permission perm)
                                  throws IllegalArgumentException

Deprecated.

Throws:

IllegalArgumentException

getPermissionsForUser

public List<Permission> getPermissionsForUser(Long gradebookId,
                                              String userId)
                                       throws IllegalArgumentException

Throws:

IllegalArgumentException

getPermissionsForUserForCategory

public List<Permission> getPermissionsForUserForCategory(Long gradebookId,
                                                         String userId,
                                                         List cateIds)
                                                  throws IllegalArgumentException

Throws:

IllegalArgumentException

getPermissionsForUserAnyCategory

public List<Permission> getPermissionsForUserAnyCategory(Long gradebookId,
                                                         String userId)
                                                  throws IllegalArgumentException

Throws:

IllegalArgumentException

getPermissionsForUserAnyGroup

public List<Permission> getPermissionsForUserAnyGroup(Long gradebookId,
                                                      String userId)
                                               throws IllegalArgumentException

Throws:

IllegalArgumentException

getPermissionsForUserAnyGroupForCategory

public List<Permission> getPermissionsForUserAnyGroupForCategory(Long gradebookId,
                                                                 String userId,
                                                                 List cateIds)
                                                          throws IllegalArgumentException

Throws:

IllegalArgumentException

getPermissionsForGBForCategoryIds

public List getPermissionsForGBForCategoryIds(Long gradebookId,
                                              List cateIds)
                                       throws IllegalArgumentException

Throws:

IllegalArgumentException

getPermissionsForUserAnyGroupAnyCategory

public List getPermissionsForUserAnyGroupAnyCategory(Long gradebookId,
                                                     String userId)
                                              throws IllegalArgumentException

Throws:

IllegalArgumentException

getPermissionsForUserForGoupsAnyCategory

public List getPermissionsForUserForGoupsAnyCategory(Long gradebookId,
                                                     String userId,
                                                     List groupIds)
                                              throws IllegalArgumentException

Throws:

IllegalArgumentException

getPermissionsForUserForGroup

public List getPermissionsForUserForGroup(Long gradebookId,
                                          String userId,
                                          List groupIds)
                                   throws IllegalArgumentException

Throws:

IllegalArgumentException

isAssignmentDefined

public boolean isAssignmentDefined(Long gradableObjectId)

getAssignment

public Assignment getAssignment(Long gradableObjectId)

Parameters:

gradableObjectId -

Returns:

the Assignment object with the given id

calculateEquivalentPercent

protected Double calculateEquivalentPercent(Double doublePointsPossible,
                                            Double doublePointsEarned)

Parameters:

doublePointsPossible -

doublePointsEarned -

Returns:

the % equivalent for the given points possible and points earned

convertPointsToPercentage

protected List convertPointsToPercentage(Gradebook gradebook,
                                         List studentRecordsFromDB)

Converts points to percentage for the given AssignmentGradeRecords

Parameters:

gradebook -

studentRecordsFromDB -

Returns:

convertPointsToLetterGrade

protected List convertPointsToLetterGrade(Gradebook gradebook,
                                          List studentRecordsFromDB)

Converts points to letter grade for the given AssignmentGradeRecords

Parameters:

gradebook -

studentRecordsFromDB -

Returns:

calculateEquivalentPointValueForPercent

protected Double calculateEquivalentPointValueForPercent(Double doublePointsPossible,
                                                         Double doublePercentEarned)

getComments

public List getComments(Assignment assignment,
                        Collection studentIds)

getVisibleExternalAssignments

protected Map<String,Set<Assignment>> getVisibleExternalAssignments(Gradebook gradebook,
                                                                    Collection<String> studentIds,
                                                                    List<Assignment> assignments)

studentCanView

protected boolean studentCanView(String studentId,
                                 Assignment assignment)

finalizeNullGradeRecords

protected void finalizeNullGradeRecords(Gradebook gradebook)

assignmentNameExists

protected boolean assignmentNameExists(org.hibernate.Session session,
                                       String name,
                                       Gradebook gradebook)

Parameters:

session - an active Hibernate session

name - the assignment name (will not be trimmed)

gradebook - the gradebook to check

Returns:

true if an assignment with the given name already exists in this gradebook.

getAssignmentScoreComment

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

Throws:

GradebookNotFoundException

AssessmentNotFoundException

setAssignmentScoreComment

public void setAssignmentScoreComment(String gradebookUid,
                                      Long assignmentId,
                                      String studentUid,
                                      String commentText)
                               throws GradebookNotFoundException,
                                      AssessmentNotFoundException

Throws:

GradebookNotFoundException

AssessmentNotFoundException

updateGradeMapping

public void updateGradeMapping(Long gradeMappingId,
                               Map<String,Double> gradeMap)

getCourseGradeOverrides

protected List<CourseGradeRecord> getCourseGradeOverrides(Gradebook gradebook,
                                                          org.hibernate.Session session)
                                                   throws org.hibernate.HibernateException

Get's all course grade overrides for a given gradebook

Parameters:

gradebook - The gradebook

session - The hibernate session

Returns:

A list of CourseGradeRecord that have overrides

Throws:

org.hibernate.HibernateException