sql/usql.cl

   1 ;;;; -*- Mode: LISP; Syntax: ANSI-Common-Lisp; Base: 10 -*-
   2 ;;;; *************************************************************************
   3 ;;;; FILE IDENTIFICATION
   4 ;;;;
   5 ;;;; Name:          usql.cl
   6 ;;;; Purpose:       High-level interface to SQL driver routines needed for
   7 ;;;;                UncommonSQL
   8 ;;;; Programmers:   Kevin M. Rosenberg and onShore Development Inc
   9 ;;;; Date Started:  Mar 2002
  10 ;;;;
  11 ;;;; $Id: usql.cl,v 1.1 2002/04/01 05:27:55 kevin Exp $
  12 ;;;;
  13 ;;;; This file, part of CLSQL, is Copyright (c) 2002 by Kevin M. Rosenberg
  14 ;;;; and onShore Development Inc
  15 ;;;;
  16 ;;;; CLSQL users are granted the rights to distribute and use this software
  17 ;;;; as governed by the terms of the Lisp Lesser GNU Public License
  18 ;;;; (http://opensource.franz.com/preamble.html), also known as the LLGPL.
  19 ;;;; *************************************************************************
  20
  21
  22 ;;; Minimal high-level routines to enable low-level interface for USQL
  23
  24 (declaim (optimize (debug 3) (speed 3) (safety 1) (compilation-speed 0)))
  25 (in-package :clsql-sys)
  26
  27 (defun list-tables (&key (database *default-database*)
  28                          (system-tables nil))
  29   "List all tables in *default-database*, or if the :database keyword arg
  30 is given, the specified database.  If the keyword arg :system-tables
  31 is true, then it will not filter out non-user tables.  Table names are
  32 given back as a list of strings."
  33   (database-list-tables database :system-tables system-tables))
  34
  35
  36 (defun list-attributes (table &key (database *default-database*))
  37   "List the attributes of TABLE in *default-database, or if the
  38 :database keyword is given, the specified database.  Attributes are
  39 returned as a list of strings."
  40   (database-list-attributes table database))
  41
  42 (defun attribute-type (attribute table &key (database *default-database*))
  43   "Return the field type of the ATTRIBUTE in TABLE.  The optional
  44 keyword argument :database specifies the database to query, defaulting
  45 to *default-database*."
  46   (database-attribute-type attribute table database))
  47
  48 (defun add-attribute (table attribute &key (database *default-database*))
  49   "Add the ATTRIBUTE to TABLE.  The ATTRIBUTE sepcification must
  50 include a type argument.  The optional keyword argument :database
  51 specifies the database to operation on, defaulting to
  52 *default-database*."
  53   (database-add-attribute table attribute database))
  54
  55 (defun rename-attribute (table oldatt newname
  56                                &key (database *default-database*))
  57   (error "(rename-attribute ~a ~a ~a ~a) is not implemented" table oldatt newname database))
  58
  59
  60 ;; For SQL Identifiers of generic type
  61 (defclass sql-ident (%sql-expression)
  62   ((name
  63     :initarg :name
  64     :initform "NULL"))
  65   (:documentation "An SQL identifer."))
  66
  67 (defmethod make-load-form ((sql sql-ident) &optional environment)
  68   (declare (ignore environment))
  69   (with-slots (name)
  70     sql
  71     `(make-instance 'sql-ident :name ',name)))
  72
  73
  74 ;; KMR -- change aref to more specific char
  75 (defun sql-escape (identifier)
  76   (let* ((unescaped (etypecase identifier
  77                       (symbol (symbol-name identifier))
  78                       (string identifier)))
  79          (escaped (make-string (length unescaped))))
  80     (dotimes (i (length unescaped))
  81       (setf (char escaped i)
  82             (cond ((equal (char unescaped i) #\-)
  83                    #\_)
  84                   ;; ...
  85                   (t
  86                    (char unescaped i)))))
  87     escaped))
  88
  89
  90 (defun create-sequence (name &key (database *default-database*))
  91   (database-create-sequence name database))
  92
  93 (defun drop-sequence (name &key (database *default-database*))
  94   (database-drop-sequence name database))
  95
  96 (defun sequence-next (name &key (database *default-database*))
  97   (database-sequence-next name database))
  98
  99
 100 (defclass sql-typecast-exp (sql-value-exp)
 101   ()
 102   (:documentation
 103    "An SQL typecast expression.")
 104   )
 105
 106
 107 (defclass sql-value-exp (%sql-expression)
 108   ((modifier
 109     :initarg :modifier
 110     :initform nil)
 111    (components
 112     :initarg :components
 113     :initform nil))
 114   (:documentation
 115    "An SQL value expression.")
 116   )
 117
 118 (defvar +null-string+ "NULL")
 119
 120 (defvar *sql-stream* nil
 121   "stream which accumulates SQL output")
 122
 123 (defclass %sql-expression ()
 124   ())
 125
 126 (defmethod output-sql ((expr %sql-expression) &optional
 127                        (database *default-database*))
 128   (declare (ignore database))
 129   (write-string +null-string+ *sql-stream*))
 130
 131 #+ignore
 132 (defmethod print-object ((self %sql-expression) stream)
 133   (print-unreadable-object
 134    (self stream :type t)
 135    (write-string (sql-output self) stream)))
 136