QRemoteObjectNode Class

Documentación de funciones miembro

QRemoteObjectNode::QRemoteObjectNode(QObject *parent = nullptr)

Constructor por defecto para QRemoteObjectNode con la dirección parent. Un Nodo construido de esta manera no puede ser conectado, y por lo tanto no puede exponer objetos Fuente en la red. Tampoco incluirá un QRemoteObjectRegistry, a menos que se establezca manualmente usando setRegistryUrl.

Véase también connectToNode y setRegistryUrl.

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

QRemoteObjectNode conectado a un {QRemoteObjectRegistry} {Registro}. Un Nodo construido de esta manera no puede ser conectado, y por lo tanto no puede exponer objetos Fuente en la red. Encontrar y conectarse a otros Nodos (Anfitriones) es manejado por el QRemoteObjectRegistry especificado por registryAddress.

Véase también connectToNode, setRegistryUrl, QRemoteObjectHost, y QRemoteObjectRegistryHost.

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

Devuelve un puntero a una Réplica de tipo ObjectType (que es un parámetro de plantilla y debe heredar de QRemoteObjectReplica). Es decir, el parámetro de plantilla debe ser un tipo generado por repc. El parámetro name puede utilizarse para especificar el name dado al objeto durante la llamada a QRemoteObjectHost::enableRemoting().

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

Devuelve un QRemoteObjectDynamicReplica de la Fuente name.

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

Devuelve un puntero a una Réplica que se deriva específicamente de QAbstractItemModel. El name proporcionado debe coincidir con el nombre utilizado con el enableRemoting coincidente que puso el Modelo en la red. action especifica si el modelo debe obtener datos antes de que se emita la señal initialized. Si se establece en QtRemoteObjects::PrefetchData, entonces los datos de los roles en el rolesHint serán pre-obtenidos. Si rolesHint está vacío, entonces los datos de todos los roles expuestos por la Fuente serán precargados.

El modelo devuelto estará vacío hasta que se inicialice con la Fuente.

void QRemoteObjectNode::addClientSideConnection(QIODevice *ioDevice)

Para poder QRemoteObjectNode::acquire() Replicar objetos sobre QIODevices Externos, Qt Remote Objects necesita acceso al canal de comunicaciones (un QIODevice) entre los respectivos nodos. Es la llamada addClientSideConnection() la que permite esto, tomando el ioDevice como entrada. Cualquier llamada a acquire() realizada sin llamar a addClientSideConnection seguirá funcionando, pero el Nodo no podrá inicializar la Réplica sin que se le proporcione la conexión con el Nodo Anfitrión.

Véase también QRemoteObjectHostBase::addHostSideConnection.

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

Conecta un nodo cliente al nodo anfitrión en address.

Las conexiones seguirán siendo válidas hasta que el nodo anfitrión se elimine o deje de ser accesible a través de una red.

Una vez que un cliente está conectado a un host, se pueden adquirir réplicas válidas si la fuente correspondiente está siendo remotada.

Devuelve true en caso de éxito, false en caso contrario (normalmente una url no reconocida, o conexión a una dirección ya conectada).

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

Esta función de plantilla (que toma un tipo generado por repc como parámetro de plantilla) devolverá la lista de nombres de cada instancia de ese tipo en la red de Objetos Remotos. Por ejemplo, si tiene una clase Shape definida en un archivo .rep, y las clases Circle y Square heredan de la definición Source, pueden compartirse en la red de Objetos Remotos utilizando enableRemoting.

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

Entonces se puede utilizar instance para encontrar las instancias disponibles de 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

Esta función proporciona el mismo resultado que la versión con plantilla, pero toma el nombre de la clase Fuente como parámetro (typeName) en lugar de derivarlo del tipo de clase.

QRemoteObjectNode::ErrorCode QRemoteObjectNode::lastError() const

Devuelve el último conjunto de errores.

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

Proporcionar un método personalizado para manejar esquemas proporcionados externamente.

Este método está vinculado al Registro y a los Esquemas Externos. Registrando un manejador std::function para un esquema externo, el método registrado será llamado cuando el registro sea notificado de que una Fuente que ha adquirido está disponible. Sin este registro, QtRO sólo podría manejar los esquemas "incorporados".

El método proporcionado, handler, será llamado cuando el registro vea un objeto Fuente en un Nodo nuevo (aún no conectado) con un {QUrl::schema()} de schema. El handler, de tipo QRemoteObjectNode::RemoteObjectSchemaHandler obtendrá el QUrl del Nodo que proporciona la Fuente como parámetro de entrada, y es responsable de establecer el canal de comunicaciones (un QIODevice de algún tipo) y llamar a addClientSideConnection con él.

Véase también RemoteObjectSchemaHandler.

const QRemoteObjectRegistry *QRemoteObjectNode::registry() const

Devuelve un puntero al Nodo QRemoteObjectRegistry, si el Nodo está utilizando la función Registro; en caso contrario devuelve nullptr.

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

Esta señal se emite cada vez que se añade un nuevo objeto Fuente al Registro. La señal no se emitirá si no hay ningún Registro establecido (es decir, Fuentes sobre conexiones realizadas a través de connectToNode directamente). El parámetro loc contiene la información sobre la Fuente añadida, incluido el nombre, el tipo y el QUrl del Nodo anfitrión.

Véase también remoteObjectRemoved() y instances().

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

Esta señal se emite cada vez que se elimina del Registro un objeto Fuente conocido. La señal no se emitirá si no hay ningún Registro establecido (es decir, Fuentes sobre conexiones realizadas a través de connectToNode directamente). El parámetro loc contiene la información sobre la Fuente eliminada, incluido el nombre, el tipo y el QUrl del Nodo anfitrión.

Véase también remoteObjectAdded y instances.

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

Establece name como el nombre interno de este Nodo. Este nombre se mostrará como parte del registro (si está activado). Esto es útil principalmente si fusiona datos de registro de múltiples nodos.

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

Reimplementa: QObject::timerEvent(QTimerEvent *event).

bool QRemoteObjectNode::waitForRegistry(int timeout = 30000)

Bloquea hasta que el Registro de este Nodo es inicializado o timeout (en milisegundos) expira. Devuelve true si el Registro se inicializa correctamente, o false en caso contrario.