]> source.dussan.org Git - iciql.git/commitdiff
Implement auto-closable interface on Db
authorJames Moger <james.moger@gitblit.com>
Thu, 30 Oct 2014 13:40:21 +0000 (09:40 -0400)
committerJames Moger <james.moger@gitblit.com>
Thu, 30 Oct 2014 13:40:21 +0000 (09:40 -0400)
src/main/java/com/iciql/Db.java
src/main/java/java/lang/AutoCloseable.java [new file with mode: 0644]

index 179b18d54eb173f22d95ab784ba6a7a3edc6c9c8..ebcd3525083d39baab40066e38739f4e8edd989a 100644 (file)
@@ -51,7 +51,7 @@ import com.iciql.util.WeakIdentityHashMap;
  * This class represents a connection to a database.\r
  */\r
 \r
-public class Db {\r
+public class Db implements AutoCloseable {\r
 \r
        /**\r
         * This map It holds unique tokens that are generated by functions such as\r
@@ -458,6 +458,7 @@ public class Db {
                return conn;\r
        }\r
 \r
+       @Override\r
        public void close() {\r
                try {\r
                        conn.close();\r
diff --git a/src/main/java/java/lang/AutoCloseable.java b/src/main/java/java/lang/AutoCloseable.java
new file mode 100644 (file)
index 0000000..2141fbc
--- /dev/null
@@ -0,0 +1,58 @@
+/*
+ * Copyright (c) 2009, 2011, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code 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
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+package java.lang;
+
+/**
+ * A resource that must be closed when it is no longer needed.
+ *
+ * @author Josh Bloch
+ * @since 1.7
+ */
+public interface AutoCloseable {
+    /**
+     * Closes this resource, relinquishing any underlying resources.
+     * This method is invoked automatically by the {@code
+     * try}-with-resources statement.
+     *
+     * <p>Classes implementing this method are strongly encouraged to
+     * be declared to throw more specific exceptions (or no exception
+     * at all, if the close cannot fail).
+     *
+     * <p>Note that unlike the {@link java.io.Closeable#close close}
+     * method of {@link java.io.Closeable}, this {@code close} method
+     * is <em>not</em> required to be idempotent.  In other words,
+     * calling this {@code close} method more than once may have some
+     * visible side effect, unlike {@code Closeable.close} which is
+     * required to have no effect if called more than once.
+     *
+     * However, while not required to be idempotent, implementers of
+     * this interface are strongly encouraged to make their {@code
+     * close} methods idempotent.
+     *
+     * @throws Exception if this resource cannot be closed
+     */
+    void close() throws Exception;
+}
\ No newline at end of file