Package org.vrspace.server.api

Class Groups

java.lang.Object
org.vrspace.server.api.ApiBase
org.vrspace.server.api.ClientControllerBase
org.vrspace.server.api.Groups
@RestController @RequestMapping("/vrspace/api/groups") public class Groups extends ClientControllerBase
Manipulate user groups. All of these operations require a session with a valid user currently logged in. So: login with either github, fb, google, and enter a world before trying any of these. Only group members can read and write group messages. Groups can public or private: everybody can join public groups, and private groups require invitation by group owner(s). Temporary groups are deleted after owner disconnects.
Author:
joe

  • Field Details

  • Constructor Details

    • Groups

      public Groups()

  • Method Details

    • listMyGroups

      @GetMapping @ResponseBody public List<UserGroup> listMyGroups(jakarta.servlet.http.HttpSession session)
      List all user groups the user is member of.

    • listOwnedGroups

      @GetMapping("/owned") @ResponseBody public List<UserGroup> listOwnedGroups(jakarta.servlet.http.HttpSession session)
      List all user groups the user owns.

    • create

      @PostMapping(produces="application/json") @ResponseStatus(CREATED) public UserGroup create(String name, Optional<Boolean> isPublic, Optional<Boolean> isTemporary, jakarta.servlet.http.HttpSession session)
      Create a group.
      Parameters:
      name - Group name
      isPublic - Create a public group? Defaults to false.
      isTemporary - Create a temporary group? Defaults to false.

    • update

      @PutMapping(produces="application/json") public void update(@RequestBody UserGroup group, jakarta.servlet.http.HttpSession session)
      Update a group.
      Parameters:
      group - updated group

    • deleteGroup

      @DeleteMapping("/{groupId}") public void deleteGroup(@PathVariable long groupId, jakarta.servlet.http.HttpSession session)
      Delete a group. A group can only be deleted by the owner(s).

    • show

      @GetMapping("/{groupId}/show") public List<Client> show(@PathVariable long groupId, jakarta.servlet.http.HttpSession session)
      Show all members of a group.

    • join

      @PostMapping("/{groupId}/join") public void join(@PathVariable long groupId, jakarta.servlet.http.HttpSession session)
      Join a public group.

    • invite

      @PostMapping("/{groupId}/invite") public void invite(@PathVariable long groupId, Long clientId, jakarta.servlet.http.HttpSession session)
      Invite a user to a group. Only group owner(s) can invite users to private groups. Invited users have to accept invitation. Offline users may get web push notification, if these are configured.
      Parameters:
      groupId - Group to invite to
      clientId - Client to invite

    • ask

      @PostMapping("/{groupId}/ask") public void ask(@PathVariable long groupId, jakarta.servlet.http.HttpSession session)
      Ask to join a private group. Group owner needs to allow new members to join.

    • accept

      @PostMapping("/{groupId}/accept") public void accept(@PathVariable long groupId, jakarta.servlet.http.HttpSession session)
      Accept invitation to a private group.

    • allow

      @PostMapping("/{groupId}/allow") public void allow(@PathVariable long groupId, long clientId, jakarta.servlet.http.HttpSession session)
      Allow a user (who asked) to join a private group. Only group owner(s) can do that.
      Parameters:
      groupId - Group to join
      clientId - Client that asked to join

    • leave

      @PostMapping("/{groupId}/leave") public void leave(@PathVariable long groupId, jakarta.servlet.http.HttpSession session)
      Leave a group. Group owners can not leave. Also used to reject invitation to join the group.

    • kick

      @PostMapping("/{groupId}/kick") public void kick(@PathVariable long groupId, long clientId, jakarta.servlet.http.HttpSession session)
      Kick a user from a group. Only group owner(s) can do that. Also used to reject request to join.
      Parameters:
      groupId - Where to kick from
      clientId - Whom to kick

    • write

      @PostMapping("/{groupId}/write") public void write(@PathVariable long groupId, @RequestBody String text, jakarta.servlet.http.HttpSession session)
      Write something to a group. Online users are notified right away over the web socket, offline users may get web push notification, if these are configured.
      Parameters:
      groupId - The group
      text - The message

    • shareWorld

      @PostMapping("/{groupId}/share") public void shareWorld(@PathVariable long groupId, @RequestBody GroupMessage worldLink, jakarta.servlet.http.HttpSession session)
      Share a world link with the group. Online users are notified right away over the web socket, offline users may get web push notification, if these are configured.
      Parameters:
      groupId - The group
      worldLink - The message containing url and text of the world

    • listRequests

      @GetMapping("/{groupId}/requests") public List<GroupMember> listRequests(@PathVariable long groupId, jakarta.servlet.http.HttpSession session)
      List pending requests to join the group. Only group owners can do that.
      Parameters:
      groupId -

    • listInvites

      @GetMapping("/invitations") public List<GroupMember> listInvites(jakarta.servlet.http.HttpSession session)
      List pending invitations to groups for the current user.
      Parameters:
      session -

    • listUnreadGroups

      @GetMapping("/unread") public List<UserGroup> listUnreadGroups(jakarta.servlet.http.HttpSession session)

    • listUnreadMessages

      @GetMapping("/{groupId}/unread") public List<GroupMessage> listUnreadMessages(@PathVariable long groupId, jakarta.servlet.http.HttpSession session)

    • listOwners

      @GetMapping("/{groupId}/owners") public List<Client> listOwners(@PathVariable long groupId, jakarta.servlet.http.HttpSession session)