QRemoteObjectNode Class

メンバ関数のドキュメント

QRemoteObjectNode::QRemoteObjectNode(QObject *parent = nullptr)

与えられたparent を持つ QRemoteObjectNode のデフォルトコンストラクタ。この方法で構築された Node は接続することができないため、ネットワーク上にソース・オブジェクトを公開することはできません。また、setRegistryUrl を使用して手動で設定しない限り、QRemoteObjectRegistry も含まれません。

connectToNode およびsetRegistryUrlも参照して ください。

QRemoteObjectNode::QRemoteObjectNode(const QUrl &registryAddress, QObject *parent = nullptr)

QRemoteObjectNode は {QRemoteObjectRegistry} に接続されています。{レジストリ} に接続されています。このように構築されたノードは接続することができないため、ネットワーク上にソース・オブジェクトを公開することはできません。他の（ホスト）ノードの検索と接続は、registryAddress で指定されているQRemoteObjectRegistry によって処理されます。

connectToNode 、setRegistryUrl 、QRemoteObjectHost 、QRemoteObjectRegistryHostも参照して ください。

template <typename ObjectType> ObjectType *QRemoteObjectNode::acquire(const QString &name = QString())

ObjectType 型の Replica へのポインタを返します（これはテンプレート・パラメータであり、QRemoteObjectReplica を継承する必要があります）。つまり、テンプレート・パラメータはrepc が生成した型でなければなりません。name パラメータを使用して、QRemoteObjectHost::enableRemoting() 呼び出し時にオブジェクトに与えられたname を指定できます。

QRemoteObjectDynamicReplica *QRemoteObjectNode::acquireDynamic(const QString &name)

ソースname のQRemoteObjectDynamicReplica を返します。

QAbstractItemModelReplica *QRemoteObjectNode::acquireModel(const QString &name, QtRemoteObjects::InitialAction action = QtRemoteObjects::FetchRootSize, const QList<int> &rolesHint = {})

特にQAbstractItemModel から派生したReplicaへのポインタを返します。指定されたname は、モデルをネットワーク上に配置したenableRemoting と一致する名前と一致しなければなりません。action は、initialized シグナルが発信される前にモデルがデータをフェッチすべきかどうかを指定します。これがQtRemoteObjects::PrefetchData に設定されている場合、rolesHint のロールのデータがプリフェッチされます。rolesHint が空の場合、Sourceが公開するすべてのロールのデータがプリフェッチされます。

返されるモデルは、Source で初期化されるまでは空です。

void QRemoteObjectNode::addClientSideConnection(QIODevice *ioDevice)

外部 QIODevice 上でQRemoteObjectNode::acquire()Replicaオブジェクトを使用するには、Qt Remote Objects はそれぞれのノード間の通信チャネル（QIODevice ）にアクセスする必要があります。これを可能にするのが、ioDevice を入力とする addClientSideConnection() 呼び出しです。addClientSideConnection を呼び出さずにacquire() を呼び出しても動作しますが、ホスト・ノードへの接続が提供されない限り、ノードはレプリカを初期化できません。

QRemoteObjectHostBase::addHostSideConnectionも参照してください 。

[invokable] bool QRemoteObjectNode::connectToNode(const QUrl &address)

address でクライアント・ノードをホスト・ノードに接続します。

接続は、ホストノードが削除されるか、ネットワーク経由でアクセスできなくなるまで有効です。

クライアントがホストに接続されると、対応するソースがリモ ートされている場合、有効なレプリカを取得できます。

成功した場合はtrue を返し、そうでない場合はfalse を返します (通常、認識できない URL、または既に接続されているアドレスへの接続)。

template <typename T> QStringList QRemoteObjectNode::instances() const

このテンプレート化された関数は（repcが生成した型をテンプレートパラメータとして）リモートオブジェクトネットワーク上のその型のインスタンスの名前のリストを返します。例えば、.rep ファイルに Shape クラスが定義されており、Circle と Square クラスが Source 定義を継承している場合、enableRemoting を使用してリモートオブジェク トネットワーク上で共有することができます。

Square square;
Circle circle;
myHost.enableRemoting(&square, "Square");
myHost.enableRemoting(&circle, "Circle");

次に、instance を使用して Shape の利用可能なインスタンスを検索できます。

QStringList instances = clientNode.instances<Shape>();
// will return a QStringList containing "Circle" and "Square"
auto instance1 = clientNode.acquire<Shape>("Circle");
auto instance2 = clientNode.acquire<Shape>("Square");
...

QStringList QRemoteObjectNode::instances(QStringView typeName) const

この関数は、instances() をオーバーロードします。

この便利な関数は、テンプレート化されたバージョンと同じ結果を提供しますが、クラス型から派生するのではなく、Sourceクラスの名前をパラメータとして受け取ります (typeName)。

QRemoteObjectNode::ErrorCode QRemoteObjectNode::lastError() const

最後に設定されたエラーを返します。

void QRemoteObjectNode::registerExternalSchema(const QString &schema, QRemoteObjectNode::RemoteObjectSchemaHandler handler)

外部から提供されたスキーマを処理するカスタム・メソッドを提供する

このメソッドは、レジストリおよび外部スキーマに関連付けられています。外部スキーマ用の std::function ハンドラを登録することで、取得したソースが利用可能になったことがレジストリに通知されたときに、登録されたメソッドが呼び出されるようになります。この登録がなければ、QtRO は「ビルトイン」スキーマしか扱えません。

schema の {QUrl::schema()} を持つ新しい (まだ接続されていない) Node 上のSourceオブジェクトをレジストリが検出すると、提供されたメソッドhandler が呼び出されます。QRemoteObjectNode::RemoteObjectSchemaHandler 型のhandler は、Sourceを提供する Node のQUrl を入力パラメータとして取得し、通信チャネル (QIODevice のようなもの) を確立してaddClientSideConnection を呼び出す役割を果たします。

RemoteObjectSchemaHandlerも参照してください 。

const QRemoteObjectRegistry *QRemoteObjectNode::registry() const

ノードがレジストリ機能を使用している場合、ノードのQRemoteObjectRegistry へのポインタを返します。そうでない場合はnullptr を返します。

[signal] void QRemoteObjectNode::remoteObjectAdded(const QRemoteObjectSourceLocation &loc)

このシグナルは、新しいソースオブジェクトがレジストリに追加されるたびに発行されます。レジストリが設定されていない場合（つまり、connectToNode を介して直接接続されたソース）、このシグナルは発行されません。loc パラメータには、追加されたソースに関する情報（名前、タイプ、ホスティング ノードのQUrl など）が含まれます。

remoteObjectRemoved() およびinstances()も参照してください 。

[signal] void QRemoteObjectNode::remoteObjectRemoved(const QRemoteObjectSourceLocation &loc)

このシグナルは、既知のSourceオブジェクトがレジストリから削除されるたびに発行されます。レジストリが設定されていない場合、このシグナルは発行されません（つまり、connectToNode を介して直接接続されたソース）。loc パラメータには、名前、タイプ、ホスティングしているノードのQUrl など、削除されたソースに関する情報が含まれます。

remoteObjectAdded およびinstancesも参照してください 。

[virtual] void QRemoteObjectNode::setName(const QString &name)

このノードの内部名としてname を設定します。これは、ロギングの一部として出力されます（有効な場合）。これは主に、複数のノードからのログデータをマージする場合に便利です。

[override virtual protected] void QRemoteObjectNode::timerEvent(QTimerEvent *)

再実装します：QObject::timerEvent(QTimerEvent *event)を再実装します。

bool QRemoteObjectNode::waitForRegistry(int timeout = 30000)

このノードのレジストリが初期化されるか、timeout （ミリ秒単位）が経過するまでブロックします。レジストリが正常に初期化された場合はtrue を、そうでない場合はfalse を返します。