Add H2 utils

DEV.md

@@ -29,8 +29,10 @@ git push  --atomic origin main $VERSION
 
 # TODOs
 
+- matrix of supported features (or require an implicit.. e.g. Supports[ReturningGeneratedColumns])
 - update scastie!
-- more tutorials
+- write tutorials
 - privatize stuff
-- test more databases
+- neo4j
+- cassandra
 - sql parser reorders OFFSET LIMIT ???

build.sc

@@ -18,6 +18,7 @@ object squery extends CommonScalaModule with SqueryPublishModule {
       ivy"ch.qos.logback:logback-classic:1.4.6",
       ivy"org.scalameta::munit:1.0.0-M7",
       ivy"com.zaxxer:HikariCP:4.0.3",
+      ivy"com.h2database:h2:2.1.214",
       ivy"org.testcontainers:testcontainers:1.17.6",
       ivy"org.testcontainers:postgresql:1.17.6",
       ivy"org.postgresql:postgresql:42.5.4",

docs/src/files/howtos/HowToPage.scala

@@ -4,7 +4,6 @@ import utils.*
 import Bundle.*
 
 // TODO how to map flat result to List[stuff] groupByOrdered :)
-// TODO transactions
 
 trait HowToPage extends DocPage {
 
@@ -22,7 +21,8 @@ trait HowToPage extends DocPage {
     InterpolateValues,
     InterpolateQueries,
     DynamicQueries,
-    Transactions
+    Transactions,
+    MapToObject
   )
 
   override def pageCategory = Some("How-Tos")

docs/src/files/howtos/MapToObject.scala

@@ -0,0 +1,48 @@
+package files.howtos
+
+import utils.*
+import Bundle.*, Tags.*
+
+object MapToObject extends HowToPage {
+
+  override def pageSettings =
+    super.pageSettings.withTitle("Map Results To Objects")
+
+  override def blogSettings =
+    super.blogSettings.withSections(firstSection)
+
+  val firstSection = Section(
+    "How To Map Flat Rows To Objects",
+    frag(
+      s"""
+      You can do arbitrary SQL commands here.  
+      The most common one is `UPDATE`-ing some rows:
+      ```scala
+      // returns number of affected rows
+      def updateCustomers: Int = ctx.run {
+        sql${Consts.tq}
+          UPDATE customers
+          SET name = 'whatever'
+          WHERE name LIKE 'xyz_%'
+        ${Consts.tq}.update()
+      }
+      ```
+
+      ---
+
+      But of course you can do other commands as well:
+      ```scala
+      def createTable: Unit = ctx.run {
+        sql${Consts.tq}
+          CREATE TABLE customers(
+            id SERIAL PRIMARY KEY,
+            name VARCHAR
+          )
+        ${Consts.tq}.update()
+      }
+      ```
+
+      """.md
+    )
+  )
+}

examples/cli/hello.sc

@@ -1,5 +1,5 @@
 //> using scala "3.3.1"
-//> using dep "ba.sake::squery:0.1.0"
+//> using dep "ba.sake::squery:0.2.0"
 //> using dep "com.h2database:h2:2.1.214"
 //> using dep "com.lihaoyi::pprint:0.8.1"
 

squery/src/ba/sake/squery/h2/reads.scala

@@ -0,0 +1,13 @@
+package ba.sake.squery.h2
+
+import java.{sql => jsql}
+import java.util.UUID
+import ba.sake.squery.read.*
+
+given SqlRead[UUID] with {
+  def readByName(jRes: jsql.ResultSet, colName: String): Option[UUID] =
+    Option(jRes.getObject(colName, classOf[UUID]))
+
+  def readByIdx(jRes: jsql.ResultSet, colIdx: Int): Option[UUID] =
+    Option(jRes.getObject(colIdx, classOf[UUID]))
+}

squery/src/ba/sake/squery/h2/writes.scala

@@ -0,0 +1,15 @@
+package ba.sake.squery.h2
+
+import java.{sql => jsql}
+import java.util.UUID
+import ba.sake.squery.write.*
+
+given SqlWrite[UUID] with {
+  def write(
+      ps: jsql.PreparedStatement,
+      idx: Int,
+      valueOpt: Option[UUID]
+  ): Unit = valueOpt match
+    case Some(value) => ps.setObject(idx, value)
+    case None        => ps.setNull(idx, jsql.Types.OTHER)
+}