Rename Fish to FishHook. Fixes BUKKIT-3856

"Fish" is a badly named class to represent a fishing hook due to the
possibility (or lack of) that Minecraft may be getting fish entities.

This commit provides potential future compatibility by deprecating the
existing Fish class and moving the methods to a new class: FishHook.
This commit is contained in:
riking 2013-04-01 13:30:47 -07:00 committed by turt2live
parent 31cb1e6df5
commit f0ab5b0aec
2 changed files with 30 additions and 23 deletions

View file

@ -2,28 +2,7 @@ package org.bukkit.entity;
/**
* Represents a fishing hook.
* @deprecated in favor of {@link FishHook}
*/
public interface Fish extends Projectile {
/**
* Gets the chance of a fish biting.
* <p>
* 0.0 = No Chance.<br>
* 1.0 = Instant catch.
*
* @return chance the bite chance
*/
public double getBiteChance();
/**
* Sets the chance of a fish biting.
* <p>
* 0.0 = No Chance.<br>
* 1.0 = Instant catch.
*
* @param chance the bite chance
* @throws IllegalArgumentException if the bite chance is not between 0
* and 1
*/
public void setBiteChance(double chance) throws IllegalArgumentException;
public interface Fish extends FishHook {
}

View file

@ -0,0 +1,28 @@
package org.bukkit.entity;
/**
* Represents a fishing hook.
*/
public interface FishHook extends Projectile {
/**
* Gets the chance of a fish biting.
* <p>
* 0.0 = No Chance.<br>
* 1.0 = Instant catch.
*
* @return chance the bite chance
*/
public double getBiteChance();
/**
* Sets the chance of a fish biting.
* <p>
* 0.0 = No Chance.<br>
* 1.0 = Instant catch.
*
* @param chance the bite chance
* @throws IllegalArgumentException if the bite chance is not between 0
* and 1
*/
public void setBiteChance(double chance) throws IllegalArgumentException;
}