Merge pull request #106 from seancorfield/next.jdbc

Add next.jdbc examples

Author: tomekw

.gitignore

@@ -15,3 +15,5 @@ pom.xml.asc
 .clj-kondo/
 .eastwood
 .cpcache/
+.calva/mcp-server/port
+.portal/vs-code.edn

README.md

@@ -106,7 +106,10 @@ Custom translations of properties can be added by extending the
 ```clojure
 (ns hikari-cp.example
   (:require [hikari-cp.core :refer :all]
-            [clojure.java.jdbc :as jdbc]))
+            ;; with clojure.java.jdbc:
+            [clojure.java.jdbc :as jdbc]
+            ;; or with next.jdbc:
+            [next.jdbc :as nj]))
 
 (def datasource-options {:allow-pool-suspension false
                          :auto-commit           true
@@ -129,29 +132,49 @@ Custom translations of properties can be added by extending the
 (defonce datasource
   (delay (make-datasource datasource-options)))
 
+;; clojure.java.jdbc:
 (defn -main [& args]
   (jdbc/with-db-connection [conn {:datasource @datasource}]
     (let [rows (jdbc/query conn "SELECT 0")]
       (println rows)
       (println (is-running? @datasource))))
   (close-datasource @datasource)
   (println (is-closed? @datasource)))
+
+;; next.jdbc:
+(defn -main [& args]
+  (with-open [conn (nj/get-connection @datasource)]
+    (let [rows (nj/execute! conn ["SELECT 0"])]
+      (println rows)
+      (println (is-running? @datasource))))
+  (close-datasource @datasource)
+  (println (is-closed? @datasource)))
 ```
 ### Neo4j
 
 ```clojure
 (ns hikari-cp.example
   (:require [hikari-cp.core :refer :all]
-            [clojure.java.jdbc :as jdbc]))
+            ;; with clojure.java.jdbc:
+            [clojure.java.jdbc :as jdbc]
+            ;; or with next.jdbc:
+            [next.jdbc :as nj]))
 
 (def datasource-options {:jdbc-url "jdbc:neo4j:bolt://host:port/?username=neo4j&password=xxxx&debug=true"})
 
 (defonce datasource
   (delay (make-datasource datasource-options)))
 
+;; clojure.java.jdbc:
 (defn -main [& args]
   (jdbc/with-db-connection [conn {:datasource @datasource}]
     (let [rows (jdbc/query conn ["MATCH (n:Foo) WHERE n.name = ? RETURN n" "john"])]
+      (println rows))))
+
+;; next.jdbc:
+(defn -main [& args]
+  (with-open [conn (nj/get-connection @datasource)]
+    (let [rows (nj/execute! conn ["MATCH (n:Foo) WHERE n.name = ? RETURN n" "john"])]
       (println rows)))
   (close-datasource @datasource))
 ```
@@ -167,7 +190,10 @@ Custom translations of properties can be added by extending the
 ```clojure
 (ns hikari-cp.example
   (:require [hikari-cp.core :refer :all]
-            [clojure.java.jdbc :as jdbc]))
+            ;; with clojure.java.jdbc:
+            [clojure.java.jdbc :as jdbc]
+            ;; or with next.jdbc:
+            [next.jdbc :as nj]))
 
 (def datasource-options {:username      "username"
                          :password      "password"
@@ -180,19 +206,30 @@ Custom translations of properties can be added by extending the
 (defonce datasource
   (delay (make-datasource datasource-options)))
 
+;; clojure.java.jdbc:
 (defn -main [& args]
   (jdbc/with-db-connection [conn {:datasource @datasource}]
     (let [rows (jdbc/query conn "SELECT 0 FROM dual")]
       (println rows)))
   (close-datasource @datasource))
+
+;; next.jdbc:
+(defn -main [& args]
+  (with-open [conn (nj/get-connection @datasource)]
+    (let [rows (nj/execute! conn ["SELECT 0 FROM dual"])]
+      (println rows)))
+  (close-datasource @datasource))
 ```
 
 ### Sybase example
 
 ```clojure
 (ns hikari-cp.example
   (:require [hikari-cp.core :refer :all]
-            [clojure.java.jdbc :as jdbc]))
+            ;; with clojure.java.jdbc:
+            [clojure.java.jdbc :as jdbc]
+            ;; or with next.jdbc:
+            [next.jdbc :as nj]))
 
 (def datasource-options {:username      "username"
                          :password      "password"
@@ -209,11 +246,19 @@ Custom translations of properties can be added by extending the
 (defonce datasource
   (delay (make-datasource datasource-options)))
 
+;; clojure.java.jdbc:
 (defn -main [& args]
   (jdbc/with-db-connection [conn {:datasource @datasource}]
     (let [rows (jdbc/query conn "SELECT 0")]
       (println rows)))
   (close-datasource @datasource))
+
+;; next.jdbc:
+(defn -main [& args]
+  (with-open [conn (nj/get-connection @datasource)]
+    (let [rows (nj/execute! conn ["SELECT 0"])]
+      (println rows)))
+  (close-datasource @datasource))
 ```
 
 ### SQLite example

deps.edn

@@ -9,6 +9,7 @@
   {:extra-paths ["test" "dev"]
    :extra-deps {org.slf4j/slf4j-nop {:mvn/version "2.0.17"}
                 org.clojure/java.jdbc {:mvn/version "0.7.12"}
+                com.github.seancorfield/next.jdbc {:mvn/version "1.3.1086"}
                 com.h2database/h2 {:mvn/version "2.4.240"}
                 com.mysql/mysql-connector-j {:mvn/version "9.5.0"}
                 org.neo4j.driver/neo4j-java-driver {:mvn/version "6.0.2"}