ContextSet (LuckPerms API (v5.0))

All Superinterfaces:

Iterable<Context>

All Known Subinterfaces:

ImmutableContextSet, MutableContextSet
```
public interface ContextSet
extends Iterable<Context>
```
A set of contexts.
Context in the most basic sense simply means the circumstances where something will apply.

A single "context" consists of a key and a value, both strings. The key represents the type of context, and the value represents the setting of the context key.

Contexts can be combined with each other to form so called "context sets" - simply a collection of context pairs.

Context keys and values are case-insensitive, and will be converted to lowercase by all implementations.

Context keys and values may not be null or empty. A key/value will be deemed empty if it's length is zero, or if it consists of only space characters.

Two default ContextSet implementations are provided. MutableContextSet allows the addition and removal of context keys after construction, and ImmutableContextSet does not.

Method Summary

All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`default boolean`	`contains(@NonNull Context entry)` Returns if the `ContextSet` contains a given context pairing.
`boolean`	`contains(@NonNull String key, @NonNull String value)` Returns if the `ContextSet` contains a given context pairing.
`boolean`	`containsKey(@NonNull String key)` Returns if the `ContextSet` contains at least one value for the given key.
`default @NonNull Optional<String>`	`getAnyValue(@NonNull String key)` Returns any value from this `ContextSet` matching the key, if present.
`@NonNull Set<String>`	`getValues(@NonNull String key)` Returns a `Set` of the values mapped to the given key.
`@NonNull ImmutableContextSet`	`immutableCopy()` Returns an immutable representation of this `ContextSet`.
`boolean`	`isEmpty()` Returns if the `ContextSet` is empty.
`boolean`	`isImmutable()` Gets if this `ContextSet` is immutable.
`boolean`	`isSatisfiedBy(@NonNull ContextSet other)` Returns if this `ContextSet` is fully "satisfied" by another set.
`@NonNull Iterator<Context>`	`iterator()` Returns an `Iterator` over each of the context pairs in this set.
`@NonNull MutableContextSet`	`mutableCopy()` Creates a mutable copy of this `ContextSet`.
`int`	`size()` Gets the number of context pairs in the `ContextSet`.
`@NonNull Map<String,String>`	`toFlattenedMap()` Deprecated. because the resultant map may not contain all data in the ContextSet
`@NonNull Map<String,Set<String>>`	`toMap()` Returns a `Map` representing the current state of this `ContextSet`.
`@NonNull Set<Context>`	`toSet()` Returns a `Set` of `Context`s representing the current state of this `ContextSet`.

Methods inherited from interface java.lang.Iterable
forEach, spliterator

- Method Detail
  - isImmutable
```
boolean isImmutable()
```
    Gets if this ContextSet is immutable.
    The state of immutable instances will never change.
    
    Returns:
    
    true if the set is immutable
  - immutableCopy
```
@NonNull ImmutableContextSet immutableCopy()
```
    Returns an immutable representation of this ContextSet.
    If the set is already immutable, the same object will be returned. If the set is mutable, an immutable copy will be made.
    
    Returns:
    
    an immutable representation of this set
  - mutableCopy
```
@NonNull MutableContextSet mutableCopy()
```
    Creates a mutable copy of this ContextSet.
    A new copy is returned regardless of the mutability of this set.
    
    Returns:
    
    a mutable ContextSet
  - toSet
```
@NonNull Set<Context> toSet()
```
    Returns a Set of Contexts representing the current state of this ContextSet.
    The returned set is immutable, and is a copy of the current set. (will not update live)
    
    Returns:
    
    an immutable set
  - toMap
```
@NonNull Map<String,Set<String>> toMap()
```
    Returns a Map representing the current state of this ContextSet.
    The returned set is immutable, and is a copy of the current set. (will not update live)
    
    Returns:
    
    a map
  - toFlattenedMap
```
@Deprecated
@NonNull Map<String,String> toFlattenedMap()
```
    Deprecated. because the resultant map may not contain all data in the ContextSet
    
    Returns a Map loosely representing the current state of this ContextSet.
    The returned map is immutable, and is a copy of the current set. (will not update live)
    
    As a single context key can be mapped to multiple values, this method may not be a true representation of the set.
    
    Returns:
    
    an immutable map
  - iterator
```
@NonNull Iterator<Context> iterator()
```
    Returns an Iterator over each of the context pairs in this set.
    The returned iterator represents the state of the set at the time of creation. It is not updated as the set changes.
    
    The iterator does not support Iterator.remove() calls.
    
    Specified by:
    
    iterator in interface Iterable<Context>
    
    Returns:
    
    an iterator
  - containsKey
```
boolean containsKey(@NonNull String key)
```
    Returns if the ContextSet contains at least one value for the given key.
    
    Parameters:
    
    key - the key to check for
    
    Returns:
    
    true if the set contains a value for the key
    
    Throws:
    
    NullPointerException - if the key is null
  - getValues
```
@NonNull Set<String> getValues(@NonNull String key)
```
    Returns a Set of the values mapped to the given key.
    The returned set is immutable, and only represents the current state of the ContextSet. (will not update live)
    
    Parameters:
    
    key - the key to get values for
    
    Returns:
    
    a set of values
    
    Throws:
    
    NullPointerException - if the key is null
  - getAnyValue
```
default @NonNull Optional<String> getAnyValue(@NonNull String key)
```
    Returns any value from this ContextSet matching the key, if present.
    Note that context keys can be mapped to multiple values. Use getValues(String) to retrieve all associated values.
    
    Parameters:
    
    key - the key to find values for
    
    Returns:
    
    an optional containing any match
  - contains
```
boolean contains(@NonNull String key,
                 @NonNull String value)
```
    Returns if the ContextSet contains a given context pairing.
    
    Parameters:
    
    key - the key to look for
    
    value - the value to look for
    
    Returns:
    
    true if the set contains the context pair
    
    Throws:
    
    NullPointerException - if the key or value is null
  - contains
```
default boolean contains(@NonNull Context entry)
```
    Returns if the ContextSet contains a given context pairing.
    
    Parameters:
    
    entry - the entry to look for
    
    Returns:
    
    true if the set contains the context pair
    
    Throws:
    
    NullPointerException - if the key or value is null
  - isSatisfiedBy
```
boolean isSatisfiedBy(@NonNull ContextSet other)
```
    Returns if this ContextSet is fully "satisfied" by another set.
    For a context set to "satisfy" another, it must itself contain all of the context pairings in the other set.
    
    Mathematically, this method returns true if this set is a subset of the other.
    
    Parameters:
    
    other - the other set to check
    
    Returns:
    
    true if all entries in this set are also in the other set
  - isEmpty
```
boolean isEmpty()
```
    Returns if the ContextSet is empty.
    
    Returns:
    
    true if the set is empty
  - size
```
int size()
```
    Gets the number of context pairs in the ContextSet.
    
    Returns:
    
    the size of the set

Interface ContextSet

Method Summary

Methods inherited from interface java.lang.Iterable

Method Detail

isImmutable

immutableCopy

mutableCopy

toSet

toMap

toFlattenedMap

iterator

containsKey

getValues

getAnyValue

contains

contains

isSatisfiedBy

isEmpty

size