src/Pure/General/sql.scala
author wenzelm
Tue May 02 10:25:27 2017 +0200 (2017-05-02)
changeset 65677 7d25b8dbdbfa
parent 65673 9cd66d9c3863
child 65690 74ec3cfcb6bf
permissions -rw-r--r--
proper quote (amending 546020a98a91): e.g. relevant for "ISABELLE_BUILD_OPTIONS";
wenzelm@63788
     1
/*  Title:      Pure/General/sql.scala
wenzelm@63778
     2
    Author:     Makarius
wenzelm@63778
     3
wenzelm@65006
     4
Support for SQL databases: SQLite and PostgreSQL.
wenzelm@63778
     5
*/
wenzelm@63778
     6
wenzelm@63778
     7
package isabelle
wenzelm@63778
     8
wenzelm@65021
     9
import java.time.OffsetDateTime
wenzelm@65021
    10
import java.sql.{DriverManager, Connection, PreparedStatement, ResultSet}
wenzelm@63779
    11
wenzelm@63779
    12
wenzelm@63778
    13
object SQL
wenzelm@63778
    14
{
wenzelm@65006
    15
  /** SQL language **/
wenzelm@65006
    16
wenzelm@63778
    17
  /* concrete syntax */
wenzelm@63778
    18
wenzelm@65321
    19
  def escape_char(c: Char): String =
wenzelm@63778
    20
    c match {
wenzelm@63778
    21
      case '\u0000' => "\\0"
wenzelm@63778
    22
      case '\'' => "\\'"
wenzelm@63778
    23
      case '\"' => "\\\""
wenzelm@63778
    24
      case '\b' => "\\b"
wenzelm@63778
    25
      case '\n' => "\\n"
wenzelm@63778
    26
      case '\r' => "\\r"
wenzelm@63778
    27
      case '\t' => "\\t"
wenzelm@63778
    28
      case '\u001a' => "\\Z"
wenzelm@63778
    29
      case '\\' => "\\\\"
wenzelm@63778
    30
      case _ => c.toString
wenzelm@63778
    31
    }
wenzelm@63778
    32
wenzelm@65648
    33
  def string(s: String): String =
wenzelm@65321
    34
    "'" + s.map(escape_char(_)).mkString + "'"
wenzelm@63778
    35
wenzelm@65672
    36
  def identifer(s: String): String =
wenzelm@65677
    37
    Long_Name.implode(Long_Name.explode(s).map(a => quote(a.replace("\"", "\"\""))))
wenzelm@63779
    38
wenzelm@65668
    39
  def enclose(s: String): String = "(" + s + ")"
wenzelm@63791
    40
  def enclosure(ss: Iterable[String]): String = ss.mkString("(", ", ", ")")
wenzelm@63791
    41
wenzelm@65644
    42
  def select(columns: List[Column], distinct: Boolean = false): String =
wenzelm@65649
    43
    "SELECT " + (if (distinct) "DISTINCT " else "") + commas(columns.map(_.sql)) + " FROM "
wenzelm@65644
    44
wenzelm@65668
    45
  def join(table1: Table, table2: Table, sql: String = "", outer: Boolean = false): String =
wenzelm@65668
    46
    table1.sql + (if (outer) " LEFT OUTER JOIN " else " INNER JOIN ") + table2.sql +
wenzelm@65668
    47
      (if (sql == "") "" else " ON " + sql)
wenzelm@65668
    48
wenzelm@65668
    49
  def join_outer(table1: Table, table2: Table, sql: String = ""): String =
wenzelm@65668
    50
    join(table1, table2, sql, outer = true)
wenzelm@65668
    51
wenzelm@63779
    52
wenzelm@65008
    53
  /* types */
wenzelm@65008
    54
wenzelm@65008
    55
  object Type extends Enumeration
wenzelm@65008
    56
  {
wenzelm@65011
    57
    val Boolean = Value("BOOLEAN")
wenzelm@65008
    58
    val Int = Value("INTEGER")
wenzelm@65008
    59
    val Long = Value("BIGINT")
wenzelm@65008
    60
    val Double = Value("DOUBLE PRECISION")
wenzelm@65008
    61
    val String = Value("TEXT")
wenzelm@65008
    62
    val Bytes = Value("BLOB")
wenzelm@65014
    63
    val Date = Value("TIMESTAMP WITH TIME ZONE")
wenzelm@65008
    64
  }
wenzelm@65008
    65
wenzelm@65019
    66
  def sql_type_default(T: Type.Value): String = T.toString
wenzelm@65013
    67
wenzelm@65019
    68
  def sql_type_sqlite(T: Type.Value): String =
wenzelm@65019
    69
    if (T == Type.Boolean) "INTEGER"
wenzelm@65019
    70
    else if (T == Type.Date) "TEXT"
wenzelm@65019
    71
    else sql_type_default(T)
wenzelm@65013
    72
wenzelm@65019
    73
  def sql_type_postgresql(T: Type.Value): String =
wenzelm@65019
    74
    if (T == Type.Bytes) "BYTEA"
wenzelm@65019
    75
    else sql_type_default(T)
wenzelm@65008
    76
wenzelm@65008
    77
wenzelm@63779
    78
  /* columns */
wenzelm@63779
    79
wenzelm@65669
    80
  trait Qualifier
wenzelm@65669
    81
  {
wenzelm@65669
    82
    def name: String
wenzelm@65669
    83
  }
wenzelm@65669
    84
wenzelm@63779
    85
  object Column
wenzelm@63779
    86
  {
wenzelm@65280
    87
    def bool(name: String, strict: Boolean = false, primary_key: Boolean = false): Column =
wenzelm@65018
    88
      Column(name, Type.Boolean, strict, primary_key)
wenzelm@65280
    89
    def int(name: String, strict: Boolean = false, primary_key: Boolean = false): Column =
wenzelm@65018
    90
      Column(name, Type.Int, strict, primary_key)
wenzelm@65280
    91
    def long(name: String, strict: Boolean = false, primary_key: Boolean = false): Column =
wenzelm@65018
    92
      Column(name, Type.Long, strict, primary_key)
wenzelm@65280
    93
    def double(name: String, strict: Boolean = false, primary_key: Boolean = false): Column =
wenzelm@65018
    94
      Column(name, Type.Double, strict, primary_key)
wenzelm@65280
    95
    def string(name: String, strict: Boolean = false, primary_key: Boolean = false): Column =
wenzelm@65018
    96
      Column(name, Type.String, strict, primary_key)
wenzelm@65280
    97
    def bytes(name: String, strict: Boolean = false, primary_key: Boolean = false): Column =
wenzelm@65018
    98
      Column(name, Type.Bytes, strict, primary_key)
wenzelm@65280
    99
    def date(name: String, strict: Boolean = false, primary_key: Boolean = false): Column =
wenzelm@65018
   100
      Column(name, Type.Date, strict, primary_key)
wenzelm@63779
   101
  }
wenzelm@63779
   102
wenzelm@65018
   103
  sealed case class Column(
wenzelm@65280
   104
    name: String, T: Type.Value, strict: Boolean = false, primary_key: Boolean = false)
wenzelm@63779
   105
  {
wenzelm@65669
   106
    def apply(qual: Qualifier): Column =
wenzelm@65669
   107
      Column(Long_Name.qualify(qual.name, name), T, strict = strict, primary_key = primary_key)
wenzelm@65644
   108
wenzelm@65672
   109
    def sql: String = identifer(name)
wenzelm@65019
   110
    def sql_decl(sql_type: Type.Value => String): String =
wenzelm@65673
   111
      identifer(name) + " " + sql_type(T) + (if (strict || primary_key) " NOT NULL" else "")
wenzelm@63781
   112
wenzelm@65673
   113
    def sql_where_eq: String = "WHERE " + identifer(name) + " = "
wenzelm@65648
   114
    def sql_where_equal(s: String): String = sql_where_eq + string(s)
wenzelm@65593
   115
wenzelm@65019
   116
    override def toString: String = sql_decl(sql_type_default)
wenzelm@63779
   117
  }
wenzelm@63779
   118
wenzelm@63780
   119
wenzelm@63780
   120
  /* tables */
wenzelm@63780
   121
wenzelm@65669
   122
  sealed case class Table(name: String, columns: List[Column]) extends Qualifier
wenzelm@63780
   123
  {
wenzelm@63790
   124
    private val columns_index: Map[String, Int] =
wenzelm@63790
   125
      columns.iterator.map(_.name).zipWithIndex.toMap
wenzelm@63790
   126
wenzelm@63781
   127
    Library.duplicates(columns.map(_.name)) match {
wenzelm@63781
   128
      case Nil =>
wenzelm@63781
   129
      case bad => error("Duplicate column names " + commas_quote(bad) + " for table " + quote(name))
wenzelm@63781
   130
    }
wenzelm@63781
   131
wenzelm@65672
   132
    def sql: String = identifer(name)
wenzelm@65649
   133
wenzelm@65325
   134
    def sql_columns(sql_type: Type.Value => String): String =
wenzelm@65325
   135
    {
wenzelm@65325
   136
      val primary_key =
wenzelm@65325
   137
        columns.filter(_.primary_key).map(_.name) match {
wenzelm@65325
   138
          case Nil => Nil
wenzelm@65325
   139
          case keys => List("PRIMARY KEY " + enclosure(keys))
wenzelm@65325
   140
        }
wenzelm@65325
   141
      enclosure(columns.map(_.sql_decl(sql_type)) ::: primary_key)
wenzelm@63781
   142
    }
wenzelm@63781
   143
wenzelm@65327
   144
    def sql_create(strict: Boolean, sql_type: Type.Value => String): String =
wenzelm@63784
   145
      "CREATE TABLE " + (if (strict) "" else "IF NOT EXISTS ") +
wenzelm@65672
   146
        identifer(name) + " " + sql_columns(sql_type)
wenzelm@63780
   147
wenzelm@63780
   148
    def sql_drop(strict: Boolean): String =
wenzelm@65672
   149
      "DROP TABLE " + (if (strict) "" else "IF EXISTS ") + identifer(name)
wenzelm@63783
   150
wenzelm@63791
   151
    def sql_create_index(
wenzelm@65018
   152
        index_name: String, index_columns: List[Column],
wenzelm@63791
   153
        strict: Boolean, unique: Boolean): String =
wenzelm@63791
   154
      "CREATE " + (if (unique) "UNIQUE " else "") + "INDEX " +
wenzelm@65672
   155
        (if (strict) "" else "IF NOT EXISTS ") + identifer(index_name) + " ON " +
wenzelm@65672
   156
        identifer(name) + " " + enclosure(index_columns.map(_.name))
wenzelm@63791
   157
wenzelm@63791
   158
    def sql_drop_index(index_name: String, strict: Boolean): String =
wenzelm@65672
   159
      "DROP INDEX " + (if (strict) "" else "IF EXISTS ") + identifer(index_name)
wenzelm@63791
   160
wenzelm@63790
   161
    def sql_insert: String =
wenzelm@65672
   162
      "INSERT INTO " + identifer(name) + " VALUES " + enclosure(columns.map(_ => "?"))
wenzelm@63791
   163
wenzelm@65319
   164
    def sql_delete: String =
wenzelm@65672
   165
      "DELETE FROM " + identifer(name)
wenzelm@65319
   166
wenzelm@65644
   167
    def sql_select(select_columns: List[Column], distinct: Boolean = false): String =
wenzelm@65672
   168
      select(select_columns, distinct = distinct) + identifer(name)
wenzelm@63790
   169
wenzelm@63783
   170
    override def toString: String =
wenzelm@65672
   171
      "TABLE " + identifer(name) + " " + sql_columns(sql_type_default)
wenzelm@63780
   172
  }
wenzelm@63790
   173
wenzelm@63790
   174
wenzelm@65669
   175
  /* views */
wenzelm@65669
   176
wenzelm@65669
   177
  sealed case class View(name: String, columns: List[Column]) extends Qualifier
wenzelm@65669
   178
  {
wenzelm@65672
   179
    def sql: String = identifer(name)
wenzelm@65672
   180
    def sql_create(query: String): String = "CREATE VIEW " + identifer(name) + " AS " + query
wenzelm@65669
   181
    override def toString: String =
wenzelm@65672
   182
      "VIEW " + identifer(name) + " " + enclosure(columns.map(_.sql_decl(sql_type_default)))
wenzelm@65669
   183
  }
wenzelm@65669
   184
wenzelm@65012
   185
wenzelm@65012
   186
  /** SQL database operations **/
wenzelm@65012
   187
wenzelm@63790
   188
  /* results */
wenzelm@63790
   189
wenzelm@63790
   190
  def iterator[A](rs: ResultSet)(get: ResultSet => A): Iterator[A] = new Iterator[A]
wenzelm@63790
   191
  {
wenzelm@63790
   192
    private var _next: Boolean = rs.next()
wenzelm@63790
   193
    def hasNext: Boolean = _next
wenzelm@63790
   194
    def next: A = { val x = get(rs); _next = rs.next(); x }
wenzelm@63790
   195
  }
wenzelm@65006
   196
wenzelm@65006
   197
  trait Database
wenzelm@65006
   198
  {
wenzelm@65008
   199
    /* types */
wenzelm@65008
   200
wenzelm@65019
   201
    def sql_type(T: Type.Value): String
wenzelm@65008
   202
wenzelm@65008
   203
wenzelm@65006
   204
    /* connection */
wenzelm@65006
   205
wenzelm@65006
   206
    def connection: Connection
wenzelm@65006
   207
wenzelm@65006
   208
    def close() { connection.close }
wenzelm@65006
   209
wenzelm@65006
   210
    def transaction[A](body: => A): A =
wenzelm@65006
   211
    {
wenzelm@65006
   212
      val auto_commit = connection.getAutoCommit
wenzelm@65006
   213
      try {
wenzelm@65006
   214
        connection.setAutoCommit(false)
wenzelm@65022
   215
        val savepoint = connection.setSavepoint
wenzelm@65022
   216
        try {
wenzelm@65022
   217
          val result = body
wenzelm@65022
   218
          connection.commit
wenzelm@65022
   219
          result
wenzelm@65022
   220
        }
wenzelm@65022
   221
        catch { case exn: Throwable => connection.rollback(savepoint); throw exn }
wenzelm@65006
   222
      }
wenzelm@65006
   223
      finally { connection.setAutoCommit(auto_commit) }
wenzelm@65006
   224
    }
wenzelm@65006
   225
wenzelm@65006
   226
wenzelm@65006
   227
    /* statements */
wenzelm@65006
   228
wenzelm@65006
   229
    def statement(sql: String): PreparedStatement = connection.prepareStatement(sql)
wenzelm@65006
   230
wenzelm@65619
   231
    def insert(table: Table): PreparedStatement = statement(table.sql_insert)
wenzelm@65006
   232
wenzelm@65619
   233
    def delete(table: Table, sql: String = ""): PreparedStatement =
wenzelm@65319
   234
      statement(table.sql_delete + (if (sql == "") "" else " " + sql))
wenzelm@65319
   235
wenzelm@65619
   236
    def select(table: Table, columns: List[Column], sql: String = "", distinct: Boolean = false)
wenzelm@65619
   237
        : PreparedStatement =
wenzelm@65644
   238
      statement(table.sql_select(columns, distinct = distinct) + (if (sql == "") "" else " " + sql))
wenzelm@65006
   239
wenzelm@65006
   240
wenzelm@65020
   241
    /* input */
wenzelm@65020
   242
wenzelm@65020
   243
    def set_bool(stmt: PreparedStatement, i: Int, x: Boolean) { stmt.setBoolean(i, x) }
wenzelm@65612
   244
    def set_bool(stmt: PreparedStatement, i: Int, x: Option[Boolean])
wenzelm@65612
   245
    {
wenzelm@65612
   246
      if (x.isDefined) set_bool(stmt, i, x.get)
wenzelm@65612
   247
      else stmt.setNull(i, java.sql.Types.BOOLEAN)
wenzelm@65612
   248
    }
wenzelm@65615
   249
wenzelm@65020
   250
    def set_int(stmt: PreparedStatement, i: Int, x: Int) { stmt.setInt(i, x) }
wenzelm@65612
   251
    def set_int(stmt: PreparedStatement, i: Int, x: Option[Int])
wenzelm@65612
   252
    {
wenzelm@65612
   253
      if (x.isDefined) set_int(stmt, i, x.get)
wenzelm@65612
   254
      else stmt.setNull(i, java.sql.Types.INTEGER)
wenzelm@65612
   255
    }
wenzelm@65615
   256
wenzelm@65020
   257
    def set_long(stmt: PreparedStatement, i: Int, x: Long) { stmt.setLong(i, x) }
wenzelm@65612
   258
    def set_long(stmt: PreparedStatement, i: Int, x: Option[Long])
wenzelm@65612
   259
    {
wenzelm@65612
   260
      if (x.isDefined) set_long(stmt, i, x.get)
wenzelm@65612
   261
      else stmt.setNull(i, java.sql.Types.BIGINT)
wenzelm@65612
   262
    }
wenzelm@65615
   263
wenzelm@65020
   264
    def set_double(stmt: PreparedStatement, i: Int, x: Double) { stmt.setDouble(i, x) }
wenzelm@65612
   265
    def set_double(stmt: PreparedStatement, i: Int, x: Option[Double])
wenzelm@65612
   266
    {
wenzelm@65612
   267
      if (x.isDefined) set_double(stmt, i, x.get)
wenzelm@65612
   268
      else stmt.setNull(i, java.sql.Types.DOUBLE)
wenzelm@65612
   269
    }
wenzelm@65615
   270
wenzelm@65020
   271
    def set_string(stmt: PreparedStatement, i: Int, x: String) { stmt.setString(i, x) }
wenzelm@65615
   272
    def set_string(stmt: PreparedStatement, i: Int, x: Option[String]): Unit =
wenzelm@65615
   273
      set_string(stmt, i, x.orNull)
wenzelm@65615
   274
wenzelm@65020
   275
    def set_bytes(stmt: PreparedStatement, i: Int, bytes: Bytes)
wenzelm@65610
   276
    {
wenzelm@65610
   277
      if (bytes == null) stmt.setBytes(i, null)
wenzelm@65610
   278
      else stmt.setBinaryStream(i, bytes.stream(), bytes.length)
wenzelm@65610
   279
    }
wenzelm@65615
   280
    def set_bytes(stmt: PreparedStatement, i: Int, bytes: Option[Bytes]): Unit =
wenzelm@65615
   281
      set_bytes(stmt, i, bytes.orNull)
wenzelm@65615
   282
wenzelm@65615
   283
    def set_date(stmt: PreparedStatement, i: Int, date: Date): Unit
wenzelm@65615
   284
    def set_date(stmt: PreparedStatement, i: Int, date: Option[Date]): Unit =
wenzelm@65615
   285
      set_date(stmt, i, date.orNull)
wenzelm@65020
   286
wenzelm@65022
   287
wenzelm@65020
   288
    /* output */
wenzelm@65018
   289
wenzelm@65620
   290
    def bool(rs: ResultSet, column: Column): Boolean = rs.getBoolean(column.name)
wenzelm@65620
   291
    def int(rs: ResultSet, column: Column): Int = rs.getInt(column.name)
wenzelm@65620
   292
    def long(rs: ResultSet, column: Column): Long = rs.getLong(column.name)
wenzelm@65620
   293
    def double(rs: ResultSet, column: Column): Double = rs.getDouble(column.name)
wenzelm@65620
   294
    def string(rs: ResultSet, column: Column): String =
wenzelm@65018
   295
    {
wenzelm@65620
   296
      val s = rs.getString(column.name)
wenzelm@65018
   297
      if (s == null) "" else s
wenzelm@65018
   298
    }
wenzelm@65620
   299
    def bytes(rs: ResultSet, column: Column): Bytes =
wenzelm@65018
   300
    {
wenzelm@65620
   301
      val bs = rs.getBytes(column.name)
wenzelm@65018
   302
      if (bs == null) Bytes.empty else Bytes(bs)
wenzelm@65018
   303
    }
wenzelm@65620
   304
    def date(rs: ResultSet, column: Column): Date
wenzelm@65018
   305
wenzelm@65620
   306
    def get[A](rs: ResultSet, column: Column, f: (ResultSet, Column) => A): Option[A] =
wenzelm@65018
   307
    {
wenzelm@65620
   308
      val x = f(rs, column)
wenzelm@65018
   309
      if (rs.wasNull) None else Some(x)
wenzelm@65018
   310
    }
wenzelm@65018
   311
wenzelm@65018
   312
wenzelm@65669
   313
    /* tables and views */
wenzelm@65006
   314
wenzelm@65006
   315
    def tables: List[String] =
wenzelm@65006
   316
      iterator(connection.getMetaData.getTables(null, null, "%", null))(_.getString(3)).toList
wenzelm@65006
   317
wenzelm@65327
   318
    def create_table(table: Table, strict: Boolean = false, sql: String = ""): Unit =
wenzelm@65327
   319
      using(statement(table.sql_create(strict, sql_type) + (if (sql == "") "" else " " + sql)))(
wenzelm@65327
   320
        _.execute())
wenzelm@65006
   321
wenzelm@65280
   322
    def drop_table(table: Table, strict: Boolean = false): Unit =
wenzelm@65006
   323
      using(statement(table.sql_drop(strict)))(_.execute())
wenzelm@65006
   324
wenzelm@65018
   325
    def create_index(table: Table, name: String, columns: List[Column],
wenzelm@65280
   326
        strict: Boolean = false, unique: Boolean = false): Unit =
wenzelm@65006
   327
      using(statement(table.sql_create_index(name, columns, strict, unique)))(_.execute())
wenzelm@65006
   328
wenzelm@65280
   329
    def drop_index(table: Table, name: String, strict: Boolean = false): Unit =
wenzelm@65006
   330
      using(statement(table.sql_drop_index(name, strict)))(_.execute())
wenzelm@65669
   331
wenzelm@65669
   332
    def create_view(view: View, query: String): Unit =
wenzelm@65669
   333
      using(statement(view.sql_create(query)))(_.execute())
wenzelm@65006
   334
  }
wenzelm@63778
   335
}
wenzelm@65006
   336
wenzelm@65006
   337
wenzelm@65006
   338
wenzelm@65006
   339
/** SQLite **/
wenzelm@65006
   340
wenzelm@65006
   341
object SQLite
wenzelm@65006
   342
{
wenzelm@65021
   343
  // see https://www.sqlite.org/lang_datefunc.html
wenzelm@65021
   344
  val date_format: Date.Format = Date.Format("uuuu-MM-dd HH:mm:ss.SSS x")
wenzelm@65021
   345
wenzelm@65292
   346
  lazy val init_jdbc: Unit = Class.forName("org.sqlite.JDBC")
wenzelm@65292
   347
wenzelm@65006
   348
  def open_database(path: Path): Database =
wenzelm@65006
   349
  {
wenzelm@65292
   350
    init_jdbc
wenzelm@65006
   351
    val path0 = path.expand
wenzelm@65006
   352
    val s0 = File.platform_path(path0)
wenzelm@65006
   353
    val s1 = if (Platform.is_windows) s0.replace('\\', '/') else s0
wenzelm@65006
   354
    val connection = DriverManager.getConnection("jdbc:sqlite:" + s1)
wenzelm@65007
   355
    new Database(path0.toString, connection)
wenzelm@65006
   356
  }
wenzelm@65006
   357
wenzelm@65007
   358
  class Database private[SQLite](name: String, val connection: Connection) extends SQL.Database
wenzelm@65006
   359
  {
wenzelm@65007
   360
    override def toString: String = name
wenzelm@65006
   361
wenzelm@65019
   362
    def sql_type(T: SQL.Type.Value): String = SQL.sql_type_sqlite(T)
wenzelm@65011
   363
wenzelm@65021
   364
    def set_date(stmt: PreparedStatement, i: Int, date: Date): Unit =
wenzelm@65615
   365
      if (date == null) set_string(stmt, i, null: String)
wenzelm@65598
   366
      else set_string(stmt, i, date_format(date))
wenzelm@65598
   367
wenzelm@65620
   368
    def date(rs: ResultSet, column: SQL.Column): Date =
wenzelm@65620
   369
      date_format.parse(string(rs, column))
wenzelm@65021
   370
wenzelm@65006
   371
    def rebuild { using(statement("VACUUM"))(_.execute()) }
wenzelm@65006
   372
  }
wenzelm@65006
   373
}
wenzelm@65006
   374
wenzelm@65006
   375
wenzelm@65006
   376
wenzelm@65006
   377
/** PostgreSQL **/
wenzelm@65006
   378
wenzelm@65006
   379
object PostgreSQL
wenzelm@65006
   380
{
wenzelm@65006
   381
  val default_port = 5432
wenzelm@65006
   382
wenzelm@65292
   383
  lazy val init_jdbc: Unit = Class.forName("org.postgresql.Driver")
wenzelm@65292
   384
wenzelm@65006
   385
  def open_database(
wenzelm@65006
   386
    user: String,
wenzelm@65006
   387
    password: String,
wenzelm@65006
   388
    database: String = "",
wenzelm@65006
   389
    host: String = "",
wenzelm@65594
   390
    port: Int = 0,
wenzelm@65636
   391
    ssh: Option[SSH.Session] = None,
wenzelm@65636
   392
    ssh_close: Boolean = false): Database =
wenzelm@65006
   393
  {
wenzelm@65292
   394
    init_jdbc
wenzelm@65292
   395
wenzelm@65641
   396
    if (user == "") error("Undefined database user")
wenzelm@65009
   397
wenzelm@65009
   398
    val db_host = if (host != "") host else "localhost"
wenzelm@65594
   399
    val db_port = if (port > 0 && port != default_port) ":" + port else ""
wenzelm@65009
   400
    val db_name = "/" + (if (database != "") database else user)
wenzelm@65009
   401
wenzelm@65010
   402
    val (url, name, port_forwarding) =
wenzelm@65009
   403
      ssh match {
wenzelm@65010
   404
        case None =>
wenzelm@65010
   405
          val spec = db_host + db_port + db_name
wenzelm@65010
   406
          val url = "jdbc:postgresql://" + spec
wenzelm@65010
   407
          val name = user + "@" + spec
wenzelm@65010
   408
          (url, name, None)
wenzelm@65009
   409
        case Some(ssh) =>
wenzelm@65594
   410
          val fw =
wenzelm@65594
   411
            ssh.port_forwarding(remote_host = db_host,
wenzelm@65636
   412
              remote_port = if (port > 0) port else default_port,
wenzelm@65636
   413
              ssh_close = ssh_close)
wenzelm@65010
   414
          val url = "jdbc:postgresql://localhost:" + fw.local_port + db_name
wenzelm@65010
   415
          val name = user + "@" + fw + db_name + " via ssh " + ssh
wenzelm@65010
   416
          (url, name, Some(fw))
wenzelm@65009
   417
      }
wenzelm@65009
   418
    try {
wenzelm@65010
   419
      val connection = DriverManager.getConnection(url, user, password)
wenzelm@65010
   420
      new Database(name, connection, port_forwarding)
wenzelm@65009
   421
    }
wenzelm@65009
   422
    catch { case exn: Throwable => port_forwarding.foreach(_.close); throw exn }
wenzelm@65006
   423
  }
wenzelm@65006
   424
wenzelm@65009
   425
  class Database private[PostgreSQL](
wenzelm@65009
   426
      name: String, val connection: Connection, port_forwarding: Option[SSH.Port_Forwarding])
wenzelm@65009
   427
    extends SQL.Database
wenzelm@65006
   428
  {
wenzelm@65010
   429
    override def toString: String = name
wenzelm@65008
   430
wenzelm@65019
   431
    def sql_type(T: SQL.Type.Value): String = SQL.sql_type_postgresql(T)
wenzelm@65009
   432
wenzelm@65021
   433
    // see https://jdbc.postgresql.org/documentation/head/8-date-time.html
wenzelm@65021
   434
    def set_date(stmt: PreparedStatement, i: Int, date: Date): Unit =
wenzelm@65598
   435
      if (date == null) stmt.setObject(i, null)
wenzelm@65598
   436
      else stmt.setObject(i, OffsetDateTime.from(date.to_utc.rep))
wenzelm@65598
   437
wenzelm@65620
   438
    def date(rs: ResultSet, column: SQL.Column): Date =
wenzelm@65620
   439
      Date.instant(rs.getObject(column.name, classOf[OffsetDateTime]).toInstant)
wenzelm@65021
   440
wenzelm@65009
   441
    override def close() { super.close; port_forwarding.foreach(_.close) }
wenzelm@65006
   442
  }
wenzelm@65006
   443
}