例 1：静的ソースを使用した直接接続

1. ソース・オブジェクトの作成

   このソース・オブジェクトを作成するには、まず定義ファイルsimpleswitch.rep を作成します。このファイルには、オブジェクトのプロパティとメソッドが記述され、Qt Remote Objects Compilerrepc に入力されます。このファイルには、レプリカに公開するために必要なインターフェイスのみが定義されています。

   simpleswitch.rep

   class SimpleSwitch
   {
       PROP(bool currState=false);
       SLOT(server_slot(bool clientState));
   };

   simpleswitch.rep にあります、

   • currState はスイッチの現在の状態を保持する。
   • server_slot() により、ソースと対話することができる。 信号に接続される。echoSwitchState(bool newstate)

   repc がこのファイルを処理するには、cmake ファイルに以下の行を追加します：

   qt6_add_repc_sources(directconnectserver
       simpleswitch.rep
   )

   qmake ：

   REPC_SOURCE = simpleswitch.rep

   これらの説明は Qt Remote Objects モジュールにのみ関係しますので、プロジェクトに追加する必要があります。CMakeを使用している場合は、以下を追加してください：

   find_package(Qt6 REQUIRED COMPONENTS RemoteObjects)
   target_link_libraries(directconnectserver PRIVATE Qt6::RemoteObjects)

   qmake を使っている場合は、以下を追加してください：

   QT       += remoteobjects

   repc は指定したビルドディレクトリにrep_SimpleSwitch_source.h ヘッダーを作成します。詳細については、ソースを参照してください。

   repc は QtRO で使用する 3 つのヘルパークラスを作成します。この例では、基本的なものを使います:SimpleSwitchSimpleSource 。これは抽象クラスで、rep_SimpleSwitch_source.h で定義されています。このクラスから派生して、SimpleSwitchの実装クラスを定義します：

   simpleswitch.h

   #ifndef SIMPLESWITCH_H
   #define SIMPLESWITCH_H
   
   #include "rep_simpleswitch_source.h"
   
   class SimpleSwitch : public SimpleSwitchSimpleSource
   {
       Q_OBJECT
   public:
       SimpleSwitch(QObject *parent = nullptr);
       ~SimpleSwitch();
       void server_slot(bool clientState) override;
   public Q_SLOTS:
       void timeout_slot();
   private:
       QTimer *stateChangeTimer;
   };
   
   #endif

   simpleswitch.h で定義されています、

   • stateChangeTimer は で、SimpleSwitch の状態を切り替えるのに使われます。QTimer
   • timeout_slot() は の timeout() シグナルに接続されています。stateChangeTimer
   • server_slot() - このシグナルは、レプリカがスロットのバージョンを呼び出すたびに、ソース上で自動的に呼び出されます。
   • currStateChanged(bool) rep_SimpleSwitch_source.hこのシグナルは、 currState がトグルするたびに出力されます。この例では、ソース側でこのシグナルを無視し、後でレプリカ側で処理します。

   SwitchState クラスの定義を以下に示します：

   simpleswitch.cpp

   #include "simpleswitch.h"// コンストラクタSimpleSwitch::SimpleSwitch(QObject*parent) ：SimpleSwitchSimpleSource(parent) { stateChangeTimer= newQTimer(this);// タイマーを初期化する   QObject::connect(stateChangeTimer, &)QTimer::timeout, this, &SimpleSwitch::timeout_slot);// stateChangeTimerからのtimeout()シグナルをsimpleSwitchのtimeout_slot()に接続 stateChangeTimer->start(2000);// タイマーを開始し、タイムアウトを2秒に設定する    qDebug() << "Source Node Started";
   }//デストラクタSimpleSwitch::~SimpleSwitch() { stateChangeTimer->stop(); }voidSimpleSwitch::server_slot(boolclientState){
       qDebug() << "Replica state is " << clientState; // print switch state echoed back by client
   }voidSimpleSwitch::timeout_slot() {// タイマーのタイムアウト時に呼び出されるスロット if(currState())// 現在の状態が true かどうかをチェックする。currState() は repc で生成された rep_simpleswitch_source.h で定義されているsetCurrState(false);// 状態を false に設定する elsesetCurrState(true);// 状態を true に設定する    qDebug() << "Source State is "<<currState();
   
   }

2. レジストリの作成

   この例ではノード間の直接接続を使用している

   ため

   、このステップは省略できます。

3. ホストノードの

   作成ホストノードは以下のように作成されます：

   QRemoteObjectHost srcNode(QUrl(QStringLiteral("local:replica")));

4. ホストソースオブジェクトとリモーティング

   以下のステートメントでソースオブジェクトをインスタンス化し、ホストに渡して「リモーティング」（オブジェクトを QtRO ネットワークから見えるようにするプロセス）を有効にします：

   SimpleSwitch srcSwitch; // create simple switch
   srcNode.enableRemoting(&srcSwitch); // enable remoting

   上記のステップを実装したmain.cpp ファイルの内容は以下のとおりです：

   main.cpp

   #include <QCoreApplication>
   #include "simpleswitch.h"
   
   int main(int argc, char *argv[])
   {
       QCoreApplication a(argc, argv);
   
       SimpleSwitch srcSwitch; // create simple switch
   
       // Create host node without Registry:
       QRemoteObjectHost srcNode(QUrl(QStringLiteral("local:replica")));
       srcNode.enableRemoting(&srcSwitch); // enable remoting/sharing
   
       return a.exec();
   }

   このソース側プロジェクトをコンパイルして実行します。出力は、レプリカが作成されていない状態で、2秒ごとにtrue とfalse の間でスイッチの状態が切り替わり、以下のようになるはずです。

   

この例では、ソースからスイッチの状態を取得し、それをエコーバックしています。

レプリカコード

1. repcを使用してプロジェクトにレプリカを追加する

   ソース側で行ったのと同じAPI定義ファイルSimpleSwitch.rep

   、

   repcを使用してReplicaヘッダーファイルを作成します。cmake を使用している場合は、クライアント側のcmake ファイルに以下の行を追加し、.rep ファイルの入力を指定します：

   qt6_add_repc_replicas(directconnectclient
       simpleswitch.rep
   )

   qmake を使用している場合は、クライアント側の.pro ファイルに以下の行を追加します：

   REPC_REPLICA = simpleswitch.rep

   repcツールは、ビルド・ディレクトリにrep_SimpleSwitch_replica.h ファイルを生成します。詳細は、「Replica」を参照してください。

2. ソースのホスト・ノードと接続するノードを作成する

   次のコードは、ネットワーク上の 2 番目のノードをインスタンス化し、ソースのホスト・ノードと接続します：

   QRemoteObjectNode repNode; // create remote object node
   repNode.connectToNode(QUrl(QStringLiteral("local:replica"))); // connect with remote host node

3. ノードのacquire() を呼び出して、レプリカへのポインタを作成します。

   まず、レプリカをインスタンス化します：

   QSharedPointer<SimpleSwitchReplica> ptr;
   ptr.reset(repNode.acquire<SimpleSwitchReplica>()); // acquire replica of source from host node

   注: acquire() はレプリカへのポインタを返しますが、その寿命は管理しません。この例では、ポインタが常に適切に削除されるように、返されたポインタをQSharedPointer またはQScopedPointer でラップすることを推奨しています。

   main.cpp は上記の手順を実装し、オブジェクトをインスタンス化します：

   main.cpp

   #include <QCoreApplication>
   #include "client.h"
   
   int main(int argc, char *argv[])
   {
       QCoreApplication a(argc, argv);
   
       QSharedPointer<SimpleSwitchReplica> ptr; // shared pointer to hold source replica
   
       QRemoteObjectNode repNode; // create remote object node
       repNode.connectToNode(QUrl(QStringLiteral("local:replica"))); // connect with remote host node
   
       ptr.reset(repNode.acquire<SimpleSwitchReplica>()); // acquire replica of source from host node
   
       Client rswitch(ptr); // create client switch object and pass reference of replica to it
   
       return a.exec();
   }

   Client クラスの完全な宣言と定義は以下の通りである：

   client.h

   #ifndef _CLIENT_H
   #define _CLIENT_H
   
   #include <QObject>
   #include <QSharedPointer>
   
   #include "rep_simpleswitch_replica.h"
   
   class Client : public QObject
   {
       Q_OBJECT
   public:
       Client(QSharedPointer<SimpleSwitchReplica> ptr);
       ~Client() override = default;
       void initConnections();// Function to connect signals and slots of source and client
   
   Q_SIGNALS:
       void echoSwitchState(bool switchState);// this signal is connected with server_slot(..) on the source object and echoes back switch state received from source
   
   public Q_SLOTS:
       void recSwitchState_slot(bool); // slot to receive source state
   private:
       bool clientSwitchState; // holds received server switch state
       QSharedPointer<SimpleSwitchReplica> reptr;// holds reference to replica
   
    };
   
   #endif

   client.cpp

   #include "client.h"// コンストラクタClient::Client(QSharedPointer<SimpleSwitchReplica>ptr) ：   QObject(nullptr),reptr(ptr) {// 初期化スロットで初期化された レプリカの シグナルを接続します。initConnections();//  レプリカは repc によって生成されたので、 //  SimpleSwitchReplica のシグナル/ スロットに 直接 接続できます 。   QObject::connect(reptr.data(), &SimpleSwitchReplica::currStateChanged, this, &Client::recSwitchState_slot);// クライアントの echoSwitchState(...) シグナルとレプリカの server_slot(...) を接続して、受信した状態をエコーバックする。   QObject::connect(this, &Client::echoSwitchState,reptr.data(), &SimpleSwitchReplica::server_slot); }voidClient::recSwitchState_slot(boolvalue){
       qDebug() << "Received source state "<< value << reptr.data()->currState();
       clientSwitchState=reptr.data()->currState(); Q_EMIT echoSwitchState(clientSwitchState);// 受信した状態をサーバーにエコーバックするシグナルを出力する}

   この例をソース側の例と一緒にコンパイルして実行すると、以下の出力が生成されます：