Storage (luckperms-api 4.3 API)

```
public interface Storage
```
A means of loading and saving permission data to/from the backend.

Since:

2.14

Method Summary

All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`@NonNull CompletableFuture<Boolean>`	`createAndLoadGroup(@NonNull String name)` Deprecated. in favour of `GroupManager.createAndLoadGroup(String)`
`@NonNull CompletableFuture<Boolean>`	`createAndLoadTrack(@NonNull String name)` Deprecated. in favour of `TrackManager.createAndLoadTrack(String)`
`@NonNull CompletableFuture<Boolean>`	`deleteGroup(@NonNull Group group)` Deprecated. in favour of `GroupManager.deleteGroup(Group)`
`@NonNull CompletableFuture<Boolean>`	`deleteTrack(@NonNull Track track)` Deprecated. in favour of `TrackManager.deleteTrack(Track)`
`@NonNull Executor`	`getAsyncExecutor()` Deprecated. as plugins should create their own executors
`@NonNull CompletableFuture<List<HeldPermission<String>>>`	`getGroupsWithPermission(@NonNull String permission)` Deprecated. in favour of `GroupManager.getWithPermission(String)`
`@NonNull CompletableFuture<Log>`	`getLog()` Deprecated. in favour of `ActionLogger.getLog()`
`@NonNull String`	`getName()` Get the name of the storage implementation.
`@NonNull CompletableFuture<String>`	`getName(@NonNull UUID uuid)` Deprecated. in favour of `UserManager.lookupUsername(UUID)`
`@NonNull Executor`	`getSyncExecutor()` Deprecated. as plugins should create their own executors
`@NonNull CompletableFuture<Set<UUID>>`	`getUniqueUsers()` Deprecated. in favour of `UserManager.getUniqueUsers()`
`@NonNull CompletableFuture<List<HeldPermission<UUID>>>`	`getUsersWithPermission(@NonNull String permission)` Deprecated. in favour of `UserManager.getWithPermission(String)`
`@NonNull CompletableFuture<UUID>`	`getUUID(@NonNull String username)` Deprecated. in favour of `UserManager.lookupUuid(String)`
`boolean`	`isAcceptingLogins()` Deprecated. as this method always returns true.
`@NonNull CompletableFuture<Boolean>`	`loadAllGroups()` Deprecated. in favour of `GroupManager.loadAllGroups()`
`@NonNull CompletableFuture<Boolean>`	`loadAllTracks()` Deprecated. in favour of `TrackManager.loadAllTracks()`
`@NonNull CompletableFuture<Boolean>`	`loadGroup(@NonNull String name)` Deprecated. in favour of `GroupManager.loadGroup(String)`
`@NonNull CompletableFuture<Boolean>`	`loadTrack(@NonNull String name)` Deprecated. in favour of `TrackManager.loadTrack(String)`
`default @NonNull CompletableFuture<Boolean>`	`loadUser(@NonNull UUID uuid)` Deprecated. in favour of `UserManager.loadUser(UUID)`
`@NonNull CompletableFuture<Boolean>`	`loadUser(@NonNull UUID uuid, @Nullable String username)` Deprecated. in favour of `UserManager.loadUser(UUID, String)`
`@NonNull CompletableFuture<Boolean>`	`logAction(@NonNull LogEntry entry)` Deprecated. in favour of `ActionLogger.submit(LogEntry)`.
`@NonNull CompletableFuture<Boolean>`	`saveGroup(@NonNull Group group)` Deprecated. in favour of `GroupManager.saveGroup(Group)`
`@NonNull CompletableFuture<Boolean>`	`saveTrack(@NonNull Track track)` Deprecated. in favour of `TrackManager.saveTrack(Track)`
`@NonNull CompletableFuture<Boolean>`	`saveUser(@NonNull User user)` Deprecated. in favour of `UserManager.saveUser(User)`
`@NonNull CompletableFuture<Boolean>`	`saveUUIDData(@NonNull String username, @NonNull UUID uuid)` Deprecated. in favour of `UserManager.savePlayerData(UUID, String)`

- Method Detail
  - getName
```
@NonNull String getName()
```
    Get the name of the storage implementation.
    
    Returns:
    
    the name of the implementation
  - isAcceptingLogins
```
@Deprecated
boolean isAcceptingLogins()
```
    Deprecated. as this method always returns true.
    
    Gets whether the storage instance is allowing logins on the platform.
    
    Returns:
    
    true if logins are enabled
  - logAction
```
@Deprecated
@NonNull CompletableFuture<Boolean> logAction(@NonNull LogEntry entry)
```
    Deprecated. in favour of ActionLogger.submit(LogEntry).
    
    Saves an action to storage
    
    Parameters:
    
    entry - the log entry to be saved
    
    Returns:
    
    true if the operation completed successfully.
    
    Throws:
    
    NullPointerException - if entry is null
  - getLog
```
@Deprecated
@NonNull CompletableFuture<Log> getLog()
```
    Deprecated. in favour of ActionLogger.getLog()
    
    Loads and returns the entire log from storage
    
    Returns:
    
    a log instance, could be null if loading failed
  - loadUser
```
@Deprecated
@NonNull CompletableFuture<Boolean> loadUser(@NonNull UUID uuid,
                                                          @Nullable String username)
```
    Deprecated. in favour of UserManager.loadUser(UUID, String)
    
    Loads a user's data from the main storage into the plugins local storage.
    
    Parameters:
    
    uuid - the uuid of the user to load
    
    username - the users username, or null if it is not known.
    
    Returns:
    
    if the operation completed successfully
    
    Throws:
    
    NullPointerException - if uuid is null
  - loadUser
```
@Deprecated
default @NonNull CompletableFuture<Boolean> loadUser(@NonNull UUID uuid)
```
    Deprecated. in favour of UserManager.loadUser(UUID)
    
    Loads a user's data from the main storage into the plugins local storage.
    
    Parameters:
    
    uuid - the uuid of the user to load
    
    Returns:
    
    if the operation completed successfully
    
    Throws:
    
    NullPointerException - if uuid is null
  - saveUser
```
@Deprecated
@NonNull CompletableFuture<Boolean> saveUser(@NonNull User user)
```
    Deprecated. in favour of UserManager.saveUser(User)
    
    Saves a user object back to storage.
    You should call this after you make any changes to a user.
    
    Parameters:
    
    user - the user to save
    
    Returns:
    
    true if the operation completed successfully.
    
    Throws:
    
    NullPointerException - if user is null
    
    IllegalStateException - if the user instance was not obtained from LuckPerms.
  - getUniqueUsers
```
@Deprecated
@NonNull CompletableFuture<Set<UUID>> getUniqueUsers()
```
    Deprecated. in favour of UserManager.getUniqueUsers()
    
    Gets a set all "unique" user UUIDs.
    "Unique" meaning the user isn't just a member of the "default" group.
    
    Returns:
    
    a set of uuids, or null if the operation failed.
  - getUsersWithPermission
```
@Deprecated
@NonNull CompletableFuture<List<HeldPermission<UUID>>> getUsersWithPermission(@NonNull String permission)
```
    Deprecated. in favour of UserManager.getWithPermission(String)
    
    Searches for a list of users with a given permission.
    
    Parameters:
    
    permission - the permission to search for
    
    Returns:
    
    a list of held permissions, or null if the operation failed
    
    Throws:
    
    NullPointerException - if the permission is null
    
    Since:
    
    2.17
  - createAndLoadGroup
```
@Deprecated
@NonNull CompletableFuture<Boolean> createAndLoadGroup(@NonNull String name)
```
    Deprecated. in favour of GroupManager.createAndLoadGroup(String)
    
    Creates and loads a group into the plugins local storage
    
    Parameters:
    
    name - the name of the group
    
    Returns:
    
    true if the operation completed successfully
    
    Throws:
    
    NullPointerException - if name is null
    
    IllegalArgumentException - if the name is invalid
  - loadGroup
```
@Deprecated
@NonNull CompletableFuture<Boolean> loadGroup(@NonNull String name)
```
    Deprecated. in favour of GroupManager.loadGroup(String)
    
    Loads a group into the plugins local storage.
    
    Parameters:
    
    name - the name of the group
    
    Returns:
    
    true if the operation completed successfully
    
    Throws:
    
    NullPointerException - if name is null
    
    IllegalArgumentException - if the name is invalid
  - loadAllGroups
```
@Deprecated
@NonNull CompletableFuture<Boolean> loadAllGroups()
```
    Deprecated. in favour of GroupManager.loadAllGroups()
    
    Loads all groups from the storage into memory
    
    Returns:
    
    true if the operation completed successfully.
  - saveGroup
```
@Deprecated
@NonNull CompletableFuture<Boolean> saveGroup(@NonNull Group group)
```
    Deprecated. in favour of GroupManager.saveGroup(Group)
    
    Saves a group back to storage.
    You should call this after you make any changes to a group.
    
    Parameters:
    
    group - the group to save
    
    Returns:
    
    true if the operation completed successfully.
    
    Throws:
    
    NullPointerException - if group is null
    
    IllegalStateException - if the group instance was not obtained from LuckPerms.
  - deleteGroup
```
@Deprecated
@NonNull CompletableFuture<Boolean> deleteGroup(@NonNull Group group)
```
    Deprecated. in favour of GroupManager.deleteGroup(Group)
    
    Permanently deletes a group from storage.
    
    Parameters:
    
    group - the group to delete
    
    Returns:
    
    true if the operation completed successfully.
    
    Throws:
    
    NullPointerException - if group is null
    
    IllegalStateException - if the group instance was not obtained from LuckPerms.
  - getGroupsWithPermission
```
@Deprecated
@NonNull CompletableFuture<List<HeldPermission<String>>> getGroupsWithPermission(@NonNull String permission)
```
    Deprecated. in favour of GroupManager.getWithPermission(String)
    
    Searches for a list of groups with a given permission.
    
    Parameters:
    
    permission - the permission to search for
    
    Returns:
    
    a list of held permissions, or null if the operation failed
    
    Throws:
    
    NullPointerException - if the permission is null
    
    Since:
    
    2.17
  - createAndLoadTrack
```
@Deprecated
@NonNull CompletableFuture<Boolean> createAndLoadTrack(@NonNull String name)
```
    Deprecated. in favour of TrackManager.createAndLoadTrack(String)
    
    Creates and loads a track into the plugins local storage
    
    Parameters:
    
    name - the name of the track
    
    Returns:
    
    true if the operation completed successfully
    
    Throws:
    
    NullPointerException - if name is null
    
    IllegalArgumentException - if the name is invalid
  - loadTrack
```
@Deprecated
@NonNull CompletableFuture<Boolean> loadTrack(@NonNull String name)
```
    Deprecated. in favour of TrackManager.loadTrack(String)
    
    Loads a track into the plugins local storage.
    
    Parameters:
    
    name - the name of the track
    
    Returns:
    
    true if the operation completed successfully
    
    Throws:
    
    NullPointerException - if name is null
    
    IllegalArgumentException - if the name is invalid
  - loadAllTracks
```
@Deprecated
@NonNull CompletableFuture<Boolean> loadAllTracks()
```
    Deprecated. in favour of TrackManager.loadAllTracks()
    
    Loads all tracks from the storage into memory
    
    Returns:
    
    true if the operation completed successfully.
  - saveTrack
```
@Deprecated
@NonNull CompletableFuture<Boolean> saveTrack(@NonNull Track track)
```
    Deprecated. in favour of TrackManager.saveTrack(Track)
    
    Saves a track back to storage. You should call this after you make any changes to a track.
    
    Parameters:
    
    track - the track to save
    
    Returns:
    
    true if the operation completed successfully.
    
    Throws:
    
    NullPointerException - if track is null
    
    IllegalStateException - if the track instance was not obtained from LuckPerms.
  - deleteTrack
```
@Deprecated
@NonNull CompletableFuture<Boolean> deleteTrack(@NonNull Track track)
```
    Deprecated. in favour of TrackManager.deleteTrack(Track)
    
    Permanently deletes a track from storage
    
    Parameters:
    
    track - the track to delete
    
    Returns:
    
    true if the operation completed successfully.
    
    Throws:
    
    NullPointerException - if track is null
    
    IllegalStateException - if the track instance was not obtained from LuckPerms.
  - saveUUIDData
```
@NonNull CompletableFuture<Boolean> saveUUIDData(@NonNull String username,
                                                 @NonNull UUID uuid)
```
    Deprecated. in favour of UserManager.savePlayerData(UUID, String)
    
    Saves UUID caching data to the global cache
    
    Parameters:
    
    username - the users username
    
    uuid - the users mojang unique id
    
    Returns:
    
    true if the operation completed successfully.
    
    Throws:
    
    NullPointerException - if either parameters are null
    
    IllegalArgumentException - if the username is invalid
  - getUUID
```
@NonNull CompletableFuture<UUID> getUUID(@NonNull String username)
```
    Deprecated. in favour of UserManager.lookupUuid(String)
    
    Gets a UUID from a username
    
    Parameters:
    
    username - the corresponding username
    
    Returns:
    
    a uuid object, could be null
    
    Throws:
    
    NullPointerException - if either parameters are null
    
    IllegalArgumentException - if the username is invalid
  - getName
```
@Deprecated
@NonNull CompletableFuture<String> getName(@NonNull UUID uuid)
```
    Deprecated. in favour of UserManager.lookupUsername(UUID)
    
    Gets a username from a UUID
    
    Parameters:
    
    uuid - the corresponding uuid
    
    Returns:
    
    a name string, could be null
    
    Throws:
    
    NullPointerException - if either parameters are null
    
    Since:
    
    2.17
  - getSyncExecutor
```
@Deprecated
@NonNull Executor getSyncExecutor()
```
    Deprecated. as plugins should create their own executors
    
    Returns an executor which will run all passed runnables on the main server thread.
    This method is deprecated as plugins should create and use their own executor instances.
    
    Returns:
    
    an executor instance
  - getAsyncExecutor
```
@Deprecated
@NonNull Executor getAsyncExecutor()
```
    Deprecated. as plugins should create their own executors
    
    Returns an executor which will run all passed runnables asynchronously using the platforms scheduler and thread pools.
    This method is deprecated as plugins should create and use their own executor instances.
    
    Returns:
    
    an executor instance

Interface Storage

Method Summary

Method Detail

getName

isAcceptingLogins

logAction

getLog

loadUser

loadUser

saveUser

getUniqueUsers

getUsersWithPermission

createAndLoadGroup

loadGroup

loadAllGroups

saveGroup

deleteGroup

getGroupsWithPermission

createAndLoadTrack

loadTrack

loadAllTracks

saveTrack

deleteTrack

saveUUIDData

getUUID

getName

getSyncExecutor

getAsyncExecutor