net.bluemind.group.api

Interface IGroup

All Superinterfaces:

IDirEntryExtIdSupport, IGroupMember, IRestoreDirEntryWithMailboxSupport<Group>, IRestoreSupport<Group>

All Known Subinterfaces:

IInCoreGroup

All Known Implementing Classes:

GroupService

@Path(value="/groups/{domainUid}")
public interface IGroup
extends IDirEntryExtIdSupport, IRestoreDirEntryWithMailboxSupport<Group>, IGroupMember

Method Summary

Modifier and Type	Method and Description
void	add(java.lang.String uid, java.util.List<Member> members)
java.util.List<java.lang.String>	allUids()
ItemValue<Group>	byEmail(java.lang.String email) Get group from its email
ItemValue<Group>	byName(java.lang.String name) Get group from its name
void	create(java.lang.String uid, Group group) Create group
void	createWithExtId(java.lang.String uid, java.lang.String extId, Group group) Create group with external ID
TaskRef	delete(java.lang.String uid) Delete group
ItemValue<Group>	getByExtId(java.lang.String extId) Get group from external ID
ItemValue<Group>	getComplete(java.lang.String uid) Get group from UID
java.util.List<Member>	getExpandedMembers(java.lang.String uid) Get all expanded group members
java.util.List<Member>	getExpandedUserMembers(java.lang.String uid) Get User type expanded group members
java.util.Set<java.lang.String>	getGroupsWithRoles(java.util.List<java.lang.String> roles)
java.util.List<Member>	getMembers(java.lang.String uid) Get all group members
java.util.List<ItemValue<Group>>	getParents(java.lang.String uid) Get all group parents UID
java.util.Set<java.lang.String>	getRoles(java.lang.String uid)
void	remove(java.lang.String uid, java.util.List<Member> members)
java.util.List<ItemValue<Group>>	search(GroupSearchQuery query) Search a group
void	setRoles(java.lang.String uid, java.util.Set<java.lang.String> roles)
void	touch(java.lang.String uid) Touch group (update direntry, vcard etc..)
void	update(java.lang.String uid, Group group) Update group

Methods inherited from interface net.bluemind.directory.api.IDirEntryExtIdSupport

setExtId

Methods inherited from interface net.bluemind.core.container.api.IRestoreSupport

get, restore

Methods inherited from interface net.bluemind.group.api.IGroupMember

memberOf, memberOfGroups

Method Detail

create

@PUT
 @Path(value="{uid}")
void create(@PathParam(value="uid")
                                       java.lang.String uid,
                                       Group group)
                                throws ServerFault

Create group

Parameters:

uid -

group -

Throws:

ServerFault

createWithExtId

@PUT
 @Path(value="{uid}/{extid}/createwithextid")
void createWithExtId(@PathParam(value="uid")
                                                                        java.lang.String uid,
                                                                        @PathParam(value="extid")
                                                                        java.lang.String extId,
                                                                        Group group)
                                                                 throws ServerFault

Create group with external ID

Parameters:

uid -

extId -

group -

Throws:

ServerFault

update

@POST
 @Path(value="{uid}")
void update(@PathParam(value="uid")
                                        java.lang.String uid,
                                        Group group)
                                 throws ServerFault

Update group

Parameters:

uid -

group -

Throws:

ServerFault

touch

@POST
 @Path(value="{uid}/_touch")
void touch(@PathParam(value="uid")
                                              java.lang.String uid)
                                       throws ServerFault

Touch group (update direntry, vcard etc..)

Parameters:

uid -

group -

Throws:

ServerFault

getComplete

@GET
 @Path(value="{uid}/complete")
ItemValue<Group> getComplete(@PathParam(value="uid")
                                                                 java.lang.String uid)
                                                          throws ServerFault

Get group from UID

Specified by:

getComplete in interface IRestoreDirEntryWithMailboxSupport<Group>

Parameters:

uid -

Returns:

Throws:

ServerFault

byEmail

@GET
 @Path(value="byEmail/{email}")
ItemValue<Group> byEmail(@PathParam(value="email")
                                                              java.lang.String email)
                                                       throws ServerFault

Get group from its email

Parameters:

uid -

Returns:

Throws:

ServerFault

byName

@GET
 @Path(value="byName/{name}")
ItemValue<Group> byName(@PathParam(value="name")
                                                           java.lang.String name)
                                                    throws ServerFault

Get group from its name

Parameters:

uid -

Returns:

Throws:

ServerFault

delete

@DELETE
 @Path(value="{uid}")
TaskRef delete(@PathParam(value="uid")
                                             java.lang.String uid)
                                      throws ServerFault

Delete group

Specified by:

delete in interface IRestoreDirEntryWithMailboxSupport<Group>

Parameters:

uid -

Throws:

ServerFault

getByExtId

@GET
 @Path(value="_extid/{extid}")
ItemValue<Group> getByExtId(@PathParam(value="extid")
                                                                java.lang.String extId)
                                                         throws ServerFault

Get group from external ID

Parameters:

extId -

Returns:

Throws:

ServerFault

add

@PUT
 @Path(value="{uid}/members")
void add(@PathParam(value="uid")
                                            java.lang.String uid,
                                            java.util.List<Member> members)
                                     throws ServerFault

Throws:

ServerFault

remove

@DELETE
 @Path(value="{uid}/members")
void remove(@PathParam(value="uid")
                                                  java.lang.String uid,
                                                  java.util.List<Member> members)
                                           throws ServerFault

Throws:

ServerFault

getMembers

@GET
 @Path(value="{uid}/members")
java.util.List<Member> getMembers(@PathParam(value="uid")
                                                                     java.lang.String uid)
                                                              throws ServerFault

Get all group members

Parameters:

group - uid

Returns:

members belonging to this group

Throws:

ServerFault

getExpandedMembers

@GET
 @Path(value="{uid}/expandedmembers")
java.util.List<Member> getExpandedMembers(@PathParam(value="uid")
                                                                                     java.lang.String uid)
                                                                              throws ServerFault

Get all expanded group members

Parameters:

group - uid

Returns:

members belonging to this group or its sub-groups

Throws:

ServerFault

getExpandedUserMembers

@GET
 @Path(value="{uid}/expandedusersmembers")
java.util.List<Member> getExpandedUserMembers(@PathParam(value="uid")
                                                                                              java.lang.String uid)
                                                                                       throws ServerFault

Get User type expanded group members

Parameters:

group - uid

Returns:

members of type User belonging to this group or its sub-groups

Throws:

ServerFault

getParents

@GET
 @Path(value="{uid}/parents")
java.util.List<ItemValue<Group>> getParents(@PathParam(value="uid")
                                                                               java.lang.String uid)
                                                                        throws ServerFault

Get all group parents UID

Parameters:

uid -

Returns:

parents

Throws:

ServerFault

allUids

@GET
 @Path(value="_alluids")
java.util.List<java.lang.String> allUids()
                                                                throws ServerFault

Throws:

ServerFault

getGroupsWithRoles

@POST
 @Path(value="_rolegroups")
java.util.Set<java.lang.String> getGroupsWithRoles(java.util.List<java.lang.String> roles)
                                                                              throws ServerFault

Throws:

ServerFault

search

@POST
 @Path(value="_search")
java.util.List<ItemValue<Group>> search(GroupSearchQuery query)
                                                               throws ServerFault

Search a group

Parameters:

query - group query

Returns:

list of matching groups

Throws:

ServerFault

getRoles

@GET
 @Path(value="{uid}/roles")
java.util.Set<java.lang.String> getRoles(@PathParam(value="uid")
                                                                          java.lang.String uid)
                                                                   throws ServerFault

Parameters:

uid - Group uid

Returns:

Throws:

ServerFault

setRoles

@POST
 @Path(value="{uid}/roles")
void setRoles(@PathParam(value="uid")
                                                java.lang.String uid,
                                                java.util.Set<java.lang.String> roles)
                                         throws ServerFault

Parameters:

uid - Group uid

roles -

Throws:

ServerFault