edu.internet2.middleware.grouper
Class GroupFinder

java.lang.Object
  edu.internet2.middleware.grouper.GroupFinder

public class GroupFinder
extends java.lang.Object

Find groups within the Groups Registry.

Version:

$Id: GroupFinder.java,v 1.62 2009-11-17 02:52:29 mchyzer Exp $

Author:

blair christensen.

Constructor Summary

GroupFinder()
default constructor

Method Summary

GroupFinder	addGroupId(java.lang.String groupId) add a group id to search for
GroupFinder	addGroupName(java.lang.String groupName) add a group name to search for
GroupFinder	addPrivilege(Privilege privilege) add a privilege to filter by that the subject has on the group
GroupFinder	addTypeOfGroup(TypeOfGroup typeOfGroup)
GroupFinder	assignAttributeValue(java.lang.Object theValue) find objects with this value
GroupFinder	assignCompositeOwner(java.lang.Boolean theCompositeOwner) if we are filtering for groups which are composite owners or not
GroupFinder	assignField(Field theField) field to look for if searching for memberships in groups
GroupFinder	assignFieldName(java.lang.String theFieldName) field name to look for if searching for memberships in groups
GroupFinder	assignFindByUuidOrName(boolean theFindByUuidOrName) if we are looking up a group, only look by uuid or name
GroupFinder	assignGroupIds(java.util.Collection<java.lang.String> theGroupIds) assign group ids to search for
GroupFinder	assignGroupNames(java.util.Collection<java.lang.String> theGroupNames) assign group names to search for
GroupFinder	assignIdOfAttributeDefName(java.lang.String theAttributeDefNameId) find groups that have this attribute assigned
GroupFinder	assignMembershipsForSubject(boolean membershipsForSubject1) if this is true, or there is a field assigned, then get memberships for a subject
GroupFinder	assignNameOfAttributeDefName(java.lang.String theNameOfAttributeDefName) find groups that have this attribute assigned
GroupFinder	assignParentStemId(java.lang.String theParentStemId) parent or ancestor stem of the group
GroupFinder	assignPrivileges(java.util.Set<Privilege> theGroups) assign privileges to filter by that the subject has on the group
GroupFinder	assignQueryOptions(QueryOptions theQueryOptions) if sorting, paging, caching, etc
GroupFinder	assignScope(java.lang.String theScope) scope to look for groups Wildcards will be appended or percent is the wildcard
GroupFinder	assignSplitScope(boolean theSplitScope) if the scope has spaces in it, then split by whitespace, and find results that contain all of the scope strings
GroupFinder	assignStemScope(Stem.Scope theStemScope) if passing in a stem, this is the stem scope...
GroupFinder	assignSubject(edu.internet2.middleware.subject.Subject theSubject) this is the subject that has certain memberships in the query
GroupFinder	assignSubjectNotInGroup(edu.internet2.middleware.subject.Subject theSubjectNotInGroup) assign a subject which does not have a membership in the group
GroupFinder	assignTypeOfGroups(java.util.Set<TypeOfGroup> theTypeOfGroups)
static java.util.Set<Group>	findAllByAttribute(GrouperSession s, java.lang.String attr, java.lang.String val) Find Groups by attribute value.
static java.util.Set<Group>	findAllByType(GrouperSession s, GroupType type) Find all groups within the registry by their GroupType.
static Group	findByAlternateName(GrouperSession s, java.lang.String name, boolean exceptionIfNotFound) Find a group within the registry by its alternate name.
static Group	findByAttribute(GrouperSession s, java.lang.String attr, java.lang.String val) Deprecated. use the overload
static Group	findByAttribute(GrouperSession s, java.lang.String attr, java.lang.String val, boolean exceptionOnNull) Find Group by attribute value.
static Group	findByCurrentName(GrouperSession s, java.lang.String name, boolean exceptionIfNotFound) Find a group within the registry by its current name.
static Group	findByIdIndexSecure(java.lang.Long idIndex, boolean exceptionIfNotFound, QueryOptions queryOptions) Find a group within the registry by ID index.
static Group	findByName(GrouperSession s, java.lang.String name) Deprecated.
static Group	findByName(GrouperSession s, java.lang.String name, boolean exceptionIfNotFound) Find a group within the registry by name.
static Group	findByName(GrouperSession s, java.lang.String name, boolean exceptionIfNotFound, QueryOptions queryOptions) Find a group within the registry by name.
static Group	findByUuid(GrouperSession s, java.lang.String uuid) Deprecated.
static Group	findByUuid(GrouperSession s, java.lang.String uuid, boolean exceptionIfNotFound) Find a group within the registry by UUID.
static Group	findByUuid(GrouperSession s, java.lang.String uuid, boolean exceptionIfNotFound, QueryOptions queryOptions) Find a group within the registry by UUID.
Group	findGroup() find the group
java.util.Set<Group>	findGroups() find all the group

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GroupFinder

public GroupFinder()

default constructor

Method Detail

assignCompositeOwner

public GroupFinder assignCompositeOwner(java.lang.Boolean theCompositeOwner)

if we are filtering for groups which are composite owners or not

Parameters:

theCompositeOwner -

Returns:

this for chaining

findByAttribute

@Deprecated
public static Group findByAttribute(GrouperSession s,
                                               java.lang.String attr,
                                               java.lang.String val)
                             throws GroupNotFoundException,
                                    java.lang.IllegalArgumentException

Deprecated. use the overload

Find Group by attribute value.

 try {
   Group g = GroupFinder.findByAttribute(s, "description", "some value");
 }
 catch (GroupNotFoundException eGNF) {
 }
 

Parameters:

s - Search within this session context.

attr - Search on this attribute.

val - Search for this value.

Returns:

Matching Group.

Throws:

GroupNotFoundException

java.lang.IllegalArgumentException

Since:

1.1.0

findByAttribute

public static Group findByAttribute(GrouperSession s,
                                    java.lang.String attr,
                                    java.lang.String val,
                                    boolean exceptionOnNull)
                             throws GroupNotFoundException,
                                    java.lang.IllegalArgumentException

Find Group by attribute value.

   Group g = GroupFinder.findByAttribute(s, "description", "some value", true);
 

Parameters:

s - Search within this session context.

attr - Search on this attribute.

val - Search for this value.

exceptionOnNull - true if there should be an exception on null

Returns:

Matching Group.

Throws:

GroupNotFoundException

java.lang.IllegalArgumentException

Since:

1.1.0

findAllByAttribute

public static java.util.Set<Group> findAllByAttribute(GrouperSession s,
                                                      java.lang.String attr,
                                                      java.lang.String val)
                                               throws java.lang.IllegalArgumentException

Find Groups by attribute value. Returns groups or empty set if none (never null)

   Set groups = GroupFinder.findAllByAttribute(s, "description", "some value");
 

Parameters:

s - Search within this session context.

attr - Search on this attribute.

val - Search for this value.

Returns:

Matching Group.

Throws:

java.lang.IllegalArgumentException

Since:

1.1.0

findByName

@Deprecated
public static Group findByName(GrouperSession s,
                                          java.lang.String name)
                        throws GroupNotFoundException

Deprecated.

Find a group within the registry by name.

 try {
   Group g = GroupFinder.findByName(name);
 }
 catch (GroupNotFoundException e) {
   // Group not found
 }
 

Parameters:

s - Find group within this session context.

name - Name of group to find.

Returns:

A Group

Throws:

GroupNotFoundException

findByName

public static Group findByName(GrouperSession s,
                               java.lang.String name,
                               boolean exceptionIfNotFound)
                        throws GroupNotFoundException

Find a group within the registry by name.

 try {
   Group g = GroupFinder.findByName(name);
 }
 catch (GroupNotFoundException e) {
   // Group not found
 }
 

Parameters:

s - Find group within this session context.

name - Name of group to find.

exceptionIfNotFound -

Returns:

A Group

Throws:

GroupNotFoundException

findByName

public static Group findByName(GrouperSession s,
                               java.lang.String name,
                               boolean exceptionIfNotFound,
                               QueryOptions queryOptions)
                        throws GroupNotFoundException

Find a group within the registry by name.

 try {
   Group g = GroupFinder.findByName(name);
 }
 catch (GroupNotFoundException e) {
   // Group not found
 }
 

Parameters:

s - Find group within this session context.

name - Name of group to find.

exceptionIfNotFound -

queryOptions - paging, sorting, caching options

Returns:

A Group

Throws:

GroupNotFoundException

findByCurrentName

public static Group findByCurrentName(GrouperSession s,
                                      java.lang.String name,
                                      boolean exceptionIfNotFound)
                               throws GroupNotFoundException

Find a group within the registry by its current name.

 try {
   Group g = GroupFinder.findByCurrentName(name, true);
 }
 catch (GroupNotFoundException e) {
   // Group not found
 }
 

Parameters:

s - Find group within this session context.

name - Name of group to find.

exceptionIfNotFound -

Returns:

A Group

Throws:

GroupNotFoundException

findByAlternateName

public static Group findByAlternateName(GrouperSession s,
                                        java.lang.String name,
                                        boolean exceptionIfNotFound)
                                 throws GroupNotFoundException

Find a group within the registry by its alternate name.

 try {
   Group g = GroupFinder.findByAlternateName(name, true);
 }
 catch (GroupNotFoundException e) {
   // Group not found
 }
 

Parameters:

s - Find group within this session context.

name - Name of group to find.

exceptionIfNotFound -

Returns:

A Group

Throws:

GroupNotFoundException

findAllByType

public static java.util.Set<Group> findAllByType(GrouperSession s,
                                                 GroupType type)
                                          throws java.lang.IllegalArgumentException

Find all groups within the registry by their GroupType. Or empty set if none (never null).

   Set groups = GroupFinder.findAllByType( s, GroupTypeFinder.find("your type") );
 

Parameters:

s - Find group within this session context.

type - Find group with this GroupType.

Returns:

A set of Groups

Throws:

java.lang.IllegalArgumentException

findByUuid

@Deprecated
public static Group findByUuid(GrouperSession s,
                                          java.lang.String uuid)
                        throws GroupNotFoundException

Deprecated.

Find a group within the registry by UUID.

   Group g = GroupFinder.findByUuid(s, uuid);
 

Parameters:

s - Find group within this session context.

uuid - UUID of group to find.

Returns:

A Group

Throws:

GroupNotFoundException

findByUuid

public static Group findByUuid(GrouperSession s,
                               java.lang.String uuid,
                               boolean exceptionIfNotFound)
                        throws GroupNotFoundException

Find a group within the registry by UUID.

   Group g = GroupFinder.findByUuid(s, uuid);
 

Parameters:

s - Find group within this session context.

uuid - UUID of group to find.

exceptionIfNotFound - true if exception if not found

Returns:

A Group

Throws:

GroupNotFoundException - if not found an exceptionIfNotFound is true

findByUuid

public static Group findByUuid(GrouperSession s,
                               java.lang.String uuid,
                               boolean exceptionIfNotFound,
                               QueryOptions queryOptions)
                        throws GroupNotFoundException

Find a group within the registry by UUID.

   Group g = GroupFinder.findByUuid(s, uuid);
 

Parameters:

s - Find group within this session context.

uuid - UUID of group to find.

exceptionIfNotFound - true if exception if not found

queryOptions -

Returns:

A Group

Throws:

GroupNotFoundException - if not found an exceptionIfNotFound is true

findByIdIndexSecure

public static Group findByIdIndexSecure(java.lang.Long idIndex,
                                        boolean exceptionIfNotFound,
                                        QueryOptions queryOptions)
                                 throws GroupNotFoundException

Find a group within the registry by ID index.

Parameters:

idIndex - id index of group to find.

exceptionIfNotFound - true if exception if not found

queryOptions -

Returns:

A Group

Throws:

GroupNotFoundException - if not found an exceptionIfNotFound is true

assignSubjectNotInGroup

public GroupFinder assignSubjectNotInGroup(edu.internet2.middleware.subject.Subject theSubjectNotInGroup)

assign a subject which does not have a membership in the group

Parameters:

theSubjectNotInGroup -

Returns:

this for chaining

addPrivilege

public GroupFinder addPrivilege(Privilege privilege)

add a privilege to filter by that the subject has on the group

Parameters:

privilege - should be AccessPrivilege

Returns:

this for chaining

assignPrivileges

public GroupFinder assignPrivileges(java.util.Set<Privilege> theGroups)

assign privileges to filter by that the subject has on the group

Parameters:

theGroups -

Returns:

this for chaining

assignQueryOptions

public GroupFinder assignQueryOptions(QueryOptions theQueryOptions)

if sorting, paging, caching, etc

Parameters:

theQueryOptions -

Returns:

this for chaining

assignAttributeValue

public GroupFinder assignAttributeValue(java.lang.Object theValue)

find objects with this value

Parameters:

theValue -

Returns:

this for chaining

assignIdOfAttributeDefName

public GroupFinder assignIdOfAttributeDefName(java.lang.String theAttributeDefNameId)

find groups that have this attribute assigned

Parameters:

theAttributeDefNameId -

Returns:

this for chaining

assignNameOfAttributeDefName

public GroupFinder assignNameOfAttributeDefName(java.lang.String theNameOfAttributeDefName)

find groups that have this attribute assigned

Parameters:

theNameOfAttributeDefName -

Returns:

this for chaining

addGroupId

public GroupFinder addGroupId(java.lang.String groupId)

add a group id to search for

Parameters:

groupId -

Returns:

this for chaining

assignGroupNames

public GroupFinder assignGroupNames(java.util.Collection<java.lang.String> theGroupNames)

assign group names to search for

Parameters:

theGroupNames -

Returns:

this for chaining

addGroupName

public GroupFinder addGroupName(java.lang.String groupName)

add a group name to search for

Parameters:

groupName -

Returns:

this for chaining

assignGroupIds

public GroupFinder assignGroupIds(java.util.Collection<java.lang.String> theGroupIds)

assign group ids to search for

Parameters:

theGroupIds -

Returns:

this for chaining

assignField

public GroupFinder assignField(Field theField)

field to look for if searching for memberships in groups

Parameters:

theField -

Returns:

this for chaining

assignFieldName

public GroupFinder assignFieldName(java.lang.String theFieldName)

field name to look for if searching for memberships in groups

Parameters:

theFieldName -

Returns:

theFieldName

assignMembershipsForSubject

public GroupFinder assignMembershipsForSubject(boolean membershipsForSubject1)

if this is true, or there is a field assigned, then get memberships for a subject

Parameters:

membershipsForSubject1 -

Returns:

this for chaining

findGroups

public java.util.Set<Group> findGroups()

find all the group

Returns:

the set of groups or the empty set if none found

assignTypeOfGroups

public GroupFinder assignTypeOfGroups(java.util.Set<TypeOfGroup> theTypeOfGroups)

Parameters:

theTypeOfGroups -

Returns:

this for chaining

addTypeOfGroup

public GroupFinder addTypeOfGroup(TypeOfGroup typeOfGroup)

Parameters:

typeOfGroup -

Returns:

this

assignScope

public GroupFinder assignScope(java.lang.String theScope)

scope to look for groups Wildcards will be appended or percent is the wildcard

Parameters:

theScope -

Returns:

this for chaining

assignSplitScope

public GroupFinder assignSplitScope(boolean theSplitScope)

if the scope has spaces in it, then split by whitespace, and find results that contain all of the scope strings

Parameters:

theSplitScope -

Returns:

this for chaining

assignSubject

public GroupFinder assignSubject(edu.internet2.middleware.subject.Subject theSubject)

this is the subject that has certain memberships in the query

Parameters:

theSubject -

Returns:

this for chaining

assignParentStemId

public GroupFinder assignParentStemId(java.lang.String theParentStemId)

parent or ancestor stem of the group

Parameters:

theParentStemId -

Returns:

this for chaining

assignStemScope

public GroupFinder assignStemScope(Stem.Scope theStemScope)

if passing in a stem, this is the stem scope...

Parameters:

theStemScope -

Returns:

this for chaining

assignFindByUuidOrName

public GroupFinder assignFindByUuidOrName(boolean theFindByUuidOrName)

if we are looking up a group, only look by uuid or name

Parameters:

theFindByUuidOrName -

Returns:

the group finder

findGroup

public Group findGroup()

find the group

Returns:

the group or null