Moved packages to worldedit.function.*.

src/main/java/com/sk89q/worldedit/function/operation/Operation.java

@@ -0,0 +1,49 @@
+/*
+ * WorldEdit, a Minecraft world manipulation toolkit
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldEdit team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldedit.function.operation;
+
+import com.sk89q.worldedit.WorldEditException;
+
+/**
+ * An task that may be split into multiple steps to be run sequentially immediately
+ * or at a varying or fixed interval. Operations should attempt to break apart tasks
+ * into smaller tasks that can be completed in quicker successions.
+ */
+public interface Operation {
+
+    /**
+     * Complete the next step. If this method returns true, then the method may be
+     * called again in the future, or possibly never. If this method returns false,
+     * then this method should not be called again.
+     *
+     * @return another operation to run that operation again, or null to stop
+     * @throws WorldEditException an error
+     */
+    Operation resume() throws WorldEditException;
+
+    /**
+     * Abort the current task. After the this method is called, {@link #resume()} should
+     * not be called at any point in the future. This method should not be called after
+     * successful completion of the operation. This method must be called if
+     * the operation is interrupted before completion.
+     */
+    void cancel();
+
+}

src/main/java/com/sk89q/worldedit/function/operation/OperationHelper.java

@@ -0,0 +1,81 @@
+/*
+ * WorldEdit, a Minecraft world manipulation toolkit
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldEdit team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldedit.function.operation;
+
+import com.sk89q.worldedit.MaxChangedBlocksException;
+import com.sk89q.worldedit.WorldEditException;
+
+/**
+ * Operation helper methods.
+ */
+public final class OperationHelper {
+
+    private OperationHelper() {
+    }
+
+    /**
+     * Complete a given operation synchronously until it completes.
+     *
+     * @param op operation to execute
+     * @throws WorldEditException WorldEdit exception
+     */
+    public static void complete(Operation op) throws WorldEditException {
+        while (op != null) {
+            op = op.resume();
+        }
+    }
+
+    /**
+     * Complete a given operation synchronously until it completes. Catch all
+     * errors that is not {@link MaxChangedBlocksException} for legacy reasons.
+     *
+     * @param op operation to execute
+     * @throws MaxChangedBlocksException thrown when too many blocks have been changed
+     */
+    public static void completeLegacy(Operation op) throws MaxChangedBlocksException {
+        while (op != null) {
+            try {
+                op = op.resume();
+            } catch (MaxChangedBlocksException e) {
+                throw e;
+            } catch (WorldEditException e) {
+                throw new RuntimeException(e);
+            }
+        }
+    }
+
+    /**
+     * Complete a given operation synchronously until it completes. Re-throw all
+     * {@link com.sk89q.worldedit.WorldEditException} exceptions as
+     * {@link java.lang.RuntimeException}s.
+     *
+     * @param op operation to execute
+     */
+    public static void completeBlindly(Operation op) {
+        while (op != null) {
+            try {
+                op = op.resume();
+            } catch (WorldEditException e) {
+                throw new RuntimeException(e);
+            }
+        }
+    }
+
+}