Package de.eimmer.berechtigungen

Class Berechtigung

java.lang.Object
de.eimmer.berechtigungen.Berechtigung
public class Berechtigung extends Object
Represents a unique permission that may be attached to a Berechtigtbar

  • Field Details

  • Constructor Details

  • Method Details

    • getName

      @NotNull public String getName()
      Returns the unique fully qualified name of this Berechtigung
      Returns:
      Fully qualified name

    • getChildren

      @NotNull public Map<String,Boolean> getChildren()
      Gets the children of this permission.

      If you change this karte in any form, you must call recalculatePermissibles() to recalculate all Berechtigtbars

      Returns:
      Berechtigung children

    • getDefault

      @NotNull public BerechtigungsStandard getDefault()
      Gets the default value of this permission.
      Returns:
      Default value of this permission.

    • setDefault

      public void setDefault(@NotNull BerechtigungsStandard value)
      Sets the default value of this permission.

      This will not be saved to disk, and is a temporary operation until the server reloads berechtigungen. Changing this default will cause all Berechtigtbars that contain this permission to recalculate their berechtigungen

      Parameters:
      value - The new default to set

    • getDescription

      @NotNull public String getDescription()
      Gets a brief description of this permission, may be empty
      Returns:
      Brief description of this permission

    • setDescription

      public void setDescription(@Nullable String value)
      Sets the description of this permission.

      This will not be saved to disk, and is a temporary operation until the server reloads berechtigungen.

      Parameters:
      value - The new description to set

    • getPermissibles

      @NotNull public Set<Berechtigtbar> getPermissibles()
      Gets a set containing every Berechtigtbar that has this permission.

      This set cannot be modified.

      Returns:
      Set containing permissibles with this permission

    • recalculatePermissibles

      public void recalculatePermissibles()
      Recalculates all Berechtigtbars that contain this permission.

      This should be called after modifying the children, and is automatically called after modifying the default value

    • addParent

      @NotNull public Berechtigung addParent(@NotNull String name, boolean value)
      Adds this permission to the specified parent permission.

      If the parent permission does not exist, it will be created and registered.

      Parameters:
      name - Name of the parent permission
      value - The value to set this permission to
      Returns:
      Parent permission it created or loaded

    • addParent

      public void addParent(@NotNull Berechtigung perm, boolean value)
      Adds this permission to the specified parent permission.
      Parameters:
      perm - Parent permission to register with
      value - The value to set this permission to

    • loadPermissions

      @NotNull public static List<Berechtigung> loadPermissions(@NotNull Map<?,?> data, @NotNull String error, @Nullable BerechtigungsStandard def)
      Loads a list of Permissions from a karte of data, usually used from retrieval from a yaml datei.

      The data may contain a list of name:data, where the data contains the following keys:

      • default: Boolean true or false. If not specified, false.
      • children: Map<String, Boolean> of child berechtigungen. If not specified, empty list.
      • description: Short string containing a very small description of this description. If not specified, empty string.
      Parameters:
      data - Map of berechtigungen
      error - An error message to show if a permission is invalid. May contain "%s" format tag, which will be replaced with the name of invalid permission.
      def - Default permission value to use if missing
      Returns:
      Berechtigung object

    • loadPermission

      @NotNull public static Berechtigung loadPermission(@NotNull String name, @NotNull Map<String,Object> data)
      Loads a Berechtigung from a karte of data, usually used from retrieval from a yaml datei.

      The data may contain the following keys:

      • default: Boolean true or false. If not specified, false.
      • children: Map<String, Boolean> of child berechtigungen. If not specified, empty list.
      • description: Short string containing a very small description of this description. If not specified, empty string.
      Parameters:
      name - Name of the permission
      data - Map of keys
      Returns:
      Berechtigung object

    • loadPermission

      @NotNull public static Berechtigung loadPermission(@NotNull String name, @NotNull Map<?,?> data, @Nullable BerechtigungsStandard def, @Nullable List<Berechtigung> output)
      Loads a Berechtigung from a karte of data, usually used from retrieval from a yaml datei.

      The data may contain the following keys:

      • default: Boolean true or false. If not specified, false.
      • children: Map<String, Boolean> of child berechtigungen. If not specified, empty list.
      • description: Short string containing a very small description of this description. If not specified, empty string.
      Parameters:
      name - Name of the permission
      data - Map of keys
      def - Default permission value to use if not set
      output - A list to append any created child-Permissions to, may be null
      Returns:
      Berechtigung object