org.dspace.eperson.service

Interface GroupService

All Superinterfaces:

DSpaceObjectLegacySupportService<Group>, DSpaceObjectService<Group>

All Known Implementing Classes:

GroupServiceImpl

public interface GroupService
extends DSpaceObjectService<Group>, DSpaceObjectLegacySupportService<Group>

Service interface class for the Group object. The implementation of this class is responsible for all business logic calls for the Group object and is autowired by spring

Author:

kevinvandevelde at atmire.com

Field Summary

Fields

Modifier and Type	Field and Description
static int	NAME

Method Summary

Methods

Modifier and Type	Method and Description
void	addMember(Context context, Group group, EPerson e) add an eperson member
void	addMember(Context context, Group groupParent, Group groupChild) add group to this group
List<Group>	allMemberGroups(Context context, EPerson ePerson) Get all of the groups that an eperson is a member of.
List<EPerson>	allMembers(Context context, Group group) Get all of the epeople who are a member of the specified group, or a member of a sub-group of the specified group, etc.
int	countTotal(Context context) Count the total number of groups in DSpace
Group	create(Context context) Create a new group
List<Group>	findAll(Context context, int sortField) Deprecated.
List<Group>	findAll(Context context, List<MetadataField> metadataSortFields) Finds all groups in the site
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 the group by its name - assumes name is unique
List<Group>	getEmptyGroups(Context context) Find all empty groups in DSpace
void	initDefaultGroupNames(Context context) Initializes the group names for anonymous & administrator, and marks them "permanent".
boolean	isDirectMember(Group group, EPerson ePerson) check to see if an eperson is a direct member.
boolean	isEmpty(Group group) Return true if group has no direct or indirect members
boolean	isMember(Context context, Group group) fast check to see if an eperson is a member called with eperson id, does database lookup without instantiating all of the epeople objects and is thus a static method
boolean	isMember(Context context, String groupName) fast check to see if an eperson is a member called with eperson id, does database lookup without instantiating all of the epeople objects and is thus a static method
boolean	isMember(Group owningGroup, Group childGroup) Check to see if g is a direct group member.
void	removeMember(Context context, Group group, EPerson ePerson) remove an eperson from a group
void	removeMember(Context context, Group groupParent, Group childGroup) remove group from this group
List<Group>	search(Context context, String groupIdentifier) Find the groups that match the search query across eperson_group_id or name
List<Group>	search(Context context, String groupIdentifier, int offset, int limit) Find the groups that match the search query across eperson_group_id or name
int	searchResultCount(Context context, String query) Returns the total number of groups returned by a specific query, without the overhead of creating the Group objects to store the results.
void	setName(Group group, String name) set name of group

Methods inherited from interface org.dspace.content.service.DSpaceObjectService

addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, clearMetadata, delete, find, getAdminObject, getIdentifiers, getMetadata, getMetadata, getMetadata, getMetadata, getMetadataByMetadataString, getMetadataFirstValue, getName, getParentObject, getSupportsTypeConstant, getTypeText, removeMetadataValues, setMetadataSingleValue, update, updateLastModified

Methods inherited from interface org.dspace.content.service.DSpaceObjectLegacySupportService

findByIdOrLegacyId, findByLegacyId, getSupportsTypeConstant

Field Detail

NAME

static final int NAME

See Also:

Constant Field Values

Method Detail

create

Group create(Context context)
             throws SQLException,
                    AuthorizeException

Create a new group

Parameters:

context - DSpace context object

Throws:

SQLException

AuthorizeException

setName

void setName(Group group,
           String name)
             throws SQLException

set name of group

Parameters:

name - new group name

Throws:

SQLException

addMember

void addMember(Context context,
             Group group,
             EPerson e)

add an eperson member

Parameters:

e - eperson

addMember

void addMember(Context context,
             Group groupParent,
             Group groupChild)
               throws SQLException

add group to this group

Parameters:

groupParent -

Throws:

SQLException

removeMember

void removeMember(Context context,
                Group group,
                EPerson ePerson)

remove an eperson from a group

Parameters:

ePerson - eperson

removeMember

void removeMember(Context context,
                Group groupParent,
                Group childGroup)
                  throws SQLException

remove group from this group

Parameters:

g -

Throws:

SQLException

isDirectMember

boolean isDirectMember(Group group,
                     EPerson ePerson)

check to see if an eperson is a direct member. If the eperson is a member via a subgroup will be returned false

Parameters:

e - eperson to check membership

isMember

boolean isMember(Group owningGroup,
               Group childGroup)

Check to see if g is a direct group member. If g is a subgroup via another group will be returned false

Parameters:

g - group to check

isMember

boolean isMember(Context context,
               Group group)
                 throws SQLException

fast check to see if an eperson is a member called with eperson id, does database lookup without instantiating all of the epeople objects and is thus a static method

Parameters:

context - context

group - group to check

Throws:

SQLException

isMember

boolean isMember(Context context,
               String groupName)
                 throws SQLException

fast check to see if an eperson is a member called with eperson id, does database lookup without instantiating all of the epeople objects and is thus a static method

Parameters:

context - context

groupName - the name of the group to check

Throws:

SQLException

allMemberGroups

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

Get all of the groups that an eperson is a member of.

Parameters:

context -

ePerson -

Throws:

SQLException

allMembers

List<EPerson> allMembers(Context context,
                       Group group)
                         throws SQLException

Get all of the epeople who are a member of the specified group, or a member of a sub-group of the specified group, etc.

Parameters:

context - DSpace context

group - Group object

Returns:

Array of EPerson objects

Throws:

SQLException

findByName

Group findByName(Context context,
               String name)
                 throws SQLException

Find the group by its name - assumes name is unique

Parameters:

context -

name -

Returns:

the named Group, or null if not found

Throws:

SQLException

findAll

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

Finds all groups in the site

Parameters:

context - DSpace context

metadataSortFields - metadata fields to sort by, leave empty to sort by Name

Returns:

array of all groups in the site

Throws:

SQLException

findAll

@Deprecated
List<Group> findAll(Context context,
                             int sortField)
                    throws SQLException

Deprecated.

DEPRECATED: Please use findAll(Context context, List metadataFieldsSort) instead

Throws:

SQLException

search

List<Group> search(Context context,
                 String groupIdentifier)
                   throws SQLException

Find the groups that match the search query across eperson_group_id or name

Parameters:

context - DSpace context

groupIdentifier - The group name or group ID

Returns:

array of Group objects

Throws:

SQLException

search

List<Group> search(Context context,
                 String groupIdentifier,
                 int offset,
                 int limit)
                   throws SQLException

Find the groups that match the search query across eperson_group_id or name

Parameters:

context - DSpace context

groupIdentifier - The group name or group ID

offset - Inclusive offset

limit - Maximum number of matches returned

Returns:

array of Group objects

Throws:

SQLException

searchResultCount

int searchResultCount(Context context,
                    String query)
                      throws SQLException

Returns the total number of groups returned by a specific query, without the overhead of creating the Group objects to store the results.

Parameters:

context - DSpace context

query - The search string

Returns:

the number of groups matching the query

Throws:

SQLException

isEmpty

boolean isEmpty(Group group)

Return true if group has no direct or indirect members

initDefaultGroupNames

void initDefaultGroupNames(Context context)
                           throws SQLException,
                                  AuthorizeException

Initializes the group names for anonymous & administrator, and marks them "permanent".

Parameters:

context - the DSpace context

Throws:

SQLException - database exception

AuthorizeException

getEmptyGroups

List<Group> getEmptyGroups(Context context)
                           throws SQLException

Find all empty groups in DSpace

Parameters:

context - The DSpace context

Returns:

All empty groups

Throws:

SQLException

countTotal

int countTotal(Context context)
               throws SQLException

Count the total number of groups in DSpace

Parameters:

context - The DSpace context

Returns:

The total number of groups

Throws:

SQLException

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