Package org.vrspace.server.api

Class Worlds

java.lang.Object

org.vrspace.server.api.ApiBase

org.vrspace.server.api.Worlds

@RestController
@RequestMapping("/vrspace/api/worlds")
public class Worlds
extends ApiBase

World controller handles worlds-related operations. Currently only list and count users, publicly available. Eventually it should allow world creation and management for authorised users.

Author:

joe

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Worlds.CreateWorldOptions	World options

Field Summary

Fields

Modifier and Type	Field	Description
static final String	PATH

Fields inherited from class org.vrspace.server.api.ApiBase

API_ROOT

Constructor Summary

Constructors

Constructor	Description
Worlds()

Method Summary

Modifier and Type	Method	Description
org.springframework.http.ResponseEntity<String>	createWorld(jakarta.servlet.http.HttpSession session, Worlds.CreateWorldOptions params)	Create a private world, the user must be authenticated.
List<World>	list()
List<WorldStatus>	users()

Methods inherited from class org.vrspace.server.api.ApiBase

currentUserName, isAuthenticated

Methods inherited from class java.lang.Object

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

Field Details

PATH

public static final String PATH

See Also:

• Constant Field Values

Constructor Details

Worlds

public Worlds()

Method Details

list

@GetMapping("/list")
public List<World> list()

users

@GetMapping("/users")
public List<WorldStatus> users()

createWorld

@PostMapping("/create")
public org.springframework.http.ResponseEntity<String> createWorld(jakarta.servlet.http.HttpSession session,
 @RequestBody(required=true)
 Worlds.CreateWorldOptions params)

Create a private world, the user must be authenticated. If the world already exists, owner may change isPublic or isTemporary parameters. Returns HTTP 201 CREATED for created world, or HTTP 200 OK if world already exists.

Parameters:

session - automatically passed by framework

params - world options

Returns:

token required to enter the world, only for private worlds