Document and improve speed

Memory reference checks instead of .equals because it's gonna be 100% safe

Author: coderFlameyosFlow

src/main/java/me/flame/menus/menu/Result.java

@@ -1,8 +1,11 @@
 package me.flame.menus.menu;
 
 import lombok.NonNull;
+import org.jetbrains.annotations.Contract;
+import org.jetbrains.annotations.NotNull;
 
-public class Result {
+@SuppressWarnings({ "unused", "StringEquality" })
+public final class Result {
     public String result;
     private static final String DENIED = "denied";
     private static final String ALLOWED = "allowed";
@@ -14,29 +17,45 @@ private Result(String result) {
     public boolean equals(Object o) {
         if (!(o instanceof Result)) return false;
         Result r = (Result) o;
-        return result.equals(r.result);
+        return result == r.result;
     }
 
+    /**
+     * Generates a new Result object with the value DENIED.
+     *
+     * @return         	A new Result object with the value DENIED.
+     */
+    @NotNull
+    @Contract(value = " -> new", pure = true)
     public static Result denied() {
         return new Result(DENIED);
     }
 
+    /**
+     * Generates a new Result object with the value ALLOWED.
+     *
+     * @return         	A new Result object with the value ALLOWED.
+     */
+    @NotNull
+    @Contract(value = " -> new", pure = true)
     public static Result allowed() {
         return new Result(ALLOWED);
     }
 
+    /**
+     * Sets the result of the operation.
+     *
+     * @param  r the result to be set
+     */
     public void set(@NonNull Result r) {
-        String result = r.result;
-        if (!result.equals(DENIED) && !result.equals(ALLOWED))
-            throw new IllegalArgumentException(
-                    "Must be 'allowed' or 'denied'" +
-                    "\nResult = " + result +
-                    "\nFix: Change the result to 'allowed' or 'denied'"
-            );
-        this.result = result;
+        this.result = r.result;
     }
 
     public boolean isDenied() {
-        return result.equals(DENIED);
+        return result == DENIED;
+    }
+
+    public boolean isAllowed() {
+        return result == ALLOWED;
     }
 }