QRemoteObjectHostBase 类提供基本共有功能为 Host and RegistryHost 类。 更多...
| 头： | #include <QRemoteObjectHostBase> |
| CMake: |
find_package(Qt6 REQUIRED COMPONENTS RemoteObjects)
target_link_libraries(mytarget PRIVATE Qt6::RemoteObjects) |
| qmake: | QT += remoteobjects |
| 继承： | QRemoteObjectNode |
| 继承者： |
| enum | AllowedSchemas { BuiltInSchemasOnly, AllowExternalRegistration } |
| void | addHostSideConnection (QIODevice * ioDevice ) |
| bool | disableRemoting (QObject * remoteObject ) |
| bool | enableRemoting (ObjectType * object ) |
| bool | enableRemoting (QObject * object , const QString & name = QString()) |
| bool | enableRemoting (QAbstractItemModel * model , const QString & name , const QList<int> roles , QItemSelectionModel * selectionModel = nullptr) |
| bool | proxy (const QUrl & registryUrl , const QUrl & hostUrl = {}, QRemoteObjectHostBase::RemoteObjectNameFilter filter = [](QStringView, QStringView) {return true; }) |
| bool | reverseProxy (QRemoteObjectHostBase::RemoteObjectNameFilter filter = [](QStringView, QStringView) {return true; }) |
| virtual void | setName (const QString & name ) override |
QRemoteObjectHostBase is a base class that cannot be instantiated directly. It provides the enableRemoting and disableRemoting 功能共享通过所有主机节点 ( Host and RegistryHost ) 及逻辑要求暴露 源 对象在远程对象网络。
This enum is used to specify whether a Node will accept a url with an unrecognized schema for the hostUrl. By default only urls with known schemas are accepted, but using
AllowExternalRegistration
will enable the
注册
to pass your external (to QtRO) url to client Nodes.
| 常量 | 值 | 描述 |
|---|---|---|
QRemoteObjectHostBase::BuiltInSchemasOnly
|
0
|
Only allow the hostUrl to be set to a QtRO supported schema. This is the default value, and causes a Node error to be set if an unrecognized schema is provided. |
QRemoteObjectHostBase::AllowExternalRegistration
|
1
|
The provided schema is registered as an 外部模式 |
另请参阅 QRemoteObjectHost .
In order to QRemoteObjectHost::enableRemoting () 源 objects over 外部 QIODevices , Qt Remote Objects needs access to the communications channel (a QIODevice ) between the respective nodes. It is the addHostSideConnection() call that enables this on the 源 side, taking the ioDevice as input. Any enableRemoting () call will still work without calling addHostSideConnection, but the Node will not be able to share the 源 objects without being provided the connection to the Replica node. Before calling this function you must call setHostUrl () with a unique URL and AllowExternalRegistration .
另请参阅 addClientSideConnection .
[invokable]
bool
QRemoteObjectHostBase::
disableRemoting
(
QObject
*
remoteObject
)
禁用远程访问
QObject
remoteObject
。返回
false
若当前节点是客户端节点，或者若
remoteObject
未注册，和返回
true
若 Source (源) 对象成功禁用远程。
警告： 此对象的复本将不再有效，在调用此方法后。
注意： 此函数可以被援引，通过元对象系统和从 QML。见 Q_INVOKABLE .
另请参阅 enableRemoting ().
This templated function overload enables a host node to provide remote access to a QObject object with a specified (and compile-time checked) interface. Client nodes connected to the node hosting this object may obtain Replicas of this Source.
This is best illustrated by example:
#include "rep_TimeModel_source.h" MinuteTimer timer; hostNode.enableRemoting<MinuteTimerSourceAPI>(&timer);
Here the MinuteTimerSourceAPI is the set of Signals/Slots/Properties defined by the TimeModel.rep file. Compile time checks are made to verify the input QObject can expose the requested API, it will fail to compile otherwise. This allows a subset of object 's interface to be exposed, and allows the types of conversions supported by Signal/Slot connections.
返回
false
若当前节点是客户端节点，或者若
QObject
已注册为远程，和
true
若成功启用远程为
QObject
.
另请参阅 disableRemoting ().
[invokable]
bool
QRemoteObjectHostBase::
enableRemoting
(
QObject
*
object
, const
QString
&
name
= QString())
使主机节点能够动态提供远程访问 QObject object 。连接到托管此对象的节点的客户端节点，可以获得此源的复本。
可选 name defines the lookup-name under which the QObject can be acquired using QRemoteObjectNode::acquire () . If not explicitly set then the name given in the QCLASSINFO_REMOTEOBJECT_TYPE will be used. If no such macro was defined for the QObject 那么 QObject::objectName () is used.
返回
false
若当前节点是客户端节点，或者若
QObject
已注册为远程，和
true
若成功启用远程为动态
QObject
.
注意： 此函数可以被援引，通过元对象系统和从 QML。见 Q_INVOKABLE .
另请参阅 disableRemoting ().
This overload of enableRemoting() is specific to QAbstractItemModel types (or any type derived from QAbstractItemModel ). This is useful if you want to have a model and the HMI for the model in different processes.
The three required parameters are the model itself, the name by which to lookup the model, and the roles that should be exposed on the Replica side. If you want to synchronize selection between 源 and 复本 , the optional selectionModel parameter can be used. This is only recommended when using a single Replica.
Behind the scenes, Qt Remote Objects batches data() lookups and prefetches data when possible to make the model interaction as responsive as possible.
返回
false
若当前节点是客户端节点，或者若
QObject
已注册为远程，和
true
若成功启用远程为
QAbstractItemModel
.
另请参阅 disableRemoting ().
从另一网络转发远程对象
The proxy functionality is useful when you want to share 源 objects over multiple networks. For instance, if you have an embedded target using target-only connections (like local) and you want to make some of those same objects available externally.
As a concrete example, say you have a set of processes talking to each other on your target hardware using a registry, with the 注册 at "local:registry" and separate processes using a node at "local:MyHost" that holds 源 objects. If you wanted to access these objects, but over tcp, you could create a new proxyNode like so:
// myInternalHost is a node only visible on the device... QRemoteObjectHost myInternalHost("local:MyHost"); myInternalHost.enableRemoting<SomeObject>(&someObject); // Regular host node, listening on port 12123, so visible to other // devices QRemoteObjectHost proxyNode("tcp://localhost:12123"); // Enable proxying objects from nodes on the local machine's internal // QtRO bus proxyNode.proxy("local:registry");
And from another device you create another node:
// NB: localhost resolves to a different ip address than proxyNode QRemoteObjectHost nodeOnRemoteDevice("tcp://localhost:23234"); // Connect to the target's proxyNode directly, or use a tcp registry... nodeOnRemoteDevice.connectToNode("tcp://<target device>:12123"); // Because of the proxy, we can get the object over tcp/ip port 12123, // even though we can't connect directly to "local:MyHost" SomeObject *so = nodeOnRemoteDevice.acquire<SomeObject>();
This would (internally) create a node in proxyNode, which (again internally/automatically) connects to the provided registry (given by the
registryUrl
parameter, "local:registry" in this example). Whenever local:registry emits the
remoteObjectAdded
signal, the
QRemoteObjectSourceLocation
被传递给
filter
given to the proxy call. If this method returns true (the default filter simply returns true without any filtering), the object is acquired() from the internal node and
enableRemoting
() (once the replica is initialized) is called on proxyNode.
若 hostUrl is provided (which is required to enable reverseProxy , but not needed otherwise), the internal node will be a QRemoteObjectHost node configured with the provided address. If no hostUrl is provided, the internal node will be a QRemoteObjectNode (not HostNode).
返回
true
if the object is acquired from the internal node.
另请参阅 reverseProxy ().
转发远程对象到另一网络。
The reverseProxy() function allows the proxy () functionality to be extended, in effect mirroring the proxy functionality in the "reverse" direction. These are distinct, because node communication is not symmetric, one side calls enableRemoting () 采用 源 object, the other side calls acquire () to get a 复本 。使用 proxy () allows you to "observe" objects on a target device remotely via acquire, but it does not allow off-target 源 objects to be acquired from the device's local:* network. That is where reverseProxy() comes in. If a proxyNode is created like so:
// myInternalHost is a node only visible on the device... QRemoteObjectHost myInternalHost("local:MyHost", "local:registry"); // RegistryHost node, listening on port 12123, so visible to other // devices. The node must be a RegistryHost, so the Sources on // the "outside" network can be forwarded to the inner network. QRemoteObjectRegistryHost proxyNode("tcp://0.0.0.0:12123"); // Enable proxying objects from nodes on the local machine's internal // QtRO bus. Note the hostUrl parameter is now needed. proxyNode.proxy("local:registry", "local:fromProxy"); proxyNode.reverseProxy();
And from another device you create another node:
// Listen on a local port, and connect to "proxyNode" as the registry. // NB: localhost resolves to a different ip address than proxyNode QRemoteObjectHost nodeOnRemoteDevice("tcp://localhost:23234", "tcp://<target device>:12123"); // Because of the reverseProxy, we can expose objects on this device // and they will make their way to proxyNode... nodeOnRemoteDevice.enableRemoting<OtherObject>(&otherObject);
// Acquire() can now see the objects on other devices through proxyNode, // due to the reverseProxy call. OtherObject *oo = myInternalHost.acquire<OtherObject>();
While the proxy () functionality allows 源 objects on another network to be acquired(), reverseProxy() allows 源 objects to be "pushed" to an otherwise inaccessible network.
注意：
proxy
() needs to be called before reverseProxy(), and a hostUrl needs to be provided to
proxy
for reverseProxy() to work. The reverseProxy() method allows a separate
filter
to be applied. This reverseProxy specific filter will receive notifications of new
源
objects on
proxyNode
and acquire them on the internal node if they pass the
filter
.
返回
true
当成功时，
false
否则。
注意：
Currently the reverse proxy functionality is supported only for
QRemoteObjectRegistryHost
. Calling this method on a
QRemoteObjectHost
node will always return
false
.
另请参阅 proxy ().
[override virtual]
void
QRemoteObjectHostBase::
setName
(const
QString
&
name
)
重实现： QRemoteObjectNode::setName (const QString &name).
类似于 QObject::setObjectName () (which this method calls), but this version also applies the name to internal classes as well, which are used in some of the debugging output.