helm/ocaml/mathql_interpreter/mqint.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 (*
  27  * implementazione del'interprete MathQL
  28  *)
  29 open Mathql;;
  30 open Eval;;
  31 open Utility;;
  32 open Dbconn;;
  33 open Pattern;;
  34 open Union;;
  35 open Intersect;;
  36 open Diff;;
  37 open Sortedby;;
  38 open Use;;
  39 open Select;;
  40
  41 let fi_to_string fi =
  42  match fi with
  43     (None, _)   ->
  44      ""
  45  |  (Some i, y) ->
  46      "#xpointer(1/"       ^
  47      string_of_int i      ^
  48      (
  49       match y with
  50          None   ->
  51           ""
  52       |  Some j ->
  53           "/" ^ (string_of_int j)
  54      )                    ^
  55      ")"
  56 ;;
  57
  58 (*
  59  * inizializzazione della connessione al database
  60  *)
  61 let init () = Dbconn.init ();;
  62
  63 (*
  64  * esecuzione di una query
  65  *
  66  * parametri:
  67  * q
  68  *
  69  * output: string list list; risultato internto formato da uri + contesto.
  70  *)
  71 let rec execute_ex q =
  72  match q with
  73     MQSelect (apvar, alist, abool) ->
  74      select_ex apvar (execute_ex alist) abool
  75  |  MQUsedBy (alist, asvar) ->
  76      use_ex (execute_ex alist) asvar "F" (*"refObj"*)
  77  |  MQUse (alist, asvar) ->
  78      use_ex (execute_ex alist) asvar "B" (*"backPointer"*)
  79  |  MQPattern (apreamble, apattern, afragid) ->
  80      pattern_ex apreamble apattern afragid
  81  |  MQUnion (l1, l2) ->
  82      union_ex (execute_ex l1) (execute_ex l2)
  83  |  MQDiff (l1, l2) ->
  84      diff_ex (execute_ex l1) (execute_ex l2)
  85  |  MQSortedBy (l, o, f) ->
  86      sortedby_ex (execute_ex l) o f
  87  |  MQIntersect (l1, l2) ->
  88      intersect_ex (execute_ex l1) (execute_ex l2)
  89 ;;
  90
  91 (*
  92  * converte il risultato interno di una query (uri + contesto)
  93  * in un risultato di sole uri
  94  *
  95  * parametri:
  96  * l: string list list;
  97  *
  98  * output: mqresult;
  99  *
 100  * note:
 101  * il tipo del risultato mantenuto internamente e' diverso dal tipo di risultato
 102  * restituito in output poiche', mentre chi effettua le query vuole come risultato
 103  * solo le eventuali uri che soddisfano le query stesse, internamente ad una uri
 104  * sono associati anche i valori delle variabili che ancora non sono state valutate
 105  * perche', ad esempio, si trovano in altri rami dell'albero.
 106  *
 107  * Esempio:
 108  * SELECT x IN USE PATTERN "cic:/**.con" POSITION $a WHERE $a IS MainConclusion
 109  * L'albero corrispondente a questa query e':
 110  *
 111  *                  SELECT
 112  *                /   |    \
 113  *               x   USE    IS
 114  *                  /   \    /\
 115  *           PATTERN    $a  $a MainConclusion
 116  *
 117  * Nel momento in cui si esegue il ramo USE non sono noti i vincoli sullla variabile $a
 118  * percui e' necessario considerare, oltre alle uri, i valori della variabile per i quali
 119  * la uri puo' far parte del risultato.
 120  *)
 121 let xres_to_res l =
 122  let tmp = List.map List.hd (List.tl l) in
 123   MQRefs
 124    (List.map
 125     (function l ->
 126       match Str.split (Str.regexp ":\|#\|/") l with
 127          hd::tl -> (
 128           match List.rev tl with
 129              ")"::n::"xpointer(1"::tail    ->
 130               (
 131                hd,
 132                List.fold_left
 133                 (fun par t ->
 134                  match par with
 135                     [] -> [MQString t]
 136                  |  _  -> (MQString t) :: MQSlash :: par
 137                 )
 138                 []
 139                 tail,
 140                (Some (int_of_string n), None)
 141               )
 142           |  ")"::n::m::"xpointer(1"::tail ->
 143               (
 144                hd,
 145                List.fold_left
 146                 (fun par t ->
 147                  match par with
 148                     [] -> [MQString t]
 149                  |  _  -> (MQString t) :: MQSlash :: par
 150                 )
 151                 []
 152                 tail,
 153                (Some (int_of_string m), Some (int_of_string n))
 154               )
 155           |  tail                          ->
 156               (
 157                hd,
 158                List.fold_left
 159                 (fun par t ->
 160                  match par with
 161                     [] -> [MQString t]
 162                  |  _  -> (MQString t) :: MQSlash :: par
 163                 )
 164                 []
 165                 tail,
 166                (None, None)
 167               )
 168       )
 169       |  [] -> assert false
 170     )
 171     tmp
 172    )
 173 ;;
 174
 175
 176 (*
 177  *
 178  *)
 179 let execute q =
 180  match q with
 181     MQList qq -> xres_to_res (execute_ex qq)
 182 ;;
 183
 184 (*
 185  * chiusura della connessione al database
 186  *)
 187 let close () = Dbconn.close ();;
 188