helm/ocaml/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 type connection = MySQL_C    of HMysql.dbd
  30                 | Postgres_C of Postgres.connection
  31                 | No_C
  32
  33 type flag = Galax | Postgres | Queries | Result | Source | Times | Warn
  34
  35 type handle = {
  36    log : string -> unit; (* logging function        *)
  37    set : flag list;      (* options                 *)
  38    pgc : connection;     (* PG connection           *)
  39    pgm : MQIMap.pg_map;  (* PG conversion function  *)
  40    pga : MQIMap.pg_alias (* PG table aliases        *)
  41 }
  42
  43 let tables handle p = MQIMap.get_tables handle.pgm p
  44
  45 let field handle p t = MQIMap.get_field handle.pgm p t
  46
  47 let resolve handle a = MQIMap.resolve handle.pga a
  48
  49 let log handle = handle.log
  50
  51 let set handle flag = List.mem flag handle.set
  52
  53 let pgc handle = handle.pgc
  54
  55 let flags handle = handle.set
  56
  57 let string_of_flag = function
  58       | Galax    -> "G"
  59       | Postgres -> "P"
  60       | Queries  -> "Q"
  61       | Result   -> "R"
  62       | Source   -> "S"
  63       | Times    -> "T"
  64       | Warn     -> "W"
  65
  66 let flag_of_char = function
  67       | 'G' -> [Galax]
  68       | 'P' -> [Postgres]
  69       | 'Q' -> [Queries]
  70       | 'R' -> [Result]
  71       | 'S' -> [Source]
  72       | 'T' -> [Times]
  73       | 'W' -> [Warn]
  74       | _   -> []
  75
  76 let string_fold_left f a s =
  77    let l = String.length s in
  78    let rec aux b i = if i = l then b else aux (f b s.[i]) (succ i) in
  79    aux a 0
  80
  81 let string_of_flags flags =
  82    List.fold_left (fun s flag -> s ^ string_of_flag flag) "" flags
  83
  84 let flags_of_string s =
  85    string_fold_left (fun l c -> l @ flag_of_char c) [] s
  86
  87 let init ?(flags = []) ?(log = ignore) () =
  88    let flags =
  89       if flags = [] then
  90          flags_of_string (Helm_registry.get "mathql_interpreter.flags")
  91       else
  92          flags
  93    in
  94    let m, a =
  95       let g =
  96          if List.mem Galax flags
  97             then MQIMap.empty_map else MQIMap.read_map
  98       in g ()
  99    in
 100    {log = log; set = flags;
 101     pgc = begin
 102       try
 103          if List.mem Galax flags then No_C else
 104          if List.mem Postgres flags then Postgres_C (MQIPostgres.init ()) else
 105          MySQL_C (MQIMySql.init ())
 106       with Failure "mqi_connection" -> No_C
 107     end;
 108     pgm = m; pga = a
 109    }
 110
 111 let close handle =
 112    match pgc handle with
 113       | MySQL_C c    -> MQIMySql.close c
 114       | Postgres_C c -> MQIPostgres.close c
 115       | No_C         -> ()
 116
 117 let exec handle out table cols ct cfl =
 118    match pgc handle with
 119       | MySQL_C c    -> MQIMySql.exec (c, out) table cols ct cfl
 120       | Postgres_C c -> MQIPostgres.exec (c, out) table cols ct cfl
 121       | No_C         -> []
 122
 123 let connected handle =
 124    pgc handle <> No_C
 125
 126 let init_if_connected ?(flags = []) ?(log = ignore) () =
 127    let handle = init ~flags:flags ~log:log () in
 128    if connected handle then handle else raise (Failure "mqi connection failed")