QRemoteObjectNode Class

멤버 함수 문서

QRemoteObjectNode::QRemoteObjectNode(QObject *parent = nullptr)

지정된 parent 을 가진 QRemoteObjectNode의 기본 생성자. 이렇게 생성된 노드는 연결할 수 없으므로 네트워크에 소스 오브젝트를 노출할 수 없습니다. 또한 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())

(템플릿 매개 변수이며 QRemoteObjectReplica 에서 상속해야 하는) ObjectType 유형의 레플리카에 대한 포인터를 반환합니다. 즉, 템플릿 매개변수는 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 에서 특별히 파생된 레플리카에 대한 포인터를 반환합니다. 제공된 name 은 모델을 네트워크에 배치한 enableRemoting 과 사용된 이름이 일치해야 합니다. action 은 모델이 initialized 신호가 전송되기 전에 데이터를 가져올지 여부를 지정합니다. QtRemoteObjects::PrefetchData 로 설정된 경우 rolesHint 에 있는 역할에 대한 데이터가 미리 가져오게 됩니다. rolesHint 이 비어 있으면 소스에 의해 노출된 모든 역할에 대한 데이터가 프리페치됩니다.

반환된 모델은 소스로 초기화될 때까지 비어 있습니다.

void QRemoteObjectNode::addClientSideConnection(QIODevice *ioDevice)

외부 QIODevices를 통해 개체를 QRemoteObjectNode::acquire() 복제하려면 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 클래스가 소스 정의에서 상속되는 경우 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

이 함수는 인스턴스()를 오버로드합니다.

이 편의 함수는 템플릿 버전과 동일한 결과를 제공하지만 클래스 유형에서 파생하는 대신 소스 클래스의 이름을 매개변수(typeName)로 사용합니다.

QRemoteObjectNode::ErrorCode QRemoteObjectNode::lastError() const

마지막 오류 집합을 반환합니다.

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

외부에서 제공된 스키마를 처리하는 사용자 정의 메서드 제공

이 메서드는 레지스트리 및 외부 스키마에 연결됩니다. 외부 스키마에 대한 std::함수 핸들러를 등록하면 획득한 소스를 사용할 수 있다는 알림이 레지스트리에 수신될 때 등록된 메서드가 호출됩니다. 이 등록이 없으면 QtRO는 "내장" 스키마만 처리할 수 있습니다.

제공된 메서드인 handler 는 레지스트리가 아직 연결되지 않은 새 노드에서 {QUrl::schema()}가 schema 인 소스 객체를 발견하면 호출됩니다. 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(Q타이머이벤트 *이벤트).

bool QRemoteObjectNode::waitForRegistry(int timeout = 30000)

이 노드의 레지스트리가 초기화되거나 timeout (밀리초 단위)가 만료될 때까지 차단합니다. 반환 시 레지스트리가 성공적으로 초기화되면 true, 그렇지 않으면 false 을 반환합니다.