org.dspace.eperson.dao

Interface GroupDAO

All Superinterfaces:

DSpaceObjectDAO<Group>, DSpaceObjectLegacySupportDAO<Group>, GenericDAO<Group>

All Known Implementing Classes:

GroupDAOImpl

public interface GroupDAO
extends DSpaceObjectDAO<Group>, DSpaceObjectLegacySupportDAO<Group>

Database Access Object interface class for the Group object. The implementation of this class is responsible for all database calls for the Group object and is autowired by spring This class should only be accessed from a single service & should never be exposed outside of the API

Author:

kevinvandevelde at atmire.com

Method Summary

Methods

Modifier and Type	Method and Description
int	countByNameLike(Context context, String groupName) Count the number of groups that have a name that contains the given string
int	countRows(Context context) Count the number of groups in DSpace
List<Group>	findAll(Context context) Find all groups ordered by name ascending
List<Group>	findAll(Context context, List<MetadataField> sortMetadataFields) Find all groups ordered by the specified metadata fields ascending
List<Group>	findByEPerson(Context context, EPerson ePerson) Find all groups that the given ePerson belongs to
List<Group>	findByMetadataField(Context context, String searchValue, MetadataField metadataField) Look up groups based on their value for a certain metadata field (NOTE: name is not stored as metadata)
Group	findByName(Context context, String name) Find a group by its name (exact match)
Group	findByNameAndEPerson(Context context, String groupName, EPerson ePerson) Find a group by its name and the membership of the given EPerson
List<Group>	findByNameLike(Context context, String groupName, int offset, int limit) Find a group by its name (fuzzy match)
List<Group>	getEmptyGroups(Context context) Return all empty groups
List<org.apache.commons.lang3.tuple.Pair<UUID,UUID>>	getGroup2GroupResults(Context context, boolean flushQueries) Get a list of all direct parent - child group relations in the database

Methods inherited from interface org.dspace.content.dao.DSpaceObjectLegacySupportDAO

findByLegacyId

Methods inherited from interface org.dspace.core.GenericDAO

create, delete, findAll, findByID, findByID, findMany, findUnique, save

Method Detail

findByMetadataField

List<Group> findByMetadataField(Context context,
                              String searchValue,
                              MetadataField metadataField)
                                throws SQLException

Look up groups based on their value for a certain metadata field (NOTE: name is not stored as metadata)

Parameters:

context - The DSpace context

searchValue - The value to match

metadataField - The metadata field to search in

Returns:

The groups that have a matching value for specified metadata field

Throws:

SQLException

findAll

List<Group> findAll(Context context,
                  List<MetadataField> sortMetadataFields)
                    throws SQLException

Find all groups ordered by the specified metadata fields ascending

Parameters:

context - The DSpace context

sortMetadataFields - The metadata fields to sort on

Returns:

A list of all groups, ordered by metadata fields

Throws:

SQLException

findAll

List<Group> findAll(Context context)
                    throws SQLException

Find all groups ordered by name ascending

Parameters:

context - The DSpace context

Returns:

A list of all groups, ordered by name

Throws:

SQLException

findByEPerson

List<Group> findByEPerson(Context context,
                        EPerson ePerson)
                          throws SQLException

Find all groups that the given ePerson belongs to

Parameters:

context - The DSpace context

ePerson - The EPerson to match

Returns:

A list of all groups to which the given EPerson belongs

Throws:

SQLException

getGroup2GroupResults

List<org.apache.commons.lang3.tuple.Pair<UUID,UUID>> getGroup2GroupResults(Context context,
                                                                         boolean flushQueries)
                                                                           throws SQLException

Get a list of all direct parent - child group relations in the database

Parameters:

context - The DSpace context

flushQueries - Flush all pending queries

Returns:

A list of pairs indicating parent - child

Throws:

SQLException

getEmptyGroups

List<Group> getEmptyGroups(Context context)
                           throws SQLException

Return all empty groups

Parameters:

context - The DSpace context

Returns:

All empty groups

Throws:

SQLException

countRows

int countRows(Context context)
              throws SQLException

Count the number of groups in DSpace

Parameters:

context - The DSpace context

Returns:

The number of groups

Throws:

SQLException

findByName

Group findByName(Context context,
               String name)
                 throws SQLException

Find a group by its name (exact match)

Parameters:

context - The DSpace context

name - The name of the group to look for

Returns:

The group with the specified name

Throws:

SQLException

findByNameLike

List<Group> findByNameLike(Context context,
                         String groupName,
                         int offset,
                         int limit)
                           throws SQLException

Find a group by its name (fuzzy match)

Parameters:

context - The DSpace context

groupName - Part of the group's name to search for

offset - Offset to use for pagination (-1 to disable)

limit - The maximum number of results to return (-1 to disable)

Returns:

Groups matching the query

Throws:

SQLException

countByNameLike

int countByNameLike(Context context,
                  String groupName)
                    throws SQLException

Count the number of groups that have a name that contains the given string

Parameters:

context - The DSpace context

groupName - Part of the group's name to search for

Returns:

The number of matching groups

Throws:

SQLException

findByNameAndEPerson

Group findByNameAndEPerson(Context context,
                         String groupName,
                         EPerson ePerson)
                           throws SQLException

Find a group by its name and the membership of the given EPerson

Parameters:

context - The DSpace context

groupName - The name of the group to look for

ePerson - The EPerson which has to be a member

Returns:

The group with the specified name

Throws:

SQLException