src/lyxserver.h

   1 // -*- C++ -*-
   2 /* This file is part of
   3 * ======================================================
   4 *
   5 *           LyX, The Document Processor
   6 *
   7 *           Copyright (C) 1995 Matthias Ettrich
   8 *           Copyright (C) 1995-1998 The LyX Team.
   9 *
  10 *======================================================*/
  11
  12 #ifndef _LYXSERVER_H_
  13 #define _LYXSERVER_H_
  14
  15 #ifdef __GNUG__
  16 #pragma interface
  17 #endif
  18
  19 #include "LString.h"
  20 class LyXFunc;
  21 class LyXServer;
  22
  23 /* --- i/o pipes --------------------------------------------------------- */
  24
  25 /** This class managed the pipes used for communicating with clients.
  26  Usage: Initialize with pipe-filename-base, client class to receive
  27  messages, and callback-function that will be called with the messages.
  28  When you want to send, use "send()".
  29  This class encapsulates all the dirty communication and thus provides
  30  a clean string interface.
  31  */
  32 class LyXComm
  33 {
  34 public:
  35         /** When we receive a message, we send it to a client.
  36           This is one of the small things that would have been a lot
  37           cleaner with a Signal/Slot thing.
  38          */
  39         typedef void (*ClientCallbackfct)(LyXServer *, string const &);
  40
  41         /// Construct with pipe-basename and callback to receive messages
  42         LyXComm(string const &pip, LyXServer * cli, ClientCallbackfct ccb = 0)
  43                 :pipename(pip), client(cli), clientcb(ccb)
  44         {
  45                 ready = false;
  46                 openConnection();
  47         }
  48
  49         ///
  50         ~LyXComm() {
  51                 closeConnection();
  52         }
  53
  54         /// Send message
  55         void send(string const &);
  56 private:
  57         /// Open pipes
  58         void openConnection();
  59
  60         /// Close pipes
  61         void closeConnection();
  62
  63         /// We receive messages via XForms through this callback
  64         static void callback(int fd, void *v);
  65
  66         /// This is -1 if not open
  67         int infd;
  68
  69         /// This is -1 if not open
  70         int outfd;
  71
  72         /// Are we up and running?
  73         bool ready;
  74
  75         /// Base of pipename including path
  76         string pipename;
  77
  78         /// The client
  79         LyXServer * client;
  80
  81         /// The client callback function
  82         ClientCallbackfct clientcb;
  83 };
  84
  85
  86 /* --- prototypes -------------------------------------------------------- */
  87 class LyXServer
  88 {
  89 public:
  90         // FIXME IN 0.13
  91         // Hack! This should be changed in 0.13
  92
  93         /// The lyx server should not take an argument "LyXFunc" but this is
  94         // how it will be done for 0.12. In 0.13 we must write a non-gui
  95         // bufferview.
  96         // IMO lyxserver is atypical, and for the moment the only one, non-gui
  97         // bufferview. We just have to find a way to handle situations like if
  98         // lyxserver is using a buffer that is being edited with a bufferview.
  99         // With a common buffer list this is not a problem, maybe. (Alejandro)
 100         LyXServer(LyXFunc *f, string const &pip)
 101                 : numclients(0), func(f), pipes(pip, (this), callback)
 102         { }
 103         ///
 104         ~LyXServer();
 105         ///
 106         void notifyClient(string const &);
 107 private:
 108         ///
 109         static void callback(LyXServer *, string const & msg);
 110         /// Names and number of current clients
 111         enum { MAX_CLIENTS = 10 };
 112         string clients[MAX_CLIENTS];
 113         int numclients;
 114         ///
 115         LyXFunc *func;
 116         ///
 117         LyXComm pipes;
 118 };
 119
 120 #endif /* _LYXSERVER_H_ */
 121
 122 /* === End of File: lyxserver.h ========================================== */