org.sakaiproject.tool.assessment.facade

Class QuestionPoolFacadeQueries

java.lang.Object

org.springframework.dao.support.DaoSupport

org.springframework.orm.hibernate3.support.HibernateDaoSupport

org.sakaiproject.tool.assessment.facade.QuestionPoolFacadeQueries

All Implemented Interfaces:

QuestionPoolFacadeQueriesAPI, org.springframework.beans.factory.InitializingBean

public class QuestionPoolFacadeQueries
extends org.springframework.orm.hibernate3.support.HibernateDaoSupport
implements QuestionPoolFacadeQueriesAPI

Field Summary

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

logger

Constructor Summary

Constructors

Constructor and Description
QuestionPoolFacadeQueries()

Method Summary

Modifier and Type	Method and Description
Long	add()
void	addItemsToSection(Collection ids, long sectionId) DOCUMENTATION PENDING
void	addItemToPool(QuestionPoolItemData qpi) add a question to a pool
void	addQuestionPoolAccess(Tree tree, String user, Long questionPoolId, Long accessTypeId) Shared Pools with other user
Long	copyItemFacade(ItemDataIfc itemData)
ItemFacade	copyItemFacade2(ItemDataIfc itemData)
void	copyPool(Tree tree, String agentId, Long sourceId, Long destId, String prependString1, String prependString2) Copy a pool to a new location.
void	deletePool(Long poolId, String agent, Tree tree) Delete pool and questions attached to it plus any subpool under it
List<AgentFacade>	getAgentsWithAccess(Long questionPoolId)
List	getAllItemFacades(Long questionPoolId)
List	getAllItemFacadesOrderByItemText(Long questionPoolId, String orderBy, String ascending)
List	getAllItemFacadesOrderByItemType(Long questionPoolId, String orderBy, String ascending)
List	getAllItems(Long questionPoolId)
List	getAllPools() Get a list of all the pools in the site.
QuestionPoolIteratorFacade	getAllPools(String agentId) Get all the pools that the agent has access to.
List	getAllPoolsByAgent(String agentId)
List<QuestionPoolData>	getAllPoolsForTransfer(List<Long> selectedPoolIds)
QuestionPoolIteratorFacade	getAllPoolsWithAccess(String agentId)
ArrayList<QuestionPoolFacade>	getBasicInfoOfAllPools(String agentId)
Integer	getCountItemFacades(Long questionPoolId)
HashMap<Long,Integer>	getCountItemFacadesForUser(String agentId) Fetch a HashMap of question pool ids and counts for all pools that a user has access to.
ItemFacade	getItem(String id) This method returns an ItemFacade that we can use to construct our ItemImpl
QuestionPoolFacade	getPool(Long poolId, String agent) Get a pool based on poolId.
QuestionPoolFacade	getPoolById(Long questionPoolId)
List<Long>	getPoolIdsByAgent(String agentId) Return a list of questionPoolId (java.lang.Long)
List	getPoolIdsByItem(String itemId) Return a list of questionPoolId (java.lang.Long)
QuestionPoolAccessData	getQuestionPoolAccessData(Long poolId, String agentId)
IdImpl	getQuestionPoolId(long id)
IdImpl	getQuestionPoolId(Long id)
IdImpl	getQuestionPoolId(String id)
HashMap	getQuestionPoolItemMap()
List	getSubPools(Long poolId) Get all the children pools of a pool.
int	getSubPoolSize(Long poolId)
List	getSubPoolSizes(String agent)
boolean	hasSubPools(Long poolId) DOCUMENTATION PENDING
boolean	isDescendantOf(QuestionPoolFacade destPool, QuestionPoolFacade sourcePool) Is destination a descendant of the source?
void	moveItemToPool(Long itemId, Long sourceId, Long destId) DOCUMENTATION PENDING
void	movePool(String agentId, Long sourcePoolId, Long destPoolId) Move pool under another pool.
boolean	poolIsUnique(Long questionPoolId, String title, Long parentPoolId, String agentId)
HashSet	prepareQuestions(Long questionPoolId, ArrayList itemDataArray)
void	removeItemFromPool(Long itemId, Long poolId) DOCUMENTATION PENDING
void	removeQuestionPoolAccess(Tree tree, String user, Long questionPoolId, Long accessTypeId)
QuestionPoolFacade	savePool(QuestionPoolFacade pool) DOCUMENTATION PENDING
void	setPoolAccessType(QuestionPoolData qpp, String agentId)
void	transferPoolsOwnership(String ownerId, List<Long> transferPoolIds)

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

Constructor Detail

QuestionPoolFacadeQueries

public QuestionPoolFacadeQueries()

Method Detail

getQuestionPoolId

public IdImpl getQuestionPoolId(String id)

Specified by:

getQuestionPoolId in interface QuestionPoolFacadeQueriesAPI

getQuestionPoolId

public IdImpl getQuestionPoolId(Long id)

Specified by:

getQuestionPoolId in interface QuestionPoolFacadeQueriesAPI

getQuestionPoolId

public IdImpl getQuestionPoolId(long id)

Specified by:

getQuestionPoolId in interface QuestionPoolFacadeQueriesAPI

getAllPools

public List getAllPools()

Get a list of all the pools in the site. Note that questions in each pool will not be populated. We must keep this list updated.

Specified by:

getAllPools in interface QuestionPoolFacadeQueriesAPI

getAllPoolsByAgent

public List getAllPoolsByAgent(String agentId)

getAllPools

public QuestionPoolIteratorFacade getAllPools(String agentId)

Get all the pools that the agent has access to. The easiest way seems to be #1. get all the existing pool #2. get all the QuestionPoolAccessData record of the agent #3. go through the existing pools and check it against the QuestionPoolAccessData (qpa) record to see if the agent is granted access to it. qpa record (if exists) always trumps the default access right set up for a pool e.g. if the defaultAccessType for a pool is ACCESS_DENIED but the qpa record say ADMIN, then access=ADMIN e.g. if the defaultAccessType for a pool is ADMIN but the qpa record say ACCESS_DENIED, then access=ACCESS_DENIED e.g. if no qpa record exists, then access rule will follow the defaultAccessType set by the pool

Specified by:

getAllPools in interface QuestionPoolFacadeQueriesAPI

getAllPoolsWithAccess

public QuestionPoolIteratorFacade getAllPoolsWithAccess(String agentId)

Specified by:

getAllPoolsWithAccess in interface QuestionPoolFacadeQueriesAPI

getBasicInfoOfAllPools

public ArrayList<QuestionPoolFacade> getBasicInfoOfAllPools(String agentId)

Specified by:

getBasicInfoOfAllPools in interface QuestionPoolFacadeQueriesAPI

getAllItems

public List getAllItems(Long questionPoolId)

Specified by:

getAllItems in interface QuestionPoolFacadeQueriesAPI

getAllItemFacadesOrderByItemText

public List getAllItemFacadesOrderByItemText(Long questionPoolId,
                                             String orderBy,
                                             String ascending)

Specified by:

getAllItemFacadesOrderByItemText in interface QuestionPoolFacadeQueriesAPI

getAllItemFacadesOrderByItemType

public List getAllItemFacadesOrderByItemType(Long questionPoolId,
                                             String orderBy,
                                             String ascending)

Specified by:

getAllItemFacadesOrderByItemType in interface QuestionPoolFacadeQueriesAPI

getAllItemFacades

public List getAllItemFacades(Long questionPoolId)

Specified by:

getAllItemFacades in interface QuestionPoolFacadeQueriesAPI

getItem

public ItemFacade getItem(String id)

This method returns an ItemFacade that we can use to construct our ItemImpl

Specified by:

getItem in interface QuestionPoolFacadeQueriesAPI

getPool

public QuestionPoolFacade getPool(Long poolId,
                                  String agent)

Get a pool based on poolId. I am not sure why agent is not used though is being parsed.

Specified by:

getPool in interface QuestionPoolFacadeQueriesAPI

Parameters:

poolid - DOCUMENTATION PENDING

agent - DOCUMENTATION PENDING

Returns:

DOCUMENTATION PENDING

setPoolAccessType

public void setPoolAccessType(QuestionPoolData qpp,
                              String agentId)

Specified by:

setPoolAccessType in interface QuestionPoolFacadeQueriesAPI

getQuestionPoolAccessData

public QuestionPoolAccessData getQuestionPoolAccessData(Long poolId,
                                                        String agentId)

Specified by:

getQuestionPoolAccessData in interface QuestionPoolFacadeQueriesAPI

addItemsToSection

public void addItemsToSection(Collection ids,
                              long sectionId)

DOCUMENTATION PENDING

Specified by:

addItemsToSection in interface QuestionPoolFacadeQueriesAPI

Parameters:

ids - DOCUMENTATION PENDING

sectionId - DOCUMENTATION PENDING

addItemToPool

public void addItemToPool(QuestionPoolItemData qpi)

add a question to a pool

Specified by:

addItemToPool in interface QuestionPoolFacadeQueriesAPI

Parameters:

itemId - DOCUMENTATION PENDING

poolId - DOCUMENTATION PENDING

deletePool

public void deletePool(Long poolId,
                       String agent,
                       Tree tree)

Delete pool and questions attached to it plus any subpool under it

Specified by:

deletePool in interface QuestionPoolFacadeQueriesAPI

Parameters:

itemId - DOCUMENTATION PENDING

poolId - DOCUMENTATION PENDING

movePool

public void movePool(String agentId,
                     Long sourcePoolId,
                     Long destPoolId)

Move pool under another pool. The dest pool must not be the descendant of the source nor can they be the same pool .

Specified by:

movePool in interface QuestionPoolFacadeQueriesAPI

isDescendantOf

public boolean isDescendantOf(QuestionPoolFacade destPool,
                              QuestionPoolFacade sourcePool)

Is destination a descendant of the source?

Specified by:

isDescendantOf in interface QuestionPoolFacadeQueriesAPI

removeItemFromPool

public void removeItemFromPool(Long itemId,
                               Long poolId)

DOCUMENTATION PENDING

Specified by:

removeItemFromPool in interface QuestionPoolFacadeQueriesAPI

Parameters:

itemId - DOCUMENTATION PENDING

poolId - DOCUMENTATION PENDING

moveItemToPool

public void moveItemToPool(Long itemId,
                           Long sourceId,
                           Long destId)

DOCUMENTATION PENDING

Specified by:

moveItemToPool in interface QuestionPoolFacadeQueriesAPI

Parameters:

itemId - DOCUMENTATION PENDING

poolId - DOCUMENTATION PENDING

savePool

public QuestionPoolFacade savePool(QuestionPoolFacade pool)

DOCUMENTATION PENDING

Specified by:

savePool in interface QuestionPoolFacadeQueriesAPI

Parameters:

pool - DOCUMENTATION PENDING

getSubPools

public List getSubPools(Long poolId)

Get all the children pools of a pool. Return a list of QuestionPoolData should return QuestionPool instead - need fixing, daisyf

Specified by:

getSubPools in interface QuestionPoolFacadeQueriesAPI

Parameters:

itemId - DOCUMENTATION PENDING

poolId - DOCUMENTATION PENDING

getSubPoolSizes

public List getSubPoolSizes(String agent)

getSubPoolSize

public int getSubPoolSize(Long poolId)

Specified by:

getSubPoolSize in interface QuestionPoolFacadeQueriesAPI

hasSubPools

public boolean hasSubPools(Long poolId)

DOCUMENTATION PENDING

Specified by:

hasSubPools in interface QuestionPoolFacadeQueriesAPI

Parameters:

itemId - DOCUMENTATION PENDING

poolId - DOCUMENTATION PENDING

poolIsUnique

public boolean poolIsUnique(Long questionPoolId,
                            String title,
                            Long parentPoolId,
                            String agentId)

Specified by:

poolIsUnique in interface QuestionPoolFacadeQueriesAPI

getPoolIdsByAgent

public List<Long> getPoolIdsByAgent(String agentId)

Return a list of questionPoolId (java.lang.Long)

Specified by:

getPoolIdsByAgent in interface QuestionPoolFacadeQueriesAPI

Parameters:

itemId - DOCUMENTATION PENDING

poolId - DOCUMENTATION PENDING

getPoolIdsByItem

public List getPoolIdsByItem(String itemId)

Return a list of questionPoolId (java.lang.Long)

Specified by:

getPoolIdsByItem in interface QuestionPoolFacadeQueriesAPI

Parameters:

itemId - DOCUMENTATION PENDING

poolId - DOCUMENTATION PENDING

copyPool

public void copyPool(Tree tree,
                     String agentId,
                     Long sourceId,
                     Long destId,
                     String prependString1,
                     String prependString2)

Copy a pool to a new location.

Specified by:

copyPool in interface QuestionPoolFacadeQueriesAPI

add

public Long add()

Specified by:

add in interface QuestionPoolFacadeQueriesAPI

getPoolById

public QuestionPoolFacade getPoolById(Long questionPoolId)

Specified by:

getPoolById in interface QuestionPoolFacadeQueriesAPI

getQuestionPoolItemMap

public HashMap getQuestionPoolItemMap()

Specified by:

getQuestionPoolItemMap in interface QuestionPoolFacadeQueriesAPI

prepareQuestions

public HashSet prepareQuestions(Long questionPoolId,
                                ArrayList itemDataArray)

copyItemFacade

public Long copyItemFacade(ItemDataIfc itemData)

Specified by:

copyItemFacade in interface QuestionPoolFacadeQueriesAPI

copyItemFacade2

public ItemFacade copyItemFacade2(ItemDataIfc itemData)

Specified by:

copyItemFacade2 in interface QuestionPoolFacadeQueriesAPI

getCountItemFacades

public Integer getCountItemFacades(Long questionPoolId)

Specified by:

getCountItemFacades in interface QuestionPoolFacadeQueriesAPI

getCountItemFacadesForUser

public HashMap<Long,Integer> getCountItemFacadesForUser(String agentId)

Fetch a HashMap of question pool ids and counts for all pools that a user has access to. We inner join the QuestionPoolAccessData table because the user may have access to pools that are being shared by other users. We can't simply look for the ownerId on QuestionPoolData. This was originally written for SAM-2463 to speed up these counts.

Specified by:

getCountItemFacadesForUser in interface QuestionPoolFacadeQueriesAPI

Parameters:

agentId - Sakai internal user id. Most likely the currently logged in user

addQuestionPoolAccess

public void addQuestionPoolAccess(Tree tree,
                                  String user,
                                  Long questionPoolId,
                                  Long accessTypeId)

Shared Pools with other user

Specified by:

addQuestionPoolAccess in interface QuestionPoolFacadeQueriesAPI

removeQuestionPoolAccess

public void removeQuestionPoolAccess(Tree tree,
                                     String user,
                                     Long questionPoolId,
                                     Long accessTypeId)

Specified by:

removeQuestionPoolAccess in interface QuestionPoolFacadeQueriesAPI

getAgentsWithAccess

public List<AgentFacade> getAgentsWithAccess(Long questionPoolId)

Specified by:

getAgentsWithAccess in interface QuestionPoolFacadeQueriesAPI

getAllPoolsForTransfer

public List<QuestionPoolData> getAllPoolsForTransfer(List<Long> selectedPoolIds)

transferPoolsOwnership

public void transferPoolsOwnership(String ownerId,
                                   List<Long> transferPoolIds)

Specified by:

transferPoolsOwnership in interface QuestionPoolFacadeQueriesAPI