Adding JMCR-Stable version

[Benchmarks_CSolver.git] / JMCR-Stable / real-world application / MyDerby-10.3 / java / engine / org / apache / derby / iapi / transaction / TransactionListener.java

diff --git a/JMCR-Stable/real-world application/MyDerby-10.3/java/engine/org/apache/derby/iapi/transaction/TransactionListener.java b/JMCR-Stable/real-world application/MyDerby-10.3/java/engine/org/apache/derby/iapi/transaction/TransactionListener.java
new file mode 100644 (file)
index 0000000..82f5905
--- /dev/null
+++ b/JMCR-Stable/real-world application/MyDerby-10.3/java/engine/org/apache/derby/iapi/transaction/TransactionListener.java
@@ -0,0 +1,60 @@
+/*\r
+\r
+   Derby - Class org.apache.derby.iapi.transaction.TransactionListener\r
+\r
+   Licensed to the Apache Software Foundation (ASF) under one or more\r
+   contributor license agreements.  See the NOTICE file distributed with\r
+   this work for additional information regarding copyright ownership.\r
+   The ASF licenses this file to You under the Apache License, Version 2.0\r
+   (the "License"); you may not use this file except in compliance with\r
+   the License.  You may obtain a copy of the License at\r
+\r
+      http://www.apache.org/licenses/LICENSE-2.0\r
+\r
+   Unless required by applicable law or agreed to in writing, software\r
+   distributed under the License is distributed on an "AS IS" BASIS,\r
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+   See the License for the specific language governing permissions and\r
+   limitations under the License.\r
+\r
+ */\r
+package org.apache.derby.iapi.transaction;\r
+\r
+import org.apache.derby.iapi.error.StandardException;\r
+\r
+/**\r
+ * An interface that must be implemented by a object that\r
+ * wants to be notified when a significant transaction event occurs.\r
+ */\r
+public interface TransactionListener {\r
+    \r
+    /**\r
+     * Notifies registered listener that the transaction\r
+     * is about to commit. Called before the commit is\r
+     * recorded and flushed to the transaction log device.\r
+     * \r
+     * @return true to remove this listener once this\r
+     * method returns.\r
+     * \r
+     * @throws StandardException If thrown the commit attempt\r
+     * will be stopped and instead the transaction will be rolled back.\r
+     */\r
+    boolean preCommit() throws StandardException;\r
+    \r
+    /**\r
+     * Notifies registered listener that the transaction\r
+     * is about to rollback. Called before any physical rollback.\r
+     * The listener will be removed from the current transaction\r
+     * once the method returns.\r
+     * \r
+     * @throws StandardException If thrown the rollback attempt\r
+     * will be stopped and instead the database will be shut down.\r
+     * \r
+     * TODO: Define behaviour on exception during rollback.\r
+     */\r
+    void preRollback() throws StandardException;\r
+\r
+    // to support statement/savepoint rollback.\r
+    // void preSavepointRollback() throws StandardException;\r
+\r
+}\r