package org.bukkit.block;

import org.bukkit.Nameable;
import org.bukkit.inventory.InventoryHolder;
import org.bukkit.projectiles.BlockProjectileSource;

/**
 * Represents a dispenser.
 */
public interface Dispenser extends BlockState, InventoryHolder, Lockable, Nameable {

    /**
     * Gets the BlockProjectileSource object for this dispenser.
     * <p>
     * If the block is no longer a dispenser, this will return null.
     *
     * @return a BlockProjectileSource if valid, otherwise null
     */
    public BlockProjectileSource getBlockProjectileSource();

    /**
     * Attempts to dispense the contents of this block.
     * <p>
     * If the block is no longer a dispenser, this will return false.
     *
     * @return true if successful, otherwise false
     */
    public boolean dispense();
}
