程序包 org.bukkit.material

# 类 Door

java.lang.Object
org.bukkit.material.MaterialData
org.bukkit.material.Door

所有已实现的接口:
  `Cloneable`, `Directional`, `Openable`

@Deprecated public class Door extends MaterialData implements Directional, Openable
已过时。
all usage of MaterialData is deprecated and subject to removal. Use `BlockData`.
代表门.

这个类曾被弃用，但已被重构以适用于现今的门. (然后又愉快的弃用了...) 由于Minecraft的门的内部表示，依赖于isTopHalf()的一些方法未被定义.

关于朝向：这个朝向一般是玩家放置门时他面对的方向. 比如我朝西方放置一个门，它的朝向(技术上讲它的"facing"数据值就是west)是朝西，那么关门时门轴是朝东方向转.

另请参阅:
  - `Material.LEGACY_WOODEN_DOOR`
  - `Material.LEGACY_IRON_DOOR_BLOCK`
  - `Material.LEGACY_SPRUCE_DOOR`
  - `Material.LEGACY_BIRCH_DOOR`
  - `Material.LEGACY_JUNGLE_DOOR`
  - `Material.LEGACY_ACACIA_DOOR`
  - `Material.LEGACY_DARK_OAK_DOOR`

- ## 构造器概要

  构造器
  构造器
  说明
  `Door()`
  已过时。
  遗留的旧API，相当于new `Door(Material.LEGACY_WOODEN_DOOR);`
  `Door(Material type)`
  已过时。
  `Door(Material type, boolean isHingeRight)`
  已过时。
  以指定材质和门轴的左右侧构造门的上半部分.
  `Door(Material type, byte data)`
  已过时。
  不安全的参数
  `Door(Material type, BlockFace face)`
  已过时。
  以指定材质和朝向构造门的下半部分(关着的门).
  `Door(Material type, BlockFace face, boolean isOpen)`
  已过时。
  以指定材质和朝向构造门的下半部分，并设置这个门关着还是开着.
  `Door(TreeSpecies species, boolean isHingeRight)`
  已过时。
  以指定树种和朝向构造门的上半部分，并指定门轴在左侧还是右侧.
  `Door(TreeSpecies species, BlockFace face)`
  已过时。
  以指定树种和朝向构造一个木门的下半部分(关着的门).
  `Door(TreeSpecies species, BlockFace face, boolean isOpen)`
  已过时。
  以指定树种和朝向构造门的下半部分，并设置这个门关着还是开着.

- ## 方法概要

  修饰符和类型
  方法
  说明
  `Door`
  `clone()`
  已过时。
  `BlockFace`
  `getFacing()`
  已过时。
  获取门的朝向.
  `boolean`
  `getHinge()`
  已过时。
  返回门轴在哪一侧.
  `BlockFace`
  `getHingeCorner()`
  已过时。
  不应使用此方法;请使用hinge/facing对应的getter
  `static Material`
  `getWoodDoorOfSpecies(TreeSpecies species)`
  已过时。
  返回用你给定的树种做成的木门的物品.
  `boolean`
  `isOpen()`
  已过时。
  若`isTopHalf()`为true，则得不到结果(个人猜测总得返回false).
  `boolean`
  `isTopHalf()`
  已过时。
  `void`
  `setFacingDirection(BlockFace face)`
  已过时。
  设置门的朝向.
  `void`
  `setHinge(boolean isHingeRight)`
  已过时。
  设置门轴在左侧还是右侧.左侧为false,右侧为true.
  `void`
  `setOpen(boolean isOpen)`
  已过时。
  设置门是否开着.若`isTopHalf()`为true则此方法没有效果.
  `void`
  `setTopHalf(boolean isTopHalf)`
  已过时。
  设置这个门是上半部分的还是下半部分的.
  `String`
  `toString()`
  已过时。

  ### 从类继承的方法 org.bukkit.material.MaterialData

  `equals, getData, getItemType, hashCode, setData, toItemStack, toItemStack`

  ### 从类继承的方法 java.lang.Object

  `finalize, getClass, notify, notifyAll, wait, wait, wait`

- ## 构造器详细资料

  - ### Door

    @Deprecated public Door()
    已过时。
    遗留的旧API，相当于new `Door(Material.LEGACY_WOODEN_DOOR);`

  - ### Door

    public Door(Material type)
    已过时。

  - ### Door

    public Door(Material type, BlockFace face)
    已过时。
    以指定材质和朝向构造门的下半部分(关着的门).

    原文:Constructs the bottom half of a door of the given material type, facing the specified direction and set to closed

    参数:
      `type` - 这个门是用什么材料做成的.必须和这个门的上半部分相同.
      `face` - 门的朝向.
    另请参阅:
      - `Material.LEGACY_WOODEN_DOOR`
      - `Material.LEGACY_IRON_DOOR_BLOCK`
      - `Material.LEGACY_SPRUCE_DOOR`
      - `Material.LEGACY_BIRCH_DOOR`
      - `Material.LEGACY_JUNGLE_DOOR`
      - `Material.LEGACY_ACACIA_DOOR`
      - `Material.LEGACY_DARK_OAK_DOOR`
      - `BlockFace.WEST`
      - `BlockFace.NORTH`
      - `BlockFace.EAST`
      - `BlockFace.SOUTH`

  - ### Door

    public Door(Material type, BlockFace face, boolean isOpen)
    已过时。
    以指定材质和朝向构造门的下半部分，并设置这个门关着还是开着.

    原文:Constructs the bottom half of a door of the given material type, facing the specified direction and set to open or closed

    参数:
      `type` - 这个门是用什么材料做成的.必须和这个门的上半部分相同.
      `face` - 门的朝向
      `isOpen` - 这个门是否开着
    另请参阅:
      - `Material.LEGACY_WOODEN_DOOR`
      - `Material.LEGACY_IRON_DOOR_BLOCK`
      - `Material.LEGACY_SPRUCE_DOOR`
      - `Material.LEGACY_BIRCH_DOOR`
      - `Material.LEGACY_JUNGLE_DOOR`
      - `Material.LEGACY_ACACIA_DOOR`
      - `Material.LEGACY_DARK_OAK_DOOR`
      - `BlockFace.WEST`
      - `BlockFace.NORTH`
      - `BlockFace.EAST`
      - `BlockFace.SOUTH`

  - ### Door

    public Door(Material type, boolean isHingeRight)
    已过时。
    以指定材质和门轴的左右侧构造门的上半部分.

    原文:Constructs the top half of door of the given material type and with the hinge on the left or right

    参数:
      `type` - 这个门是用什么材料做成的.必须和这个门的下半部分相同.
      `isHingeRight` - 门轴在右侧为true,在左侧为false
    另请参阅:
      - `Material.LEGACY_WOODEN_DOOR`
      - `Material.LEGACY_IRON_DOOR_BLOCK`
      - `Material.LEGACY_SPRUCE_DOOR`
      - `Material.LEGACY_BIRCH_DOOR`
      - `Material.LEGACY_JUNGLE_DOOR`
      - `Material.LEGACY_ACACIA_DOOR`
      - `Material.LEGACY_DARK_OAK_DOOR`

  - ### Door

    public Door(TreeSpecies species, BlockFace face)
    已过时。
    以指定树种和朝向构造一个木门的下半部分(关着的门).

    原文:Constructs the bottom half of a wooden door of the given species, facing the specified direction and set to closed

    参数:
      `species` - 这个木门是用什么树种做成的.必须和这个门的上半部分相同.
      `face` - 门的朝向
    另请参阅:
      - `TreeSpecies`
      - `BlockFace.WEST`
      - `BlockFace.NORTH`
      - `BlockFace.EAST`
      - `BlockFace.SOUTH`

  - ### Door

    public Door(TreeSpecies species, BlockFace face, boolean isOpen)
    已过时。
    以指定树种和朝向构造门的下半部分，并设置这个门关着还是开着.

    原文:Constructs the bottom half of a wooden door of the given species, facing the specified direction and set to open or closed

    参数:
      `species` - 这个木门是用什么树种做成的.必须和这个门的上半部分相同.
      `face` - 门的朝向
      `isOpen` - 门是否开着
    另请参阅:
      - `TreeSpecies`
      - `BlockFace.WEST`
      - `BlockFace.NORTH`
      - `BlockFace.EAST`
      - `BlockFace.SOUTH`

  - ### Door

    public Door(TreeSpecies species, boolean isHingeRight)
    已过时。
    以指定树种和朝向构造门的上半部分，并指定门轴在左侧还是右侧.

    原文:Constructs the top half of a wooden door of the given species and with the hinge on the left or right

    参数:
      `species` - 这个木门是用什么树种做成的.必须和这个门的下半部分相同.
      `isHingeRight` - 门轴在右侧为true,在左侧为false
    另请参阅:
      - `TreeSpecies`

  - ### Door

    @Deprecated public Door(Material type, byte data)
    已过时。
    不安全的参数
    参数:
      `type` - the type
      `data` - the raw data value

- ## 方法详细资料

  - ### getWoodDoorOfSpecies

    public static Material getWoodDoorOfSpecies(TreeSpecies species)
    已过时。
    返回用你给定的树种做成的木门的物品.

    原文:Returns the item type of a wooden door for the given tree species.

    参数:
      `species` - 树的物种
    返回:
      用这种树做成的木门
    另请参阅:
      - `Material.LEGACY_WOODEN_DOOR`
      - `Material.LEGACY_SPRUCE_DOOR`
      - `Material.LEGACY_BIRCH_DOOR`
      - `Material.LEGACY_JUNGLE_DOOR`
      - `Material.LEGACY_ACACIA_DOOR`
      - `Material.LEGACY_DARK_OAK_DOOR`

  - ### isOpen

    public boolean isOpen()
    已过时。
    若`isTopHalf()`为true，则得不到结果(个人猜测总得返回false).

    原文:Result is undefined if `isTopHalf()` is true.

    指定者:
      `isOpen` 在接口中 `Openable`
    返回:
      true if the door has swung counterclockwise around its hinge.

  - ### setOpen

    public void setOpen(boolean isOpen)
    已过时。
    设置门是否开着.若`isTopHalf()`为true则此方法没有效果.

    原文:Set whether the door is open. Undefined if `isTopHalf()` is true.

    指定者:
      `setOpen` 在接口中 `Openable`
    参数:
      `isOpen` - True to open the door.

  - ### isTopHalf

    public boolean isTopHalf()
    已过时。
    返回:
      这个门是否属于上半部分

  - ### setTopHalf

    public void setTopHalf(boolean isTopHalf)
    已过时。
    设置这个门是上半部分的还是下半部分的.

    原文:Configure this part of the door to be either the top or the bottom half

    参数:
      `isTopHalf` - true将设此门为上半部分的

  - ### getHingeCorner

    @Deprecated public BlockFace getHingeCorner()
    已过时。
    不应使用此方法;请使用hinge/facing对应的getter
    返回:
      BlockFace.SELF

  - ### toString

    public String toString()
    已过时。
    覆盖:
      `toString` 在类中 `MaterialData`

  - ### setFacingDirection

    public void setFacingDirection(BlockFace face)
    已过时。
    设置门的朝向. 若`isTopHalf()`为true，则没有效果.

    原文:Set the direction that this door should is facing. Undefined if `isTopHalf()` is true.

    指定者:
      `setFacingDirection` 在接口中 `Directional`
    参数:
      `face` - 朝向

  - ### getFacing

    public BlockFace getFacing()
    已过时。
    获取门的朝向. 若`isTopHalf()`为true，则没有效果.

    原文:Get the direction that this door is facing. Undefined if `isTopHalf()` is true.

    指定者:
      `getFacing` 在接口中 `Directional`
    返回:
      朝向

  - ### getHinge

    public boolean getHinge()
    已过时。
    返回门轴在哪一侧. 若`isTopHalf()`为false，则没有效果.

    原文:Returns the side of the door the hinge is on. Undefined if `isTopHalf()` is false.

    返回:
      门轴在右侧为true,在左侧为false

  - ### setHinge

    public void setHinge(boolean isHingeRight)
    已过时。
    设置门轴在左侧还是右侧.左侧为false,右侧为true. 若`isTopHalf()`为false，则没有效果.

    原文:Set whether the hinge is on the left or right side. Left is false, right is true. Undefined if `isTopHalf()` is false.

    参数:
      `isHingeRight` - 门轴在右侧为true,在左侧为false

  - ### clone

    public Door clone()
    已过时。
    覆盖:
      `clone` 在类中 `MaterialData`