[DS-2058] Javadoc fixes.

This commit is contained in:
Mark H. Wood
2021-05-13 11:51:34 -04:00
parent b688bd0145
commit 1ca945b6c6

View File

@@ -147,9 +147,9 @@ public abstract class AbstractHibernateDAO<T> implements GenericDAO<T> {
* @param cacheable
* Whether or not this query should be cacheable
* @param clazz
* The clazz for which this CriteriaQuery will be executed on
* The class for which this CriteriaQuery will be executed on
* @param maxResults
* The maxmimum amount of results that will be returned for this CriteriaQuery
* The maximum amount of results that will be returned for this CriteriaQuery
* @param offset
* The offset to be used for the CriteriaQuery
* @return A list of distinct results as depicted by the CriteriaQuery and parameters
@@ -206,8 +206,9 @@ public abstract class AbstractHibernateDAO<T> implements GenericDAO<T> {
/**
* Retrieve a unique result from the query. If multiple results CAN be
* retrieved an exception will be thrown,
* so only use when the criteria state uniqueness in the database.
* retrieved an exception will be thrown, so only use when the criteria
* state uniqueness in the database.
* @param context current DSpace session.
* @param criteriaQuery JPA criteria
* @param cacheable whether or not this query should be cacheable.
* @param clazz type of object that should match the query.
@@ -235,8 +236,10 @@ public abstract class AbstractHibernateDAO<T> implements GenericDAO<T> {
/**
* Retrieve a single result from the query. Best used if you expect a
* single result, but this isn't enforced on the database.
* @param context current DSpace session
* @param criteriaQuery JPA criteria
* @return a DAO specified by the criteria
* @throws java.sql.SQLException passed through.
*/
public T singleResult(Context context, CriteriaQuery criteriaQuery) throws SQLException {
Query query = this.getHibernateSession(context).createQuery(criteriaQuery);
@@ -307,7 +310,7 @@ public abstract class AbstractHibernateDAO<T> implements GenericDAO<T> {
* @param criteriaQuery
* The CriteriaQuery for which this result will be retrieved
* @param criteriaBuilder
* The CriteriaBuilder that accompagnies the CriteriaQuery
* The CriteriaBuilder that accompanies the CriteriaQuery
* @param root
* The root that'll determine on which class object we need to calculate the result
* @return The amount of results that would be found by this CriteriaQuery as an integer value