QRemoteObjectNode Class

メンバ関数ドキュメント

QRemoteObjectNode::QRemoteObjectNode(QObject *parent = nullptr)

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

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

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

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

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

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

ObjectType 型（テンプレート・パラメータであり、QRemoteObjectReplica を継承する必要がある）の Replica へのポインタを返します。つまり、テンプレート・パラメータは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");

その後、インスタンスを使用して、利用可能な 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() をオーバーロードしたものです。

この便利な関数は、テンプレート化されたバージョンと同じ結果を提供しますが、クラス・タイプから派生するのではなく、ソース・クラスの名前をパラメータとして受け取ります (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)

このシグナルは、既知のソースオブジェクトがレジストリから削除されるたびに発行される。レジストリが設定されていない場合（つまり、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 を返す。