QRemoteObjectNode Class

成员函数文档

QRemoteObjectNode::QRemoteObjectNode(QObject *parent = nullptr)

QRemoteObjectNode 的默认构造函数，其给定值为parent 。以这种方式构建的节点无法连接，因此无法在网络上公开源对象。它也不会包含QRemoteObjectRegistry ，除非使用setRegistryUrl 手动设置。

另请参阅 connectToNode 和setRegistryUrl 。

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

连接到 {QRemoteObjectRegistry} {Registry} 的 QRemoteObjectNode。{注册表}。以这种方式构建的节点无法被连接，因此也就无法在网络上公开源对象。查找和连接其他（主机）节点由registryAddress 指定的QRemoteObjectRegistry 处理。

另请参见 connectToNode,setRegistryUrl,QRemoteObjectHost 和QRemoteObjectRegistryHost 。

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

返回指向 ObjectType 类型的 Replica 的指针（ObjectType 是模板参数，必须继承自QRemoteObjectReplica ）。也就是说，模板参数必须是repc生成的类型。name 参数可用于指定在调用QRemoteObjectHost::enableRemoting() 时赋予对象的name 。

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

返回QRemoteObjectDynamicReplica 的源name 。

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

返回一个指向Replica的指针，该Replica是专门从QAbstractItemModel 派生的。所提供的name 必须与将模型放到网络上的与enableRemoting 匹配的名称相匹配。action 指定模型是否应在initialized 信号发出前获取数据。如果设置为QtRemoteObjects::PrefetchData ，那么rolesHint 中角色的数据将被预取。如果rolesHint 为空，则会预取Source公开的所有角色的数据。

在使用源初始化之前，返回的模型将是空的。

void QRemoteObjectNode::addClientSideConnection(QIODevice *ioDevice)

为了通过外部 QIOD 设备 QRemoteObjectNode::acquire()复制对象，Qt Remote Objects 需要访问各节点之间的通信通道（QIODevice ）。addClientSideConnection()调用将ioDevice 作为输入，从而实现了这一功能。任何不调用 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::函数处理程序，当注册表收到您获取的源可用的通知时，注册的方法将被调用。如果没有注册，QtRO 将只能处理 "内置 "模式。

当注册表在一个新节点（尚未连接）上看到一个{QUrl::schema()}为schema 的源对象时，就会调用所提供的方法handler 。类型为QRemoteObjectNode::RemoteObjectSchemaHandler 的handler 将获取提供源作为输入参数的节点的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 。