From 5a26fb2c0d899b1c80fabb39366a7b7db4d8ca41 Mon Sep 17 00:00:00 2001 From: Ben Culkin Date: Mon, 13 Apr 2020 18:32:11 -0400 Subject: Add some javadoc Add some javadoc comments --- dice/src/main/java/bjc/dicelang/dicev2/Die.java | 29 +++++++++++++++++++++++++ 1 file changed, 29 insertions(+) (limited to 'dice/src/main/java/bjc/dicelang/dicev2/Die.java') diff --git a/dice/src/main/java/bjc/dicelang/dicev2/Die.java b/dice/src/main/java/bjc/dicelang/dicev2/Die.java index d688cfa..ab4f880 100644 --- a/dice/src/main/java/bjc/dicelang/dicev2/Die.java +++ b/dice/src/main/java/bjc/dicelang/dicev2/Die.java @@ -2,6 +2,11 @@ package bjc.dicelang.dicev2; import java.util.Random; +/** + * An abstract class that represents a single pool of dice. + * @author Ben Culkin + * + */ public abstract class Die { private static final Random BASE = new Random(); @@ -15,13 +20,37 @@ public abstract class Die { rng = rnd; } + /** + * Set the RNG this die pool uses. + * @param rnd The RNG used by the die pool. + */ public void setRandom(Random rnd) { rng = rnd; } + /** + * Roll the entire die pool. + * @return The results from rolling the dice. + */ public abstract long[] roll(); + /** + * Roll a single die in the pool. + * + * For pools with multiple die, this may be somewhat arbitrary. + * @return Result from rolling a single die in the pool. + */ public abstract long rollSingle(); + /** + * Can this pool be optimized? + * @return Is the pool optimizable? + */ public abstract boolean canOptimize(); + /** + * Optimize the die pool. + * + * Is undefined if called while canOptimize is false. + * @return The optimized version of the pool. + */ public abstract long optimize(); } -- cgit v1.2.3