Development/Architecture/DCOP - Revision history

Neverendingo: Text replace - "`" to ""`


2011-06-29T20:58:48Z
Text replace - "<code cpp-qt>" to "<syntaxhighlight lang="cpp-qt">"

				
				
				
				
			
			← Older revision
			Revision as of 20:58, 29 June 2011
			
Line 96:
Line 96:
  case:   case:
    
− <code cpp-qt> + <syntaxhighlight lang="cpp-qt">
  /*   /*
    * returns the appId that is actually registered, which _may_ be     * returns the appId that is actually registered, which _may_ be
Line 150:
Line 150:
  or not.   or not.
    
− <code cpp-qt> + <syntaxhighlight lang="cpp-qt">
  QByteArray data;   QByteArray data;
  QDataStream arg(data, IO_WriteOnly);   QDataStream arg(data, IO_WriteOnly);
Line 165:
Line 165:
  communication was successful.   communication was successful.
    
− <code cpp-qt> + <syntaxhighlight lang="cpp-qt">
  QByteArray data, replyData;   QByteArray data, replyData;
  QCString replyType;   QCString replyType;
Line 197:
Line 197:
  calling the function is as easy as this:   calling the function is as easy as this:
    
− <code cpp-qt> + <syntaxhighlight lang="cpp-qt">
  DCOPRef barObject ("someAppId", "fooObject/barObject");   DCOPRef barObject ("someAppId", "fooObject/barObject");
  DCOPReply reply = barObject. call ("doIt", 5);   DCOPReply reply = barObject. call ("doIt", 5);
Line 224:
Line 224:
  an example implementation.   an example implementation.
    
− <code cpp-qt> + <syntaxhighlight lang="cpp-qt">
  bool BarObject:: process (const QCString &fun, const QByteArray &data,   bool BarObject:: process (const QCString &fun, const QByteArray &data,
                           QCString &replyType, QByteArray &replyData)                            QCString &replyType, QByteArray &replyData)
Line 259:
Line 259:
  Such code could like this:   Such code could like this:
    
− <code cpp-qt> + <syntaxhighlight lang="cpp-qt">
  bool BarObject::process(const QCString &fun, const QByteArray &data,   bool BarObject::process(const QCString &fun, const QByteArray &data,
                           QCString &, QByteArray &)                            QCString &, QByteArray &)
Line 338:
Line 338:
  ; Example:   ; Example:
    
− <code cpp-qt> + <syntaxhighlight lang="cpp-qt">
  QByteArray params;   QByteArray params;
  QDataStream stream (params, IO_WriteOnly);   QDataStream stream (params, IO_WriteOnly);
Line 351:
Line 351:
  ; Example:   ; Example:
    
− <code cpp-qt> + <syntaxhighlight lang="cpp-qt">
  connectDCOPSignal (0, 0, "clientDied(pid_t)", "clientDied(pid_t)", false);   connectDCOPSignal (0, 0, "clientDied(pid_t)", "clientDied(pid_t)", false);
  </syntaxhighlight>   </syntaxhighlight>
Line 378:
Line 378:
  ; Example:   ; Example:
    
− <code cpp-qt> + <syntaxhighlight lang="cpp-qt">
  #ifndef MY_INTERFACE_H   #ifndef MY_INTERFACE_H
  #define MY_INTERFACE_H   #define MY_INTERFACE_H
Line 408:
Line 408:
  ; Example:   ; Example:
    
− <code cpp-qt> + <syntaxhighlight lang="cpp-qt">
  class MyClass: public QObject, virtual public MyInterface   class MyClass: public QObject, virtual public MyInterface
  {   {
Line 431:
Line 431:
  ; Example:   ; Example:
    
− <code cpp-qt> + <syntaxhighlight lang="cpp-qt">
  MyClass::MyClass()   MyClass::MyClass()
     : QObject(),      : QObject(),
Line 445:
Line 445:
  ; Example:   ; Example:
    
− <code cpp-qt> + <syntaxhighlight lang="cpp-qt">
  void MyClass::myAsynchronousMethod(QString someParameter)   void MyClass::myAsynchronousMethod(QString someParameter)
  {   {
Line 456:
Line 456:
  just as well have defined a k_dcop section directly within MyClass:   just as well have defined a k_dcop section directly within MyClass:
    
− <code cpp-qt> + <syntaxhighlight lang="cpp-qt">
  class MyClass: public QObject, virtual public DCOPObject   class MyClass: public QObject, virtual public DCOPObject
  {   {
Line 513:
Line 513:
    
  Code:   Code:
− <code cpp-qt> + <syntaxhighlight lang="cpp-qt">
  #include <kapp.h>   #include <kapp.h>

`Neverendingo: Text replace - "`" to ""

2011-06-29T20:49:28Z

Text replace - "</code>" to "</syntaxhighlight>"

Yecril71pl: /* Performance Tests */ replace entities

2010-05-22T22:17:28Z

‎Performance Tests: replace entities

Yecril71pl: /* Using the dcopidl compiler */ replace entities

2010-05-22T22:15:42Z

‎Using the dcopidl compiler: replace entities

Yecril71pl: /* DCOP Signals */ replace entities

2010-05-22T22:13:46Z

‎DCOP Signals: replace entities

Yecril71pl: /* Processing Received Calls with Transactions */ replace entities

2010-05-22T22:12:10Z

‎Processing Received Calls with Transactions: replace entities

Yecril71pl: /* Receiving Data via DCOP */ replace entities

2010-05-22T22:09:47Z

‎Receiving Data via DCOP: replace entities

Yecril71pl: /* Sending Data to a Remote Application */ replace entities

2010-05-22T22:07:58Z

‎Sending Data to a Remote Application: replace entities

Yecril71pl: /* Sending Data to a Remote Application */ replace entities

2010-05-22T22:06:26Z

‎Sending Data to a Remote Application: replace entities

Yecril71pl: /* Establishing the Connection */ unmark >

2010-05-22T22:03:00Z

‎Establishing the Connection: unmark >

@@ Line 102: / Line 102: @@
   */
 appId = client -> registerAs (kApp -> name());
-</code>
+</syntaxhighlight>
 If you never retrieve the DCOPClient pointer from KApplication, the
@@ Line 157: / Line 157: @@
                       data))
      qDebug ("there was some error using DCOP.");
-</code>
+</syntaxhighlight>
 OK, now let's say we wanted to get the data back from the remotely
@@ Line 182: / Line 182: @@
          qDebug ("doIt returned an unexpected type of reply!");
+}
-</code>
+</syntaxhighlight>
 ''N.B.:'' You cannot call() a method belonging to an application which has
@@ Line 205: / Line 205: @@
      print("the result is: %s", ((QString)reply). latin1());
+}
-</code>
+</syntaxhighlight>
 ==== Receiving Data via DCOP ====
@@ Line 242: / Line 242: @@
+     }
+}
-</code>
+</syntaxhighlight>
 ==== Processing Received Calls with Transactions ====
@@ Line 292: / Line 292: @@
 -> dcopClient() -> endTransaction(myTransaction, replyType, replyData);
+}
-</code>
+</syntaxhighlight>
 ==== DCOP Signals ====
@@ Line 343: / Line 343: @@
 stream << pid;
 kapp -> dcopClient() -> emitDCOPSignal ("clientDied(pid_t)", params);
-</code>
+</syntaxhighlight>
 The task manager of the KDE panel connects to this signal. It uses an
@@ Line 353: / Line 353: @@
 <code cpp-qt>
 connectDCOPSignal (0, 0, "clientDied(pid_t)", "clientDied(pid_t)", false);
-</code>
+</syntaxhighlight>
 It connects the clientDied(pid_t) signal to its own clientDied(pid_t) DCOP
@@ Line 395: / Line 395: @@
 #endif
-</code>
+</syntaxhighlight>
 As you can see, you're essentially declaring an abstract base class, which
@@ Line 420: / Line 420: @@
          QRect mySynchronousMethod();
 };
-</code>
+</syntaxhighlight>
 Note: (Qt issue) Remember that if you are inheriting from {{qt3|QObject}}, you must place it first in the list of inherited classes.
@@ Line 438: / Line 438: @@
      // whatever...
+}
-</code>
+</syntaxhighlight>
 Now you can simply implement the methods you have declared in your interface,
@@ Line 450: / Line 450: @@
      qDebug("myAsyncMethod called with param `" + someParameter + "'");
+}
-</code>
+</syntaxhighlight>
 It is not necessary (though very clean) to define an interface as an
@@ Line 470: / Line 470: @@
          QRect mySynchronousMethod();
 };
-</code>
+</syntaxhighlight>
 In addition to skeletons, dcopidl2cpp also generate stubs. Those make
@@ Line 523: / Line 523: @@
      return app -> exec();
+}
-</code>
+</syntaxhighlight>
 Compiled with:

@@ Line 382: / Line 382: @@
 #define MY_INTERFACE_H
-#include &lt;dcopobject.h&gt;
+#include <dcopobject.h>
 class MyInterface : virtual public DCOPObject
@@ Line 390: / Line 390: @@
      k_dcop:
-         virtual ASYNC myAsynchronousMethod(QString someParameter) = 0;
+         virtual ASYNC myAsynchronousMethod (QString someParameter) = 0;
          virtual QRect mySynchronousMethod() = 0;
 };

@@ Line 340: / Line 340: @@
 <code cpp-qt>
 QByteArray params;
-QDataStream stream(params, IO_WriteOnly);
+QDataStream stream (params, IO_WriteOnly);
-stream &lt;&lt; pid;
+stream << pid;
-kapp-&gt;dcopClient()-&gt;emitDCOPSignal("clientDied(pid_t)", params);
+kapp -> dcopClient() -> emitDCOPSignal ("clientDied(pid_t)", params);
 </code>
@@ Line 352: / Line 352: @@
 <code cpp-qt>
-connectDCOPSignal(0, 0, "clientDied(pid_t)", "clientDied(pid_t)", false);
+connectDCOPSignal (0, 0, "clientDied(pid_t)", "clientDied(pid_t)", false);
 </code>
@@ Line 361: / Line 361: @@
 of the signal. E.g. it is allowed to connect the clientDied(pid_t) signal to
 a clientDied(void) DCOP function.
 === Using the dcopidl compiler ===

@@ Line 260: / Line 260: @@
 <code cpp-qt>
-bool BarObject::process(const QCString &amp;fun, const QByteArray &amp;data,
+bool BarObject::process(const QCString &fun, const QByteArray &data,
-                         QCString &amp;, QByteArray &amp;)
+                         QCString &, QByteArray &)
+{
      if (fun == "doIt(int)") {
-         QDataStream arg(data, IO_ReadOnly);
+         QDataStream arg (data, IO_ReadOnly);
          int i; // parameter
-         arg &gt;&gt; i;
+         arg >> i;
-         QString result = self-&gt;doIt(i);
+         QString result = self -> doIt(i);
          DCOPClientTransaction *myTransaction;
-         myTransaction = kapp-&gt;dcopClient()-&gt;beginTransaction();
+         myTransaction = kapp -> dcopClient() -> beginTransaction();
          // start processing...
          // Calls slotProcessingDone when finished.
-         startProcessing( myTransaction, i);
+         startProcessing (myTransaction, i);
          return true;
@@ Line 283: / Line 283: @@
+}
-slotProcessingDone(DCOPClientTransaction *myTransaction, const QString &amp;result)
+slotProcessingDone(DCOPClientTransaction *myTransaction, const QString &result)
+{
      QCString replyType = "QString";
      QByteArray replyData;
      QDataStream reply(replyData, IO_WriteOnly);
-     reply &lt;&lt; result;
+     reply << result;
-     kapp-&gt;dcopClient()-&gt;endTransaction(myTransaction, replyType, replyData);
+     kapp
+}
 </code>

@@ Line 225: / Line 225: @@
 <code cpp-qt>
-bool BarObject::process(const QCString &amp;fun, const QByteArray &amp;data,
+bool BarObject:: process (const QCString &fun, const QByteArray &data,
-                         QCString &amp;replyType, QByteArray &amp;replyData)
+                         QCString &replyType, QByteArray &replyData)
+{
      if (fun == "doIt(int)") {
-         QDataStream arg(data, IO_ReadOnly);
+         QDataStream arg (data, IO_ReadOnly);
          int i; // parameter
-         arg &gt;&gt; i;
+         arg >> i;
-         QString result = self-&gt;doIt (i);
+         QString result = self -> doIt (i);
-         QDataStream reply(replyData, IO_WriteOnly);
+         QDataStream reply (replyData, IO_WriteOnly);
-         reply &lt;&lt; result;
+         reply << result;
          replyType = "QString";
          return true;
      } else {
-         qDebug("unknown function call to BarObject::process()");
+         qDebug ("unknown function call to BarObject::process()");
          return false;
+     }

@@ Line 514: / Line 514: @@
 Code:
 <code cpp-qt>
-#include &lt;kapp.h&gt;
+#include <kapp.h>
-int main(int argc, char **argv)
+int main (int argc, char **argv)
+{
      KApplication *app;
-     app = new KApplication(argc, argv, "testit");
+     app = new KApplication (argc, argv, "testit");
-     return app-&gt;exec();
+     return app -> exec();
+}
 </code>

@@ Line 153: / Line 153: @@
 QByteArray data;
 QDataStream arg(data, IO_WriteOnly);
-arg &lt;&lt; 5;
+arg << 5;
-if (!client-&gt;send("someAppId", "fooObject/barObject", "doIt(int)",
+if (!client -> send ("someAppId", "fooObject/barObject", "doIt(int)",
                       data))
-     qDebug("there was some error using DCOP.");
+     qDebug ("there was some error using DCOP.");
 </code>

@@ Line 168: / Line 168: @@
 QByteArray data, replyData;
 QCString replyType;
-QDataStream arg(data, IO_WriteOnly);
+QDataStream arg (data, IO_WriteOnly);
-arg &lt;&lt; 5;
+arg << 5;
-if (!client-&gt;call("someAppId", "fooObject/barObject", "doIt(int)",
+if (!client -> call ("someAppId", "fooObject/barObject", "doIt(int)",
                       data, replyType, replyData))
      qDebug("there was some error using DCOP.");
 else {
-     QDataStream reply(replyData, IO_ReadOnly);
+     QDataStream reply (replyData, IO_ReadOnly);
      if (replyType == "QString") {
          QString result;
-         reply &gt;&gt; result;
+         reply >> result;
-         print("the result is: %s",result.latin1());
+         print ("the result is: %s", result. latin1());
      } else
-         qDebug("doIt returned an unexpected type of reply!");
+         qDebug ("doIt returned an unexpected type of reply!");
+}
 </code>
@@ Line 198: / Line 198: @@
 <code cpp-qt>
-DCOPRef barObject("someAppId", "fooObject/barObject");
+DCOPRef barObject ("someAppId", "fooObject/barObject");
-DCOPReply reply = barObject.call("doIt", 5);
+DCOPReply reply = barObject. call ("doIt", 5);
-if (!reply.isValid())
+if (!reply. isValid())
      qDebug("there was some error using DCOP.");
 else {
-     print("the result is: %s", ((QString)reply).latin1());
+     print("the result is: %s", ((QString)reply). latin1());
+}
 </code>

@@ Line 101: / Line 101: @@
   * different from what you passed
   */
-appId = client-&gt;registerAs(kApp-&gt;name());
+appId = client -> registerAs (kApp -> name());
 </code>

Development/Architecture/DCOP - Revision history

Neverendingo: Text replace - "" to ""

Neverendingo: Text replace - "" to ""

Yecril71pl: /* Performance Tests */ replace entities

Yecril71pl: /* Using the dcopidl compiler */ replace entities

Yecril71pl: /* DCOP Signals */ replace entities

Yecril71pl: /* Processing Received Calls with Transactions */ replace entities

Yecril71pl: /* Receiving Data via DCOP */ replace entities

Yecril71pl: /* Sending Data to a Remote Application */ replace entities

Yecril71pl: /* Sending Data to a Remote Application */ replace entities

Yecril71pl: /* Establishing the Connection */ unmark >

Neverendingo: Text replace - "`" to ""`

`Neverendingo: Text replace - "`" to ""