Interface IGroup

All Superinterfaces:

IDirEntryExtIdSupport, IDirEntryFeaturesSupport, IGroupMember

@Path("/groups/{domainUid}")
public interface IGroup
extends IDirEntryExtIdSupport, IDirEntryFeaturesSupport, IGroupMember

Method Summary

Modifier and Type	Method	Description
void	add(String uid, List<Member> members)
List<String>	allUids()
ItemValue<Group>	byEmail(String email)	Get group from its email
ItemValue<Group>	byName(String name)	Get group from its name
void	create(String uid, Group group)	Create group
void	createWithExtId(String uid, String extId, Group group)	Create group with external ID
TaskRef	delete(String uid)	Delete group
Group	get(String uid)	Get group from UID
ItemValue<Group>	getByExtId(String extId)	Get group from external ID
ItemValue<Group>	getComplete(String uid)	Get group from UID
List<Member>	getExpandedMembers(String uid)	Get all expanded group members
List<Member>	getExpandedUserMembers(String uid)	Get User type expanded group members
Set<String>	getGroupsWithRoles(List<String> roles)
ItemValue<Group>	getLight(String uid)	Get group without mailbox and vcard from UID
List<Member>	getMembers(String uid)	Get all group members
List<ItemValue<Group>>	getParents(String uid)	Get all group parents UID
Set<String>	getRoles(String uid)
void	remove(String uid, List<Member> members)
List<ItemValue<Group>>	search(GroupSearchQuery query)	Search a group
TaskRef	setFeatures(String uid, Set<BaseDirEntry.Feature> features)	Set the feature flags of every user member of the group, recursively
void	setRoles(String uid, Set<String> roles)
void	touch(String uid, boolean updateVcards)	Touch group (update direntry, vcard etc..)
void	update(String uid, Group group)	Update group

Methods inherited from interface IDirEntryExtIdSupport

setExtId

Methods inherited from interface IDirEntryFeaturesSupport

getFeatures

Methods inherited from interface IGroupMember

memberOf, memberOfGroups

Method Details

create

@PUT
@Path("{uid}")
void create(@PathParam("uid")
 String uid,
 Group group)
     throws net.bluemind.core.api.fault.ServerFault

Create group

Parameters:

uid -

group -

Throws:

net.bluemind.core.api.fault.ServerFault

createWithExtId

@PUT
@Path("{uid}/{extid}/createwithextid")
void createWithExtId(@PathParam("uid")
 String uid,
 @PathParam("extid")
 String extId,
 Group group)
              throws net.bluemind.core.api.fault.ServerFault

Create group with external ID

Parameters:

uid -

extId -

group -

Throws:

net.bluemind.core.api.fault.ServerFault

update

@POST
@Path("{uid}")
void update(@PathParam("uid")
 String uid,
 Group group)
     throws net.bluemind.core.api.fault.ServerFault

Update group

Parameters:

uid -

group -

Throws:

net.bluemind.core.api.fault.ServerFault

touch

@POST
@Path("{uid}/_touch")
void touch(@PathParam("uid")
 String uid,
 @QueryParam("update_vcards")
 boolean updateVcards)
    throws net.bluemind.core.api.fault.ServerFault

Touch group (update direntry, vcard etc..)

Parameters:

uid -

updateVcards - should we update the group vcards (default: true)

Throws:

net.bluemind.core.api.fault.ServerFault

get

@GET
@Path("{uid}")
Group get(String uid)

Get group from UID

Parameters:

uid -

Returns:

Throws:

net.bluemind.core.api.fault.ServerFault

getComplete

@GET
@Path("{uid}/complete")
ItemValue<Group> getComplete(@PathParam("uid")
 String uid)
                      throws net.bluemind.core.api.fault.ServerFault

Get group from UID

Parameters:

uid -

Returns:

Throws:

net.bluemind.core.api.fault.ServerFault

getLight

@GET
@Path("{uid}/light")
ItemValue<Group> getLight(@PathParam("uid")
 String uid)
                   throws net.bluemind.core.api.fault.ServerFault

Get group without mailbox and vcard from UID

Parameters:

uid -

Returns:

Throws:

net.bluemind.core.api.fault.ServerFault

byEmail

@GET
@Path("byEmail/{email}")
ItemValue<Group> byEmail(@PathParam("email")
 String email)
                  throws net.bluemind.core.api.fault.ServerFault

Get group from its email

Parameters:

email -

Returns:

Throws:

net.bluemind.core.api.fault.ServerFault

byName

@GET
@Path("byName/{name}")
ItemValue<Group> byName(@PathParam("name")
 String name)
                 throws net.bluemind.core.api.fault.ServerFault

Get group from its name

Parameters:

name -

Returns:

Throws:

net.bluemind.core.api.fault.ServerFault

delete

@DELETE
@Path("{uid}")
TaskRef delete(@PathParam("uid")
 String uid)
        throws net.bluemind.core.api.fault.ServerFault

Delete group

Parameters:

uid -

Throws:

net.bluemind.core.api.fault.ServerFault

setFeatures

@POST
@Path("{uid}/features")
TaskRef setFeatures(@PathParam("uid")
 String uid,
 Set<BaseDirEntry.Feature> features)
             throws net.bluemind.core.api.fault.ServerFault

Set the feature flags of every user member of the group, recursively

Parameters:

uid - the group's unique id

features - the feature flags

Throws:

net.bluemind.core.api.fault.ServerFault - common error object

getByExtId

@GET
@Path("_extid/{extid}")
ItemValue<Group> getByExtId(@PathParam("extid")
 String extId)
                     throws net.bluemind.core.api.fault.ServerFault

Get group from external ID

Parameters:

extId -

Returns:

Throws:

net.bluemind.core.api.fault.ServerFault

add

@PUT
@Path("{uid}/members")
void add(@PathParam("uid")
 String uid,
 List<Member> members)
  throws net.bluemind.core.api.fault.ServerFault

Throws:

net.bluemind.core.api.fault.ServerFault

remove

@DELETE
@Path("{uid}/members")
void remove(@PathParam("uid")
 String uid,
 List<Member> members)
     throws net.bluemind.core.api.fault.ServerFault

Throws:

net.bluemind.core.api.fault.ServerFault

getMembers

@GET
@Path("{uid}/members")
List<Member> getMembers(@PathParam("uid")
 String uid)
                 throws net.bluemind.core.api.fault.ServerFault

Get all group members

Parameters:

uid - the group uid

Returns:

members belonging to this group

Throws:

net.bluemind.core.api.fault.ServerFault

getExpandedMembers

@GET
@Path("{uid}/expandedmembers")
List<Member> getExpandedMembers(@PathParam("uid")
 String uid)
                         throws net.bluemind.core.api.fault.ServerFault

Get all expanded group members

Parameters:

uid - the group uid

Returns:

members belonging to this group or its sub-groups

Throws:

net.bluemind.core.api.fault.ServerFault

getExpandedUserMembers

@GET
@Path("{uid}/expandedusersmembers")
List<Member> getExpandedUserMembers(@PathParam("uid")
 String uid)
                             throws net.bluemind.core.api.fault.ServerFault

Get User type expanded group members

Parameters:

uid - the group uid

Returns:

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

Throws:

net.bluemind.core.api.fault.ServerFault

getParents

@GET
@Path("{uid}/parents")
List<ItemValue<Group>> getParents(@PathParam("uid")
 String uid)
                           throws net.bluemind.core.api.fault.ServerFault

Get all group parents UID

Parameters:

uid -

Returns:

parents

Throws:

net.bluemind.core.api.fault.ServerFault

allUids

@GET
@Path("_alluids")
List<String> allUids()
              throws net.bluemind.core.api.fault.ServerFault

Throws:

net.bluemind.core.api.fault.ServerFault

getGroupsWithRoles

@POST
@Path("_rolegroups")
Set<String> getGroupsWithRoles(List<String> roles)
                        throws net.bluemind.core.api.fault.ServerFault

Throws:

net.bluemind.core.api.fault.ServerFault

search

@POST
@Path("_search")
List<ItemValue<Group>> search(GroupSearchQuery query)
                       throws net.bluemind.core.api.fault.ServerFault

Search a group

Parameters:

query - group query

Returns:

list of matching groups

Throws:

net.bluemind.core.api.fault.ServerFault

getRoles

@GET
@Path("{uid}/roles")
Set<String> getRoles(@PathParam("uid")
 String uid)
              throws net.bluemind.core.api.fault.ServerFault

Parameters:

uid - Group uid

Returns:

Throws:

net.bluemind.core.api.fault.ServerFault

setRoles

@POST
@Path("{uid}/roles")
void setRoles(@PathParam("uid")
 String uid,
 Set<String> roles)
       throws net.bluemind.core.api.fault.ServerFault

Parameters:

uid - Group uid

roles -

Throws:

net.bluemind.core.api.fault.ServerFault