mathql/mathql_interpreter/mQIConn.ml

   1 (* Copyright (C) 2000, HELM Team.
   2  *
   3  * This file is part of HELM, an Hypertextual, Electronic
   4  * Library of Mathematics, developed at the Computer Science
   5  * Department, University of Bologna, Italy.
   6  *
   7  * HELM is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU General Public License
   9  * as published by the Free Software Foundation; either version 2
  10  * of the License, or (at your option) any later version.
  11  *
  12  * HELM is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with HELM; if not, write to the Free Software
  19  * Foundation, Inc., 59 Temple Place - Suite 330, Boston,
  20  * MA  02111-1307, USA.
  21  *
  22  * For details, see the HELM World-Wide-Web page,
  23  * http://cs.unibo.it/helm/.
  24  *)
  25
  26 (*  AUTOR: Ferruccio Guidi <fguidi@cs.unibo.it>
  27  *)
  28
  29 (* $Id$ *)
  30
  31 type connection = MySQL_C    of HMysql.dbd
  32                 | Postgres_C of Postgres.connection
  33                 | No_C
  34
  35 type flag = Galax | Postgres | Queries | Result | Source | Times | Warn
  36
  37 type handle = {
  38    log : string -> unit; (* logging function        *)
  39    set : flag list;      (* options                 *)
  40    pgc : connection;     (* PG connection           *)
  41    pgm : MQIMap.pg_map;  (* PG conversion function  *)
  42    pga : MQIMap.pg_alias (* PG table aliases        *)
  43 }
  44
  45 let tables handle p = MQIMap.get_tables handle.pgm p
  46
  47 let field handle p t = MQIMap.get_field handle.pgm p t
  48
  49 let resolve handle a = MQIMap.resolve handle.pga a
  50
  51 let log handle = handle.log
  52
  53 let set handle flag = List.mem flag handle.set
  54
  55 let pgc handle = handle.pgc
  56
  57 let flags handle = handle.set
  58
  59 let string_of_flag = function
  60       | Galax    -> "G"
  61       | Postgres -> "P"
  62       | Queries  -> "Q"
  63       | Result   -> "R"
  64       | Source   -> "S"
  65       | Times    -> "T"
  66       | Warn     -> "W"
  67
  68 let flag_of_char = function
  69       | 'G' -> [Galax]
  70       | 'P' -> [Postgres]
  71       | 'Q' -> [Queries]
  72       | 'R' -> [Result]
  73       | 'S' -> [Source]
  74       | 'T' -> [Times]
  75       | 'W' -> [Warn]
  76       | _   -> []
  77
  78 let string_fold_left f a s =
  79    let l = String.length s in
  80    let rec aux b i = if i = l then b else aux (f b s.[i]) (succ i) in
  81    aux a 0
  82
  83 let string_of_flags flags =
  84    List.fold_left (fun s flag -> s ^ string_of_flag flag) "" flags
  85
  86 let flags_of_string s =
  87    string_fold_left (fun l c -> l @ flag_of_char c) [] s
  88
  89 let init ?(flags = []) ?(log = ignore) () =
  90    let flags =
  91       if flags = [] then
  92          flags_of_string (Helm_registry.get "mathql_interpreter.flags")
  93       else
  94          flags
  95    in
  96    let m, a =
  97       let g =
  98          if List.mem Galax flags
  99             then MQIMap.empty_map else MQIMap.read_map
 100       in g ()
 101    in
 102    {log = log; set = flags;
 103     pgc = begin
 104       try
 105          if List.mem Galax flags then No_C else
 106          if List.mem Postgres flags then Postgres_C (MQIPostgres.init ()) else
 107          MySQL_C (MQIMySql.init ())
 108       with Failure "mqi_connection" -> No_C
 109     end;
 110     pgm = m; pga = a
 111    }
 112
 113 let close handle =
 114    match pgc handle with
 115       | MySQL_C c    -> MQIMySql.close c
 116       | Postgres_C c -> MQIPostgres.close c
 117       | No_C         -> ()
 118
 119 let exec handle out table cols ct cfl =
 120    match pgc handle with
 121       | MySQL_C c    -> MQIMySql.exec (c, out) table cols ct cfl
 122       | Postgres_C c -> MQIPostgres.exec (c, out) table cols ct cfl
 123       | No_C         -> []
 124
 125 let connected handle =
 126    pgc handle <> No_C
 127
 128 let init_if_connected ?(flags = []) ?(log = ignore) () =
 129    let handle = init ~flags:flags ~log:log () in
 130    if connected handle then handle else raise (Failure "mqi connection failed")