helm/uwobo/src/ocaml/uwobo_common.ml

   1
   2 (* Copyright (C) 2002, HELM Team.
   3  *
   4  * This file is part of HELM, an Hypertextual, Electronic
   5  * Library of Mathematics, developed at the Computer Science
   6  * Department, University of Bologna, Italy.
   7  *
   8  * HELM is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU General Public License
  10  * as published by the Free Software Foundation; either version 2
  11  * of the License, or (at your option) any later version.
  12  *
  13  * HELM is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with HELM; if not, write to the Free Software
  20  * Foundation, Inc., 59 Temple Place - Suite 330, Boston,
  21  * MA  02111-1307, USA.
  22  *
  23  * For details, see the HELM World-Wide-Web page,
  24  * http://cs.unibo.it/helm/.
  25  *)
  26
  27 let debug = false;;
  28 let debug_print msg = if debug then prerr_endline msg;;
  29
  30 exception Uwobo_failure of string;;
  31
  32 class threadSafe =
  33   object (self)
  34
  35     val mutex = Mutex.create ()
  36
  37       (** condition variable: 'no readers is currently reading' *)
  38     val noReaders = Condition.create ()
  39
  40       (** readers count *)
  41     val mutable readersCount = 0
  42
  43     method private incrReadersCount = (* internal, not exported *)
  44       self#doCritical (lazy (
  45         readersCount <- readersCount + 1
  46       ))
  47
  48     method private decrReadersCount = (* internal, not exported *)
  49       self#doCritical (lazy (
  50         if readersCount > 0 then readersCount <- readersCount - 1;
  51       ))
  52
  53     method private signalNoReaders =  (* internal, not exported *)
  54       self#doCritical (lazy (
  55         if readersCount = 0 then Condition.signal noReaders
  56       ))
  57
  58     method private doCritical: 'a. 'a lazy_t -> 'a =
  59       fun action ->
  60         debug_print "<doCritical>";
  61         (try
  62           Mutex.lock mutex;
  63           let res = Lazy.force action in
  64           Mutex.unlock mutex;
  65           debug_print "</doCritical>";
  66           res
  67         with e ->
  68           Mutex.unlock mutex;
  69           raise e);
  70
  71     method private doReader: 'a. 'a lazy_t -> 'a =
  72       fun action ->
  73         debug_print "<doReader>";
  74         let cleanup () =
  75           self#decrReadersCount;
  76           self#signalNoReaders
  77         in
  78         self#incrReadersCount;
  79         let res = (try Lazy.force action with e -> (cleanup (); raise e)) in
  80         cleanup ();
  81         debug_print "</doReader>";
  82         res
  83
  84       (* TODO may starve!!!! is what we want or not? *)
  85     method private doWriter: 'a. 'a lazy_t -> 'a =
  86       fun action ->
  87         debug_print "<doWriter>";
  88         self#doCritical (lazy (
  89           while readersCount > 0 do
  90             Condition.wait noReaders mutex
  91           done;
  92           let res = Lazy.force action in
  93           debug_print "</doWriter>";
  94           res
  95         ))
  96
  97   end
  98