QCoapClient Class

QCoapClient *client = new QCoapClient(this);
connect(client, &QCoapClient::finished, this, &TestClass::slotFinished);
client->get(QCoapRequest(Qurl("coap://coap.me/test")));

QCoapRequest request = QCoapRequest(Qurl("coap://coap.me/obs"));
QCoapReply *reply = client->observe(request);
connect(reply, &QCoapReply::notified, this, &TestClass::slotNotified);

client->cancelObserve(reply);

멤버 함수 문서

[explicit] QCoapClient::QCoapClient(QtCoap::SecurityMode securityMode = QtCoap::SecurityMode::NoSecurity, QObject *parent = nullptr)

지정된 securityMode 에 대한 QCoapClient 객체를 생성하고, parent 를 부모 객체로 설정합니다.

securityMode 의 기본값은 QtCoap::NoSecurity 이며, 이 경우 보안 기능이 비활성화됩니다.

[virtual noexcept] QCoapClient::~QCoapClient()

QCoapClient 객체를 삭제하고 모든 리소스를 해제합니다. 이 클래스에서 반환되는 QCoapReply 객체들은 QCoapClient 가 부모로 설정되어 있으므로, 해당 객체도 와 함께 삭제된다는 점에 유의하십시오.

void QCoapClient::cancelObserve(QCoapReply *notifiedReply)

observe() 메서드가 반환한 응답인 ` notifiedReply `을 사용하여 리소스의 관측을 취소합니다.

observe()도 참조하십시오 .

void QCoapClient::cancelObserve(const QUrl &url)

url 로 식별되는 리소스의 관측을 취소합니다.

observe()도 참조하십시오 .

QCoapReply *QCoapClient::deleteResource(const QCoapRequest &request)

DELETE 메서드를 사용하여 request 를 전송하고, 새로운 QCoapReply 객체를 반환합니다.

get(), put(), post(), observe(), discover()도 참조하십시오 .

QCoapReply *QCoapClient::deleteResource(const QUrl &url)

대상 url 로 DELETE 요청을 보냅니다.

get(), put(), post(), observe() 및 discover()도 참조하십시오 .

void QCoapClient::disconnect()

열려 있는 소켓과 연결을 닫아 전송 경로를 해제합니다.

setSecurityConfiguration()도 참조하십시오 .

QCoapResourceDiscoveryReply *QCoapClient::discover(const QUrl &url, const QString &discoveryPath = QLatin1String("/.well-known/core"))

지정된 url 에서 사용 가능한 리소스를 탐색하고, 응답이 도착할 때마다 QCoapResourceDiscoveryReply::discovered() 신호를 발산하는 새로운 QCoapResourceDiscoveryReply 객체를 반환합니다.

탐색 경로는 기본적으로 "/.well-known/core"이지만, discoveryPath 에 다른 경로를 전달하여 변경할 수 있습니다. 탐색에 대한 설명은 RFC 6690에 나와 있습니다.

get(), post(), put(), deleteResource(), observe()도 참조하십시오 .

QCoapResourceDiscoveryReply *QCoapClient::discover(QtCoap::MulticastGroup group = QtCoap::MulticastGroup::AllCoapNodesIPv4, int port = QtCoap::DefaultPort, const QString &discoveryPath = QLatin1String("/.well-known/core"))

지정된 port 에 있는 group 에 가입한 엔드포인트에서 사용 가능한 리소스를 탐색합니다. 응답이 도착할 때마다 QCoapResourceDiscoveryReply::discovered() 신호를 발산하는 새로운 QCoapResourceDiscoveryReply 객체를 반환합니다. group 는 CoAP 멀티캐스트 그룹 주소 중 하나이며, 기본값은 QtCoap::AllCoapNodesIPv4 입니다.

디스커버리 경로는 기본적으로 "/.well-known/core"이지만, discoveryPath 에 다른 경로를 전달하여 변경할 수 있습니다. 디스커버리에 대한 설명은 RFC 6690에 나와 있습니다.

get(), post(), put(), deleteResource(), observe()도 참조하십시오 .

[signal] void QCoapClient::error(QCoapReply *reply, QtCoap::Error error)

이 신호는 오류가 발생할 때마다 전송됩니다. 오류가 특정 QCoapReply 과 관련이 없는 경우, reply 매개변수는 nullptr 로 설정될 수 있습니다. error 매개변수에는 오류 코드가 포함됩니다.

finished(), QCoapReply::error(), QCoapReply::finished()도 참조하십시오 .

[signal] void QCoapClient::finished(QCoapReply *reply)

이 신호는 성공 또는 오류 발생 후 CoAP 응답을 수신할 때마다 QCoapReply::finished() 신호와 함께 전송됩니다. reply 매개변수에는 방금 수신된 응답에 대한 포인터가 포함됩니다.

error(), QCoapReply::finished(), QCoapReply::error()도 참조하십시오 .

QCoapReply *QCoapClient::get(const QCoapRequest &request)

GET 메서드를 사용하여 request 를 전송하고, 새로운 QCoapReply 객체를 반환합니다.

post(), put(), deleteResource(), observe() 및 discover()도 참조하십시오 .

QCoapReply *QCoapClient::get(const QUrl &url)

url 로 GET 요청을 보내고, 새로운 QCoapReply 객체를 반환합니다.

post(), put(), deleteResource(), observe() 및 discover()도 참조하십시오 .

QCoapReply *QCoapClient::observe(const QCoapRequest &request)

대상 request 을 관찰하라는 요청을 보내고, 새로운 알림이 도착할 때마다 QCoapReply::notified() 신호를 발생시키는 새로운 QCoapReply 객체를 반환합니다.

cancelObserve(), get(), post(), put(), deleteResource() 및 discover()도 참조하십시오 .

QCoapReply *QCoapClient::observe(const QUrl &url)

대상 url 을 관찰하기 위한 요청을 전송하고, 새로운 알림이 도착할 때마다 QCoapReply::notified() 신호를 발산하는 새로운 QCoapReply 객체를 반환합니다.

cancelObserve(), get(), post(), put(), deleteResource() 및 discover()도 참조하십시오 .

QCoapReply *QCoapClient::post(const QCoapRequest &request, const QByteArray &data = QByteArray())

POST 메서드를 사용하여 request 을 전송하고 새로운 QCoapReply 객체를 반환합니다. 이 요청의 페이로드로 data 을 사용합니다. data 이 비어 있는 경우, request 의 페이로드가 사용됩니다.

get(), put(), deleteResource(), observe(), discover()도 참조하십시오 .

QCoapReply *QCoapClient::post(const QCoapRequest &request, QIODevice *device)

POST 메서드를 사용하여 request 을 전송하고, 새로운 QCoapReply 객체를 반환합니다. 이 요청의 페이로드로 device 의 내용을 사용합니다. null인 장치는 빈 콘텐츠로 간주되며, 이 경우 request 의 페이로드가 사용됩니다.

get(), put(), deleteResource(), observe(), discover()도 참조하십시오 .

QCoapReply *QCoapClient::post(const QUrl &url, const QByteArray &data = QByteArray())

url 로 POST 요청을 전송하고 새로운 QCoapReply 객체를 반환합니다. 이 요청의 페이로드로 data 을 사용합니다.

get(), put(), deleteResource(), observe() 및 discover()도 참조하십시오 .

QCoapReply *QCoapClient::put(const QCoapRequest &request, const QByteArray &data = QByteArray())

PUT 메서드를 사용하여 request 를 전송하고, 새로운 QCoapReply 객체를 반환합니다. 이 요청의 페이로드로 data 를 사용합니다. data 가 비어 있는 경우, request 의 페이로드가 사용됩니다.

get(), post(), deleteResource(), observe(), discover()도 참조하십시오 .

QCoapReply *QCoapClient::put(const QCoapRequest &request, QIODevice *device)

PUT 메서드를 사용하여 ` request `을 전송하고, 새로운 ` QCoapReply ` 객체를 반환합니다. 이 요청의 페이로드로 ` device `의 내용을 사용합니다. null인 디바이스는 빈 콘텐츠로 간주되며, 이 경우 ` request `의 페이로드가 사용됩니다.

get(), post(), deleteResource(), observe(), discover()도 참조하십시오 .

QCoapReply *QCoapClient::put(const QUrl &url, const QByteArray &data = QByteArray())

url 로 PUT 요청을 전송하고 새로운 QCoapReply 객체를 반환합니다. 이 요청의 페이로드로 data 를 사용합니다.

get(), post(), deleteResource(), observe(), discover()도 참조하십시오 .

[signal] void QCoapClient::responseToMulticastReceived(QCoapReply *reply, const QCoapMessage &message, const QHostAddress &sender)

이 신호는 멀티캐스트 요청에 대한 유니캐스트 응답이 도착했을 때 발생합니다. ` reply ` 매개변수에는 방금 수신된 응답에 대한 포인터가 포함되어 있으며, ` message `에는 페이로드와 메시지 세부 정보가, ` sender `에는 발신자 주소가 포함되어 있습니다.

또한 error(), QCoapReply::finished(), QCoapReply::error()를 참조하십시오 .

void QCoapClient::setAckRandomFactor(double ackRandomFactor)

RFC 7252 - 섹션 4.2에 정의된 ‘ ACK_RANDOM_FACTOR ’ 값을 ‘ ackRandomFactor ’로 설정합니다. 이 값은 1 이상이어야 합니다. 기본값은 1.5입니다.

setAckTimeout()도 참조하십시오 .

void QCoapClient::setAckTimeout(uint ackTimeout)

RFC 7252 - 섹션 4.2에 정의된 ‘ ACK_TIMEOUT ’ 값을 밀리초 단위로 ‘ ackTimeout ’로 설정합니다. 기본값은 2000 ms입니다.

이 타임아웃은 확인 가능한 메시지에만 적용됩니다. 신뢰성 있는 전송에 대한 실제 타임아웃은 ACK_TIMEOUT 과 ACK_TIMEOUT * ACK_RANDOM_FACTOR 사이의 임의의 값입니다.

setAckRandomFactor()도 참조하십시오 .

void QCoapClient::setBlockSize(quint16 blockSize)

요청을 전송하고 응답을 수신할 때 프로토콜이 사용하는 최대 블록 크기를 blockSize 로 설정합니다. 블록 크기는 2의 거듭제곱이어야 합니다.

void QCoapClient::setMaximumRetransmitCount(uint maximumRetransmitCount)

RFC 7252 - 섹션 4.2에 정의된 ` MAX_RETRANSMIT ` 값을 ` maximumRetransmitCount`로 설정합니다. 이 값은 25 이하여야 합니다. 기본값은 4입니다.

void QCoapClient::setMaximumServerResponseDelay(uint responseDelay)

MAX_SERVER_RESPONSE_DELAY 값을 responseDelay (밀리초 단위)로 설정합니다. 기본값은 250초입니다.

RFC 7390 - 섹션 2.5에 정의된 바와 같이, MAX_SERVER_RESPONSE_DELAY 는 클라이언트가 멀티캐스트 요청을 보낼 수 있는 모든 서버에 대한 예상 최대 응답 지연 시간입니다.

void QCoapClient::setMinimumTokenSize(int tokenSize)

최소 토큰 크기를 바이트 단위로 tokenSize 로 설정합니다. 보안상의 이유로 길이가 최소 4바이트인 토큰을 사용하는 것이 권장됩니다. 이 매개변수의 기본값은 4바이트입니다.

void QCoapClient::setSecurityConfiguration(const QCoapSecurityConfiguration &configuration)

configuration 에서 보안 구성 매개변수를 설정합니다. ‘ QtCoap::NoSecurity ’ 모드를 사용하는 경우 이 구성은 무시됩니다.

참조: disconnect().

void QCoapClient::setSocketOption(QAbstractSocket::SocketOption option, const QVariant &value)

QUdpSocket 소켓 option 을 value 으로 설정합니다.