db-sqlite/sqlite-sql.lisp

   1 ;;;; -*- Mode: LISP; Syntax: ANSI-Common-Lisp; Base: 10 -*-
   2 ;;;; *************************************************************************
   3 ;;;; FILE IDENTIFICATION
   4 ;;;;
   5 ;;;; Name:     sqlite-sql.lisp
   6 ;;;; Purpose:  High-level SQLite interface
   7 ;;;; Authors:  Aurelio Bignoli and Marcus Pearce
   8 ;;;; Created:  Aug 2003
   9 ;;;;
  10 ;;;; $Id$
  11 ;;;;
  12 ;;;; This file, part of CLSQL, is Copyright (c) 2003 by Aurelio Bignoli and
  13 ;;;; Marcus Pearce
  14 ;;;;
  15 ;;;; CLSQL users are granted the rights to distribute and use this software
  16 ;;;; as governed by the terms of the Lisp Lesser GNU Public License
  17 ;;;; (http://opensource.franz.com/preamble.html), also known as the LLGPL.
  18 ;;;; *************************************************************************
  19
  20 (in-package #:clsql-sqlite)
  21
  22 (defclass sqlite-database (database)
  23   ((sqlite-db :initarg :sqlite-db :accessor sqlite-db)))
  24
  25 (defmethod database-type ((database sqlite-database))
  26   :sqlite)
  27
  28 (defmethod database-initialize-database-type ((database-type (eql :sqlite)))
  29   t)
  30
  31 (defun check-sqlite-connection-spec (connection-spec)
  32   (check-connection-spec connection-spec :sqlite (name)))
  33
  34 (defmethod database-name-from-spec (connection-spec
  35                                     (database-type (eql :sqlite)))
  36   (check-sqlite-connection-spec connection-spec)
  37   (first connection-spec))
  38
  39 (defmethod database-connect (connection-spec (database-type (eql :sqlite)))
  40   (check-sqlite-connection-spec connection-spec)
  41   (handler-case
  42       (make-instance 'sqlite-database
  43                      :name (database-name-from-spec connection-spec :sqlite)
  44                      :database-type :sqlite
  45                      :connection-spec connection-spec
  46                      :sqlite-db (sqlite:sqlite-open (first connection-spec)))
  47     (sqlite:sqlite-error (err)
  48       (error 'clsql-connect-error
  49              :database-type database-type
  50              :connection-spec connection-spec
  51              :errno (sqlite:sqlite-error-code err)
  52              :error (sqlite:sqlite-error-message err)))))
  53
  54 (defmethod database-disconnect ((database sqlite-database))
  55   (sqlite:sqlite-close (sqlite-db database))
  56   (setf (sqlite-db database) nil)
  57   t)
  58
  59 (defmethod database-execute-command (sql-expression (database sqlite-database))
  60   (handler-case
  61       (multiple-value-bind (data row-n col-n)
  62           (sqlite:sqlite-get-table (sqlite-db database) sql-expression)
  63         #+clisp (declare (ignore data))
  64         #-clisp (sqlite:sqlite-free-table data)
  65         (unless (= row-n 0)
  66           (error 'clsql-simple-warning
  67                  :format-control
  68                  "Result set not empty: ~@(~A~) row~:P, ~@(~A~) column~:P "
  69                  :format-arguments (list row-n col-n))))
  70     (sqlite:sqlite-error (err)
  71       (error 'clsql-sql-error
  72              :database database
  73              :expression sql-expression
  74              :errno (sqlite:sqlite-error-code err)
  75              :error (sqlite:sqlite-error-message err))))
  76   t)
  77
  78 (defmethod database-query (query-expression (database sqlite-database) result-types)
  79   (declare (ignore result-types))               ; SQLite is typeless!
  80   (handler-case
  81       (multiple-value-bind (data row-n col-n)
  82           (sqlite:sqlite-get-table (sqlite-db database) query-expression)
  83         #-clisp (declare (type sqlite:sqlite-row-pointer-type data))
  84         (if (= row-n 0)
  85             nil
  86             (prog1
  87                 ;; The first col-n elements are column names.
  88                 (loop for i from col-n below (* (1+ row-n) col-n) by col-n
  89                       collect (loop for j from 0 below col-n
  90                                     collect
  91                                     (#+clisp aref
  92                                      #-clisp sqlite:sqlite-aref
  93                                              data (+ i j))))
  94                 #-clisp (sqlite:sqlite-free-table data))
  95               ))
  96     (sqlite:sqlite-error (err)
  97       (error 'clsql-sql-error
  98              :database database
  99              :expression query-expression
 100              :errno (sqlite:sqlite-error-code err)
 101              :error (sqlite:sqlite-error-message err)))))
 102
 103 #-clisp
 104 (defstruct sqlite-result-set
 105   (vm (sqlite:make-null-vm)
 106       :type sqlite:sqlite-vm-pointer)
 107   (first-row (sqlite:make-null-row)
 108              :type sqlite:sqlite-row-pointer-type)
 109   (n-col 0 :type fixnum))
 110 #+clisp
 111 (defstruct sqlite-result-set
 112   (vm nil)
 113   (first-row nil)
 114   (n-col 0 :type fixnum))
 115
 116 (defmethod database-query-result-set
 117     ((query-expression string) (database sqlite-database) &key full-set result-types)
 118   (declare (ignore full-set result-types))
 119   (handler-case
 120       (let* ((vm (sqlite:sqlite-compile (sqlite-db database)
 121                                         query-expression))
 122              (result-set (make-sqlite-result-set :vm vm)))
 123         #-clisp (declare (type sqlite:sqlite-vm-pointer vm))
 124
 125         ;;; To obtain column number we have to read the first row.
 126         (multiple-value-bind (n-col cols col-names)
 127             (sqlite:sqlite-step vm)
 128           (declare (ignore col-names)
 129                    #-clisp (type sqlite:sqlite-row-pointer-type cols)
 130                    )
 131           (setf (sqlite-result-set-first-row result-set) cols
 132                 (sqlite-result-set-n-col result-set) n-col)
 133           (values result-set n-col nil)))
 134     (sqlite:sqlite-error (err)
 135       (error 'clsql-sql-error
 136              :database database
 137              :expression query-expression
 138              :errno (sqlite:sqlite-error-code err)
 139              :error (sqlite:sqlite-error-message err)))))
 140
 141 (defmethod database-dump-result-set (result-set (database sqlite-database))
 142   (handler-case
 143       (sqlite:sqlite-finalize (sqlite-result-set-vm result-set))
 144     (sqlite:sqlite-error (err)
 145       (error 'clsql-simple-error
 146              :format-control "Error finalizing SQLite VM: ~A"
 147              :format-arguments (list (sqlite:sqlite-error-message err))))))
 148
 149 (defmethod database-store-next-row (result-set (database sqlite-database) list)
 150   (let ((n-col (sqlite-result-set-n-col result-set)))
 151     (if (= n-col 0)
 152         ;; empty result set
 153         nil
 154         (let ((row (sqlite-result-set-first-row result-set)))
 155           (if (sqlite:null-row-p row)
 156               ;; First row already used. fetch another row from DB.
 157               (handler-case
 158                   (multiple-value-bind (n new-row col-names)
 159                       (sqlite:sqlite-step (sqlite-result-set-vm result-set))
 160                     (declare (ignore n col-names)
 161                              #-clisp (type sqlite:sqlite-row-pointer-type new-row)
 162                              )
 163                     (if (sqlite:null-row-p new-row)
 164                         (return-from database-store-next-row nil)
 165                         (setf row new-row)))
 166                 (sqlite:sqlite-error (err)
 167                   (error 'clsql-simple-error
 168                          :format-control "Error in sqlite-step: ~A"
 169                          :format-arguments
 170                          (list (sqlite:sqlite-error-message err)))))
 171
 172               ;; Use the row previously read by database-query-result-set.
 173               (setf (sqlite-result-set-first-row result-set)
 174                     (sqlite:make-null-row)))
 175           (loop for i = 0 then (1+ i)
 176                 for rest on list
 177                 do (setf (car rest)
 178                          (#+clisp aref
 179                           #-clisp sqlite:sqlite-aref
 180                           row i)))
 181           #-clisp (sqlite:sqlite-free-row row)
 182           t))))
 183
 184 ;;; Object listing
 185
 186 (defmethod database-list-tables ((database sqlite-database) &key owner)
 187   (declare (ignore owner))
 188   ;; Query is copied from .table command of sqlite comamnd line utility.
 189   (remove-if #'(lambda (s)
 190                  (and (>= (length s) 11)
 191                       (string= (subseq s 0 11) "_clsql_seq_")))
 192              (mapcar #'car (database-query
 193                             "SELECT name FROM sqlite_master WHERE type='table' UNION ALL SELECT name FROM sqlite_temp_master WHERE type='table' ORDER BY name"
 194                             database '()))))
 195
 196 (defmethod database-list-views ((database sqlite-database)
 197                                 &key (owner nil))
 198   (declare (ignore owner))
 199   (mapcar #'car (database-query
 200                  "SELECT name FROM sqlite_master WHERE type='view' UNION ALL SELECT name FROM sqlite_temp_master WHERE type='view' ORDER BY name"
 201                  database nil)))
 202
 203 (defmethod database-list-indexes ((database sqlite-database)
 204                                   &key (owner nil))
 205   (declare (ignore owner))
 206   (mapcar #'car (database-query
 207                  "SELECT name FROM sqlite_master WHERE type='index' UNION ALL SELECT name FROM sqlite_temp_master WHERE type='index' ORDER BY name"
 208                  database nil)))
 209
 210 (declaim (inline sqlite-table-info))
 211 (defun sqlite-table-info (table database)
 212   (database-query (format nil "PRAGMA table_info('~A')" table)
 213                           database '()))
 214
 215 (defmethod database-list-attributes (table (database sqlite-database)
 216                                            &key (owner nil))
 217   (declare (ignore owner))
 218   (mapcar #'(lambda (table-info) (second table-info))
 219           (sqlite-table-info table database)))
 220
 221 (defmethod database-attribute-type (attribute table
 222                                     (database sqlite-database)
 223                                     &key (owner nil))
 224   (declare (ignore owner))
 225   (loop for field-info in (sqlite-table-info table database)
 226         when (string= attribute (second field-info))
 227         return (third field-info)))
 228
 229 (defun %sequence-name-to-table-name (sequence-name)
 230   (concatenate 'string "_clsql_seq_" (sql-escape sequence-name)))
 231
 232 (defun %table-name-to-sequence-name (table-name)
 233   (and (>= (length table-name) 11)
 234        (string= (subseq table-name 0 11) "_clsql_seq_")
 235        (subseq table-name 11)))
 236
 237 (defmethod database-create-sequence (sequence-name
 238                                      (database sqlite-database))
 239   (let ((table-name (%sequence-name-to-table-name sequence-name)))
 240     (database-execute-command
 241      (concatenate 'string "CREATE TABLE " table-name
 242                   " (id INTEGER PRIMARY KEY)")
 243      database)
 244     (database-execute-command
 245      (format nil "INSERT INTO ~A VALUES (-1)" table-name)
 246      database)))
 247
 248 (defmethod database-drop-sequence (sequence-name
 249                                    (database sqlite-database))
 250   (database-execute-command
 251    (concatenate 'string "DROP TABLE "
 252                 (%sequence-name-to-table-name sequence-name))
 253    database))
 254
 255 (defmethod database-list-sequences ((database sqlite-database)
 256                                     &key (owner nil))
 257   (declare (ignore owner))
 258   (mapcan #'(lambda (s)
 259               (let ((sn (%table-name-to-sequence-name (car s))))
 260                 (and sn (list sn))))
 261           (database-query
 262            "SELECT name FROM sqlite_master WHERE type='table' UNION ALL SELECT name FROM sqlite_temp_master WHERE type='table' ORDER BY name"
 263            database '())))
 264
 265 (defmethod database-sequence-next (sequence-name (database sqlite-database))
 266   (let ((table-name (%sequence-name-to-table-name sequence-name)))
 267     (database-execute-command
 268      (format nil "UPDATE ~A SET id=(SELECT id FROM ~A)+1"
 269              table-name table-name)
 270      database)
 271     (sqlite:sqlite-last-insert-rowid (sqlite-db database))
 272     (parse-integer
 273      (caar (database-query (format nil "SELECT id from ~A" table-name)
 274                            database nil)))))
 275
 276 (defmethod database-set-sequence-position (sequence-name
 277                                            (position integer)
 278                                            (database sqlite-database))
 279   (let ((table-name (%sequence-name-to-table-name sequence-name)))
 280     (database-execute-command
 281      (format nil "UPDATE ~A SET id=~A" table-name position)
 282      database)
 283     (sqlite:sqlite-last-insert-rowid (sqlite-db database))))
 284
 285 (defmethod database-sequence-last (sequence-name (database sqlite-database))
 286   (declare (ignore sequence-name)))
 287
 288 (defmethod database-create (connection-spec (type (eql :sqlite)))
 289   (declare (ignore connection-spec))
 290   ;; databases are created automatically by SQLite
 291   t)
 292
 293 (defmethod database-destroy (connection-spec (type (eql :sqlite)))
 294   (destructuring-bind (name) connection-spec
 295     (if (probe-file name)
 296         (delete-file name)
 297         nil)))
 298
 299 (defmethod database-probe (connection-spec (type (eql :sqlite)))
 300   (destructuring-bind (name) connection-spec
 301     ;; TODO: Add a test that this file is a real sqlite database
 302     (and (probe-file name) t)))
 303
 304