程序包 org.bukkit

# 接口 BanList<T>

类型参数:
  `T` - 封禁目标

所有已知子接口:
  `IpBanList`, `ProfileBanList`

public interface BanList<T>
一个封禁列表，包含了一些`封禁类型`

- ## 嵌套类概要

  嵌套类
  修饰符和类型
  接口
  说明
  `static enum`
  `BanList.Type`
  封禁类型.

- ## 方法概要

  修饰符和类型
  方法
  说明
  `@Nullable BanEntry<T>`
  `addBan(@NotNull String target, @Nullable String reason, @Nullable Date expires, @Nullable String source)`
  已过时。
  参见 `addBan(Object, String, Date, String)`
  `@Nullable BanEntry<T>`
  `addBan(T target, @Nullable String reason, @Nullable Duration duration, @Nullable String source)`
  添加一个封禁到这个列表。
  `@Nullable BanEntry<T>`
  `addBan(T target, @Nullable String reason, @Nullable Instant expires, @Nullable String source)`
  添加一个封禁到这个列表。
  `@Nullable BanEntry<T>`
  `addBan(T target, @Nullable String reason, @Nullable Date expires, @Nullable String source)`
  添加一个封禁到这个列表。
  `@NotNull Set<BanEntry>`
  `getBanEntries()`
  已过时。
  该方法返回了一个形参化类的原始使用, 推荐使用带泛型参数的 `getEntries()`
  `@Nullable BanEntry<T>`
  `getBanEntry(@NotNull String target)`
  已过时。
  参见 `getBanEntry(Object)`
  `@Nullable BanEntry<T>`
  `getBanEntry(T target)`
  根据封禁目标(IP地址或玩家资料)来获取对应的 `BanEntry`.
  `@NotNull Set<BanEntry<T>>`
  `getEntries()`
  获取此列表包含的所有`BanEntry`.
  `boolean`
  `isBanned(@NotNull String target)`
  已过时。
  参见 `isBanned(Object)`
  `boolean`
  `isBanned(T target)`
  获取此目标的封禁状态.
  `void`
  `pardon(@NotNull String target)`
  已过时。
  参见 `pardon(Object)`
  `void`
  `pardon(T target)`
  从列表中移除指定目标，因此表示“无封禁”的状态(即解除封禁).

- ## 方法详细资料

  - ### getBanEntry

    @Deprecated @Nullable @Nullable BanEntry<T> getBanEntry(@NotNull @NotNull String target)
    已过时。
    参见 `getBanEntry(Object)`
    根据封禁目标(IP地址或玩家名)来获取对应的 `BanEntry`.

    原文：Gets `BanEntry` by target.

    参数:
      `target` - 封禁目标(IP地址或玩家名)
    返回:
      对应的封禁条目, 如果没有则返回null

  - ### getBanEntry

    @Nullable @Nullable BanEntry<T> getBanEntry(@NotNull T target)
    根据封禁目标(IP地址或玩家资料)来获取对应的 `BanEntry`.

    原文:Gets a `BanEntry` by target.

    参数:
      `target` - 封禁目标(IP地址或玩家资料)
    返回:
      对应的封禁条目, 如果没有则返回null

  - ### addBan

    @Deprecated @Nullable @Nullable BanEntry<T> addBan(@NotNull @NotNull String target, @Nullable @Nullable String reason, @Nullable @Nullable Date expires, @Nullable @Nullable String source)
    已过时。
    参见 `addBan(Object, String, Date, String)`
    添加一个封禁到这个列表。如果以前的封禁存在，这将更新以前的封禁.

    原文：Adds a ban to the this list. If a previous ban exists, this will update the previous entry.

    参数:
      `target` - 封禁目标
      `reason` - 封禁理由，null则使用默认
      `expires` - 封禁的截止日期(解除封禁)，null则为永远封禁
      `source` - 封禁来源，null则使用默认
    返回:
      新创建的封禁条目，或为更新之前的封禁

  - ### addBan

    @Nullable @Nullable BanEntry<T> addBan(@NotNull T target, @Nullable @Nullable String reason, @Nullable @Nullable Date expires, @Nullable @Nullable String source)
    添加一个封禁到这个列表。如果以前的封禁存在，这将更新以前的封禁.

    原文:Adds a ban to this list. If a previous ban exists, this will update the previous entry.

    参数:
      `target` - 封禁目标
      `reason` - 封禁理由，null则使用默认
      `expires` - 封禁的截止日期(解除封禁)，null则为永远封禁
      `source` - 封禁来源，null则使用默认
    返回:
      新创建的封禁条目，或为更新之前的封禁

  - ### addBan

    @Nullable @Nullable BanEntry<T> addBan(@NotNull T target, @Nullable @Nullable String reason, @Nullable @Nullable Instant expires, @Nullable @Nullable String source)
    添加一个封禁到这个列表。如果以前的封禁存在，这将更新以前的封禁.

    原文:Adds a ban to this list. If a previous ban exists, this will update the previous entry.

    参数:
      `target` - 封禁目标
      `reason` - 封禁理由，null则使用默认
      `expires` - 封禁的截止日期(解除封禁)，null则为永远封禁
      `source` - 封禁来源，null则使用默认
    返回:
      新创建的封禁条目，或为更新之前的封禁

  - ### addBan

    @Nullable @Nullable BanEntry<T> addBan(@NotNull T target, @Nullable @Nullable String reason, @Nullable @Nullable Duration duration, @Nullable @Nullable String source)
    添加一个封禁到这个列表。如果以前的封禁存在，这将更新以前的封禁.

    原文:Adds a ban to this list. If a previous ban exists, this will update the previous entry.

    参数:
      `target` - 封禁目标
      `reason` - 封禁理由，null则使用默认
      `duration` - 封禁持续时长, null则为永远封禁
      `source` - 封禁来源，null则使用默认
    返回:
      新创建的封禁条目，或为更新之前的封禁

  - ### getBanEntries

    @Deprecated @NotNull @NotNull Set<BanEntry> getBanEntries()
    已过时。
    该方法返回了一个形参化类的原始使用, 推荐使用带泛型参数的 `getEntries()`
    获取此列表包含的所有`BanEntry`.

    原文: Gets a set containing every `BanEntry` in this list.

    返回:
      包含了通过此列表跟踪的每个BanEntry的一个不可变列表

  - ### getEntries

    @NotNull @NotNull Set<BanEntry<T>> getEntries()
    获取此列表包含的所有`BanEntry`.

    原文: Gets a set containing every `BanEntry` in this list.

    返回:
      包含了通过此列表跟踪的每个BanEntry的一个不可变列表

  - ### isBanned

    boolean isBanned(@NotNull T target)
    获取此目标的封禁状态.

    原文:Gets if a `BanEntry` exists for the target, indicating an active ban status.

    参数:
      `target` - 寻找的目标
    返回:
      如果`BanEntry`存在这个目标则表示被封禁了，否则为false

  - ### isBanned

    @Deprecated boolean isBanned(@NotNull @NotNull String target)
    已过时。
    参见 `isBanned(Object)`
    获取此目标的封禁状态.

    原文: Gets if a `BanEntry` exists for the target, indicating an active ban status.

    参数:
      `target` - 寻找的目标
    返回:
      如果`BanEntry`存在这个目标则表示被封禁了，否则为false

  - ### pardon

    void pardon(@NotNull T target)
    从列表中移除指定目标，因此表示“无封禁”的状态(即解除封禁).

    原文: Removes the specified target from this list, therefore indicating a "not banned" status.

    参数:
      `target` - 从这个列表移除的目标(解除封禁)

  - ### pardon

    @Deprecated void pardon(@NotNull @NotNull String target)
    已过时。
    参见 `pardon(Object)`
    从列表中移除指定目标，因此表示“无封禁”的状态(即解除封禁).

    原文: Removes the specified target from this list, therefore indicating a "not banned" status.

    参数:
      `target` - 从这个列表移除的目标(解除封禁)