Package org.craftercms.studio.controller.rest.v2

Class GroupsController

java.lang.Object

org.craftercms.studio.controller.rest.v2.GroupsController

@Validated
@RequestMapping("/api/2/groups")
@RestController
public class GroupsController
extends Object

Constructor Summary

Constructors

Constructor	Description
GroupsController(GroupService groupService)

Method Summary

Modifier and Type	Method	Description
ResultList<User>	addGroupMembers(int groupId, AddGroupMembers addGroupMembers)	Add group members API
ResultOne<Group>	createGroup(@Valid Group group)	Create group API
Result	deleteGroups(List<Long> groupIds)	Delete group API
PaginatedResultList<Group>	getAllGroups(String keyword, @javax.validation.constraints.PositiveOrZero int offset, @javax.validation.constraints.PositiveOrZero int limit, String sort)	Get groups API
ResultOne<Group>	getGroup(int groupId)	Get group API
PaginatedResultList<User>	getGroupMembers(int groupId, @javax.validation.constraints.PositiveOrZero int offset, @javax.validation.constraints.PositiveOrZero int limit, String sort)	Get group members API
Result	removeGroupMembers(int groupId, List<Long> userIds, List<@NotBlank String> usernames)	Remove group members API
ResultOne<Group>	updateGroup(@Valid UpdateGroupRequest updateRequest)	Update group API

Methods inherited from class java.lang.Object

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

Constructor Detail

GroupsController

@ConstructorProperties("groupService")
public GroupsController(GroupService groupService)

Method Detail

getAllGroups

@GetMapping
public PaginatedResultList<Group> getAllGroups(@RequestParam(value="keyword",required=false)
                                               String keyword,
                                               @PositiveOrZero @RequestParam(value="offset",required=false,defaultValue="0")
                                               @javax.validation.constraints.PositiveOrZero int offset,
                                               @PositiveOrZero @RequestParam(value="limit",required=false,defaultValue="10")
                                               @javax.validation.constraints.PositiveOrZero int limit,
                                               @RequestParam(value="sort",required=false,defaultValue="group_name asc")
                                               String sort)
                                        throws ServiceLayerException,
                                               OrganizationNotFoundException

Get groups API

Parameters:

keyword - keyword parameter

offset - offset parameter

limit - limit parameter

sort - sort parameter

Returns:

Response containing list of groups

Throws:

ServiceLayerException

OrganizationNotFoundException

createGroup

@ResponseStatus(CREATED)
@PostMapping(consumes="application/json")
public ResultOne<Group> createGroup(@Valid @RequestBody
                                    @Valid Group group)
                             throws GroupAlreadyExistsException,
                                    ServiceLayerException,
                                    AuthenticationException

Create group API

Parameters:

group - Group to create

Returns:

Response object

Throws:

GroupAlreadyExistsException

ServiceLayerException

AuthenticationException

updateGroup

@PatchMapping(consumes="application/json")
public ResultOne<Group> updateGroup(@Valid @RequestBody
                                    @Valid UpdateGroupRequest updateRequest)
                             throws ServiceLayerException,
                                    GroupNotFoundException,
                                    AuthenticationException,
                                    GroupExternallyManagedException

Update group API

Parameters:

updateRequest - UpdateGroupRequest to update

Returns:

Response object

Throws:

ServiceLayerException

GroupNotFoundException

AuthenticationException

GroupExternallyManagedException

deleteGroups

@DeleteMapping
public Result deleteGroups(@RequestParam("id")
                           List<Long> groupIds)
                    throws ServiceLayerException,
                           GroupNotFoundException,
                           AuthenticationException,
                           GroupExternallyManagedException

Delete group API

Parameters:

groupIds - Group identifier

Returns:

Response object

Throws:

ServiceLayerException

GroupNotFoundException

AuthenticationException

GroupExternallyManagedException

getGroup

@GetMapping("/{id}")
public ResultOne<Group> getGroup(@PathVariable("id")
                                 int groupId)
                          throws ServiceLayerException,
                                 GroupNotFoundException

Get group API

Parameters:

groupId - Group identifier

Returns:

Response containing requested group

Throws:

ServiceLayerException

GroupNotFoundException

getGroupMembers

@GetMapping("/{id}/members")
public PaginatedResultList<User> getGroupMembers(@PathVariable("id")
                                                 int groupId,
                                                 @PositiveOrZero @RequestParam(value="offset",required=false,defaultValue="0")
                                                 @javax.validation.constraints.PositiveOrZero int offset,
                                                 @PositiveOrZero @RequestParam(value="limit",required=false,defaultValue="10")
                                                 @javax.validation.constraints.PositiveOrZero int limit,
                                                 @RequestParam(value="sort",required=false,defaultValue="id asc")
                                                 String sort)
                                          throws ServiceLayerException,
                                                 GroupNotFoundException

Get group members API

Parameters:

groupId - Group identifier

offset - Result set offset

limit - Result set limit

sort - Sort order

Returns:

Response containing list od users

Throws:

ServiceLayerException

GroupNotFoundException

addGroupMembers

@PostMapping(value="/{id}/members",
             consumes="application/json")
public ResultList<User> addGroupMembers(@PathVariable("id")
                                        int groupId,
                                        @RequestBody
                                        AddGroupMembers addGroupMembers)
                                 throws ServiceLayerException,
                                        UserNotFoundException,
                                        GroupNotFoundException,
                                        AuthenticationException

Add group members API

Parameters:

groupId - Group identifiers

addGroupMembers - Add members request body (json representation)

Returns:

Response object

Throws:

ServiceLayerException

UserNotFoundException

GroupNotFoundException

AuthenticationException

removeGroupMembers

@DeleteMapping("/{id}/members")
public Result removeGroupMembers(@PathVariable("id")
                                 int groupId,
                                 @RequestParam(value="userId",required=false)
                                 List<Long> userIds,
                                 @RequestParam(value="username",required=false)
                                 List<@NotBlank String> usernames)
                          throws ServiceLayerException,
                                 UserNotFoundException,
                                 GroupNotFoundException,
                                 AuthenticationException

Remove group members API

Parameters:

groupId - Group identifier

userIds - List of user identifiers

usernames - List of usernames

Returns:

Response object

Throws:

ServiceLayerException

UserNotFoundException

GroupNotFoundException

AuthenticationException