me.lucko.luckperms.api.manager

Interface UserManager

public interface UserManager

Represents the object responsible for managing User instances.

Note that User instances are automatically loaded for online players. It's likely that offline players will not have an instance pre-loaded.

Since:

4.0

Method Summary

Modifier and Type	Method and Description
void	cleanupUser(User user) Unload a user from the internal storage, if they're not currently online.
Set<User>	getLoadedUsers() Gets a set of all loaded users.
User	getUser(String name) Gets a loaded user.
User	getUser(UUID uuid) Gets a loaded user.
default Optional<User>	getUserOpt(String name) Gets a loaded user.
default Optional<User>	getUserOpt(UUID uuid) Gets a loaded user.
boolean	isLoaded(UUID uuid) Check if a user is loaded in memory
default CompletableFuture<User>	loadUser(UUID uuid) Loads a user from the plugin's storage provider into memory.
CompletableFuture<User>	loadUser(UUID uuid, String username) Loads a user from the plugin's storage provider into memory.
CompletableFuture<Void>	saveUser(User user) Saves a user's data back to the plugin's storage provider.

Method Detail

loadUser

@Nonnull
CompletableFuture<User> loadUser(@Nonnull
                                           UUID uuid,
                                           @Nullable
                                           String username)

Loads a user from the plugin's storage provider into memory.

This method is effectively the same as Storage.loadUser(UUID, String), however, the Future returns the resultant user instance instead of a boolean flag.

Unlike the method in Storage, when a user cannot be loaded, the future will be completed exceptionally.

Parameters:

uuid - the uuid of the user

username - the username, if known

Returns:

the resultant user

Throws:

NullPointerException - if the uuid is null

Since:

4.1

loadUser

@Nonnull
default CompletableFuture<User> loadUser(@Nonnull
                                                   UUID uuid)

Loads a user from the plugin's storage provider into memory.

This method is effectively the same as Storage.loadUser(UUID), however, the Future returns the resultant user instance instead of a boolean flag.

Unlike the method in Storage, when a user cannot be loaded, the future will be completed exceptionally.

Parameters:

uuid - the uuid of the user

Returns:

the resultant user

Throws:

NullPointerException - if the uuid is null

Since:

4.1

saveUser

@Nonnull
CompletableFuture<Void> saveUser(@Nonnull
                                           User user)

Saves a user's data back to the plugin's storage provider.

You should call this after you make any changes to a user.

This method is effectively the same as Storage.saveUser(User), however, the Future returns void instead of a boolean flag.

Unlike the method in Storage, when a user cannot be saved, the future will be completed exceptionally.

Parameters:

user - the user to save

Returns:

a future to encapsulate the operation.

Throws:

NullPointerException - if user is null

IllegalStateException - if the user instance was not obtained from LuckPerms.

Since:

4.1

getUser

@Nullable
User getUser(@Nonnull
                        UUID uuid)

Gets a loaded user.

Parameters:

uuid - the uuid of the user to get

Returns:

a User object, if one matching the uuid is loaded, or null if not

Throws:

NullPointerException - if the uuid is null

getUserOpt

@Nonnull
default Optional<User> getUserOpt(@Nonnull
                                            UUID uuid)

Gets a loaded user.

Parameters:

uuid - the uuid of the user to get

Returns:

an optional User object

Throws:

NullPointerException - if the uuid is null

getUser

@Nullable
User getUser(@Nonnull
                        String name)

Gets a loaded user.

Parameters:

name - the username of the user to get

Returns:

a User object, if one matching the uuid is loaded, or null if not

Throws:

NullPointerException - if the name is null

getUserOpt

@Nonnull
default Optional<User> getUserOpt(@Nonnull
                                            String name)

Gets a loaded user.

Parameters:

name - the username of the user to get

Returns:

an optional User object

Throws:

NullPointerException - if the name is null

getLoadedUsers

@Nonnull
Set<User> getLoadedUsers()

Gets a set of all loaded users.

Returns:

a Set of User objects

isLoaded

boolean isLoaded(@Nonnull
                 UUID uuid)

Check if a user is loaded in memory

Parameters:

uuid - the uuid to check for

Returns:

true if the user is loaded

Throws:

NullPointerException - if the uuid is null

cleanupUser

void cleanupUser(@Nonnull
                 User user)

Unload a user from the internal storage, if they're not currently online.

Parameters:

user - the user to unload

Throws:

NullPointerException - if the user is null