com.sk89q.worldguard.protection

Interface ApplicableRegionSet

All Superinterfaces:

Iterable<ProtectedRegion>

All Known Implementing Classes:

AbstractRegionSet, FailedLoadRegionSet, PermissiveRegionSet, RegionResultSet

public interface ApplicableRegionSet
extends Iterable<ProtectedRegion>

Represents the effective set of flags, owners, and members for a given spatial query.

An instance of this can be created using the spatial query methods available on RegionManager.

Method Summary

Modifier and Type	Method and Description
boolean	allows(StateFlag flag) Deprecated. use queryState(RegionAssociable, StateFlag...) instead
boolean	allows(StateFlag flag, LocalPlayer player) Deprecated. use queryState(RegionAssociable, StateFlag...) instead
boolean	canBuild(LocalPlayer player) Deprecated. use testState(RegionAssociable, StateFlag...)
boolean	canConstruct(LocalPlayer player) Deprecated. The CONSTRUCT flag is being removed and is no longer needed because flags now support groups assigned to them.
<T extends Flag<V>,V> V	getFlag(T flag) Deprecated. Use queryValue(RegionAssociable, Flag) instead. There is no difference in functionality.
<T extends Flag<V>,V> V	getFlag(T flag, LocalPlayer groupPlayer) Deprecated. Use queryValue(RegionAssociable, Flag) instead. There is no difference in functionality.
Set<ProtectedRegion>	getRegions() Get an immutable set of regions that are included in this set.
boolean	isMemberOfAll(LocalPlayer player) Test whether a player is an owner or member of all regions in this set.
boolean	isOwnerOfAll(LocalPlayer player) Test whether a player is an owner of all regions in this set.
boolean	isVirtual() Return whether this region set is a virtual set.
<V> Collection<V>	queryAllValues(RegionAssociable subject, Flag<V> flag) Get the effective values for a flag, returning a collection of all values.
StateFlag.State	queryState(RegionAssociable subject, StateFlag... flags) Get the (effective) value for a list of state flags.
<V> V	queryValue(RegionAssociable subject, Flag<V> flag) Get the effective value for a flag.
int	size() Get the number of regions that are included.
boolean	testState(RegionAssociable subject, StateFlag... flags) Test whether the (effective) value for a list of state flags equals ALLOW.

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Method Detail

isVirtual

boolean isVirtual()

Return whether this region set is a virtual set. A virtual set does not contain real results.

A virtual result may be returned if region data failed to load or there was some special exception (i.e. the region bypass permission).

Be sure to check the value of this flag if an instance of this interface is being retrieved from RegionQuery as it may return an instance of PermissiveRegionSet or FailedLoadRegionSet, among other possibilities.

Returns:

true if loaded

See Also:

FailedLoadRegionSet

canBuild

@Deprecated
boolean canBuild(LocalPlayer player)

Deprecated. use testState(RegionAssociable, StateFlag...)

Tests whether the DefaultFlag.BUILD flag or membership requirements permit the given player.

Parameters:

player - the player to check

Returns:

true if permitted

testState

boolean testState(@Nullable
                  RegionAssociable subject,
                  StateFlag... flags)

Test whether the (effective) value for a list of state flags equals ALLOW.

subject can be non-null to satisfy region group requirements, otherwise it will be assumed that the caller that is not a member of any regions. (Flags on a region can be changed so that they only apply to certain users.) The subject argument is required if the DefaultFlag.BUILD flag is in the list of flags.

Parameters:

subject - an optional subject, which would be used to determine the region groups that apply

flags - a list of flags to check

Returns:

true if the result was ALLOW

See Also:

queryState(RegionAssociable, StateFlag...)

queryState

@Nullable
StateFlag.State queryState(@Nullable
                                     RegionAssociable subject,
                                     StateFlag... flags)

Get the (effective) value for a list of state flags. The rules of states is observed here; that is, DENY overrides ALLOW, and ALLOW overrides NONE. One flag may override another.

subject can be non-null to satisfy region group requirements, otherwise it will be assumed that the caller that is not a member of any regions. (Flags on a region can be changed so that they only apply to certain users.) The subject argument is required if the DefaultFlag.BUILD flag is in the list of flags.

Parameters:

subject - an optional subject, which would be used to determine the region groups that apply

flags - a list of flags to check

Returns:

a state

queryValue

@Nullable
<V> V queryValue(@Nullable
                           RegionAssociable subject,
                           Flag<V> flag)

Get the effective value for a flag. If there are multiple values (for example, multiple overlapping regions with the same priority may have the same flag set), then the selected (or "winning") value will depend on the flag type.

Only some flag types actually have a strategy for picking the "best value." For most types, the actual value that is chosen to be returned is undefined (it could be any value). As of writing, the only type of flag that actually has a strategy for picking a value is the StateFlag.

subject can be non-null to satisfy region group requirements, otherwise it will be assumed that the caller that is not a member of any regions. (Flags on a region can be changed so that they only apply to certain users.) The subject argument is required if the DefaultFlag.BUILD flag is the flag being queried.

Parameters:

subject - an optional subject, which would be used to determine the region group to apply

flag - the flag

Returns:

a value, which could be null

queryAllValues

<V> Collection<V> queryAllValues(@Nullable
                                 RegionAssociable subject,
                                 Flag<V> flag)

Get the effective values for a flag, returning a collection of all values. It is up to the caller to determine which value, if any, from the collection will be used.

subject can be non-null to satisfy region group requirements, otherwise it will be assumed that the caller that is not a member of any regions. (Flags on a region can be changed so that they only apply to certain users.) The subject argument is required if the DefaultFlag.BUILD flag is the flag being queried.

Parameters:

subject - an optional subject, which would be used to determine the region group to apply

flag - the flag

Returns:

a collection of values

canConstruct

@Deprecated
boolean canConstruct(LocalPlayer player)

Deprecated. The CONSTRUCT flag is being removed and is no longer needed because flags now support groups assigned to them.

Test whether the construct flag evaluates true for the given player.

Parameters:

player - the player

Returns:

true if true

allows

@Deprecated
boolean allows(StateFlag flag)

Deprecated. use queryState(RegionAssociable, StateFlag...) instead

Gets the state of a state flag. This cannot be used for the build flag.

Parameters:

flag - flag to check

Returns:

whether it is allowed

Throws:

IllegalArgumentException - if the build flag is given

allows

@Deprecated
boolean allows(StateFlag flag,
                           @Nullable
                           LocalPlayer player)

Deprecated. use queryState(RegionAssociable, StateFlag...) instead

Gets the state of a state flag. This cannot be used for the build flag.

Parameters:

flag - flag to check

player - player (used by some flags)

Returns:

whether the state is allows for it

Throws:

IllegalArgumentException - if the build flag is given

isOwnerOfAll

boolean isOwnerOfAll(LocalPlayer player)

Test whether a player is an owner of all regions in this set.

Parameters:

player - the player

Returns:

whether the player is an owner of all regions

isMemberOfAll

boolean isMemberOfAll(LocalPlayer player)

Test whether a player is an owner or member of all regions in this set.

Parameters:

player - the player

Returns:

whether the player is a member of all regions

getFlag

@Deprecated
 @Nullable
<T extends Flag<V>,V> V getFlag(T flag)

Deprecated. Use queryValue(RegionAssociable, Flag) instead. There is no difference in functionality.

Gets the value of a flag. Do not use this for state flags (use allows(StateFlag, LocalPlayer) for that).

Parameters:

flag - the flag to check

Returns:

value of the flag, which may be null

getFlag

@Deprecated
 @Nullable
<T extends Flag<V>,V> V getFlag(T flag,
                                                       @Nullable
                                                       LocalPlayer groupPlayer)

Deprecated. Use queryValue(RegionAssociable, Flag) instead. There is no difference in functionality.

Gets the value of a flag. Do not use this for state flags (use allows(StateFlag, LocalPlayer) for that).

Parameters:

flag - flag to check

groupPlayer - player to check RegionGroups against

Returns:

value of the flag, which may be null

Throws:

IllegalArgumentException - if a StateFlag is given

size

int size()

Get the number of regions that are included.

Returns:

the number of contained regions

getRegions

Set<ProtectedRegion> getRegions()

Get an immutable set of regions that are included in this set.

Returns:

a set of regions