QRemoteObjectRegistryHost Class

A (Host/Registry) node on a Qt Remote Objects network. More...

Header: #include <QRemoteObjectRegistryHost>
qmake: QT += remoteobjects
Inherits: QRemoteObjectHostBase

Public Functions

QRemoteObjectRegistryHost(const QUrl &registryAddress = QUrl(), QObject *parent = nullptr)
virtual ~QRemoteObjectRegistryHost() override

Reimplemented Public Functions

virtual bool setRegistryUrl(const QUrl &registryUrl) override

Additional Inherited Members

Detailed Description

A (Host/Registry) node on a Qt Remote Objects network.

The QRemoteObjectRegistryHost class provides an entry point to a QtRemoteObjects network. A network can be as simple as two Nodes, or an arbitrarily complex set of processes and devices.

A QRemoteObjectRegistryHost has the same capability that a QRemoteObjectHost has (which includes everything a QRemoteObjectNode supports), and in addition is the owner of the Registry. Any QRemoteObjectHost node that connects to this Node will have all of their Source objects made available by the Registry.

Nodes only support connection to one registry, calling QRemoteObjectNode::setRegistryUrl when a Registry is already set is considered an error. For something like a secure and insecure network (where different Registries would be applicable), the recommendation is to create separate Nodes to connect to each, in effect creating two independent Qt Remote Objects networks.

Nodes may connect to each other directly using connectToNode, or they can use the QRemoteObjectRegistry to simplify connections.

The QRemoteObjectRegistry is a special Replica available to every Node that connects to the Registry Url. It knows how to connect to every QRemoteObjectSource object on the network.

See also QRemoteObjectNode and QRemoteObjectHost.

Member Function Documentation

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

Constructs a new QRemoteObjectRegistryHost Node with the given parent. RegistryHost Nodes have the same functionality as QRemoteObjectHost Nodes, except rather than being able to connect to a QRemoteObjectRegistry, the provided Host QUrl (registryAddress) becomes the address of the registry for other Nodes to connect to.

[override virtual] QRemoteObjectRegistryHost::~QRemoteObjectRegistryHost()

Destroys the instance of QRemoteObjectRegistryHost. The destructor is virtual.

[override virtual] bool QRemoteObjectRegistryHost::setRegistryUrl(const QUrl &registryUrl)

Reimplemented from QRemoteObjectNode::setRegistryUrl().

This method can be used to set the address of this Node to registryUrl (used for other Nodes to connect to this one), if the QUrl isn't set in the constructor. Since this Node becomes the Registry, calling this setter method causes this Node to use the url as the host address. All other Node's use the QRemoteObjectNode::setRegistryUrl method initiate a connection to the Registry.

See also QRemoteObjectRegistryHost() and QRemoteObjectNode::setRegistryUrl.

Voted #1 for:

  • Easiest to learn
  • Most time saving
  • Best support

Develop Cross-Platform Apps and Games 50% Faster!

  • Voted the best supported, most time-saving and easiest to learn cross-platform development tool
  • Based on the Qt framework, with native performance and appearance on all platforms including iOS and Android
  • Offers a variety of plugins to monetize, analyze and engage users
create apps
create games
cross platform
native performance
3rd party services
game network
level editor
easiest to learn
biggest time saving
best support