diff --git a/jOOQ/src/main/java/org/jooq/exception/ControlFlowException.java b/jOOQ/src/main/java/org/jooq/exception/ControlFlowException.java new file mode 100644 index 0000000000..389e94cb62 --- /dev/null +++ b/jOOQ/src/main/java/org/jooq/exception/ControlFlowException.java @@ -0,0 +1,76 @@ +/** + * Copyright (c) 2009-2013, Lukas Eder, lukas.eder@gmail.com + * All rights reserved. + * + * This software is licensed to you under the Apache License, Version 2.0 + * (the "License"); You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * + * . Redistributions of source code must retain the above copyright notice, this + * list of conditions and the following disclaimer. + * + * . Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * + * . Neither the name "jOOQ" nor the names of its contributors may be + * used to endorse or promote products derived from this software without + * specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE + * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. + */ +package org.jooq.exception; + +import org.jooq.ExecuteListener; +import org.jooq.UpdatableRecord; + +/** + * An exception that is used to influence control flows. + *
+ * There are some specific cases, where control flows can be aborted or + * otherwise influenced using well-defined exceptions. Some examples where this + * can be very useful: + *
+ * Typically, a ControlFlowException is thrown from within an
+ * {@link ExecuteListener}.
+ *
+ * @author Lukas Eder
+ * @see ExecuteListener
+ */
+public class ControlFlowException extends RuntimeException {
+
+ /**
+ * Generated UID
+ */
+ private static final long serialVersionUID = -3269663230218616147L;
+
+ /**
+ * Create a new ControlFlowException.
+ */
+ public ControlFlowException() {}
+
+ /**
+ * Create a new ControlFlowException.
+ */
+ public ControlFlowException(String message) {
+ super(message);
+ }
+}
diff --git a/jOOQ/src/main/java/org/jooq/impl/BatchCRUD.java b/jOOQ/src/main/java/org/jooq/impl/BatchCRUD.java
index 8356fe2fb3..8ee2dba808 100644
--- a/jOOQ/src/main/java/org/jooq/impl/BatchCRUD.java
+++ b/jOOQ/src/main/java/org/jooq/impl/BatchCRUD.java
@@ -51,6 +51,7 @@ import org.jooq.DSLContext;
import org.jooq.ExecuteContext;
import org.jooq.Query;
import org.jooq.UpdatableRecord;
+import org.jooq.exception.ControlFlowException;
import org.jooq.exception.DataAccessException;
/**
@@ -270,12 +271,12 @@ class BatchCRUD implements Batch {
}
/**
- * A query execution interception signal
+ * A query execution interception signal.
*
* This exception is used as a signal for jOOQ's internals to abort query - * execution, and return generated SQL back to batch execution + * execution, and return generated SQL back to batch execution. */ - private static class QueryCollectorException extends RuntimeException { + private static class QueryCollectorException extends ControlFlowException { /** * Generated UID