QGrpcChannelOptions Class

멤버 함수 문서

QGrpcChannelOptions::QGrpcChannelOptions()

빈 QGrpcChannelOptions 객체를 기본 생성합니다.

QGrpcChannelOptions::QGrpcChannelOptions(const QGrpcChannelOptions &other)

other 에서 QGrpcChannelOptions 객체를 복사하여 생성합니다.

[constexpr noexcept default] QGrpcChannelOptions::QGrpcChannelOptions(QGrpcChannelOptions &&other)

other 에서 새로운 QGrpcChannelOptions 객체를 생성합니다.

[noexcept] QGrpcChannelOptions::~QGrpcChannelOptions()

QGrpcChannelOptions 를 삭제합니다.

[since 6.12] QtGrpc::CompressionAlgorithms QGrpcChannelOptions::acceptedCompressionAlgorithms() const

이 채널이 서버로부터 수락할 수 있는 압축 알고리즘을 반환합니다. gRPC 사양에 따라 비압축 메시지는 반드시 수락되어야 하므로, 이 집합에는 항상 ` Identity `이 포함됩니다.

이 값은 grpc-accept-encoding 요청 헤더를 구성하는 데 사용됩니다. 서버가 이 집합에 포함되지 않은 압축 알고리즘으로 응답하면, 호출은 Unimplemented 상태 코드로 종료됩니다.

기본값은 supportedCompressionAlgorithms()이며, 현재 Qt 빌드가 협상할 수 있는 모든 알고리즘이 표시됩니다.

이 함수는 Qt 6.12에서 도입되었습니다.

setAcceptedCompressionAlgorithms() 및 supportedCompressionAlgorithms()도 참조하십시오 .

[since 6.10] QGrpcChannelOptions &QGrpcChannelOptions::addMetadata(QByteArrayView key, QByteArrayView value)

해당 키-값 쌍이 아직 metadata 에 포함되어 있지 않은 경우, key 및 value 을 추가합니다. 동일한 키가 서로 다른 값을 가지고 여러 번 나타날 수 있습니다.

이 함수는 Qt 6.10에서 도입되었습니다.

metadata() 및 setMetadata()도 참조하십시오 .

[noexcept] std::optional<std::chrono::milliseconds> QGrpcChannelOptions::deadlineTimeout() const

채널의 마감 시간을 계산하는 데 사용되는 타임아웃 기간을 반환합니다.

이 필드가 설정되지 않은 경우, 빈 std::optional 를 반환합니다.

setDeadlineTimeout()도 참조하십시오 .

[noexcept, since 6.11] std::optional<bool> QGrpcChannelOptions::filterServerMetadata() const

결과에서 프로토콜 관련 서버 메타데이터가 제외된 경우 ` true `를 반환합니다. 서버에서 수신한 모든 메타데이터를 포함하려면 ` false `를 반환합니다.

이 필드가 설정되지 않은 경우, 빈 std::optional 를 반환합니다.

이 함수는 Qt 6.11에서 도입되었습니다.

setFilterServerMetadata() 및 QGrpcCallOptions::filterServerMetadata()도 참조하십시오 .

[since 6.12] std::optional<quint64> QGrpcChannelOptions::maximumReceiveMessageSize() const

수신되는 gRPC 메시지의 허용되는 최대 크기(바이트 단위)를 반환합니다. 이 제한은 전송 계층 수준의 복호화 및 메시지별 압축 해제 후 디코딩된 gRPC 프레임 페이로드에 적용됩니다.

값이 지정되지 않은 경우, 빈 ` std::optional`을 반환합니다.

기본적으로 이 값은 지정되지 않습니다.

이 함수는 Qt 6.12에서 도입되었습니다.

setMaximumReceiveMessageSize() 및 QGrpcCallOptions::maximumReceiveMessageSize()도 참조하십시오 .

이 함수는 버전 6.13에서 사용 중단될 예정입니다.

대신 ` metadata`(`QtGrpc::MultiValue`)를 사용하십시오.

메타데이터를 반환합니다. 이 필드가 설정되지 않은 경우, 빈 메타데이터를 반환합니다.

metadata(QtGrpc::MultiValue_t) 및 setMetadata()도 참조하십시오 .

메타데이터를 반환합니다. 이 필드가 설정되지 않은 경우, 빈 메타데이터를 반환합니다.

const auto &md = opts.metadata(QtGrpc::MultiValue);

이 함수들은 Qt 6.10에서 도입되었습니다.

setMetadata도 참조하십시오 .

[since 6.12] std::optional<QtGrpc::CompressionAlgorithm> QGrpcChannelOptions::requestCompression() const

이 채널 또는 호출에서 발신 메시지를 압축하는 데 사용된 압축 알고리즘을 반환합니다.

이 필드가 설정되지 않은 경우, 빈 std::optional 를 반환합니다.

이 함수는 Qt 6.12에서 도입되었습니다.

setRequestCompression() 및 QGrpcCallOptions::requestCompression()도 참조하십시오 .

[since 6.8] QGrpcSerializationFormat QGrpcChannelOptions::serializationFormat() const

채널에서 사용하는 직렬화 형식을 반환합니다.

이 필드가 설정되지 않은 경우, ` Default `로 생성된 직렬화 형식을 반환합니다.

이 함수는 Qt 6.8에서 도입되었습니다.

setSerializationFormat()도 참조하십시오 .

[since 6.12] QGrpcChannelOptions &QGrpcChannelOptions::setAcceptedCompressionAlgorithms(QtGrpc::CompressionAlgorithms algorithms)

허용되는 압축 형식 algorithms 을 설정하고, 업데이트된 객체에 대한 참조를 반환합니다.

Identity gRPC 사양에 따라 클라이언트는 압축되지 않은 메시지를 수락해야 하므로, 이 플래그는 항상 묵시적으로 추가됩니다.

{QtGrpc::CompressionAlgorithm::Identity} 에 허용되는 알고리즘이 하나뿐인 경우, 압축된 응답은 거부됩니다. 플래그를 추가하면 서버가 해당 압축 알고리즘을 사용하여 응답할 수 있습니다.

이 Qt 빌드에서 지원되고 algorithms 에 포함된 알고리즘만 허용되는 응답 압축 방법으로 서버에 알립니다. supportedCompressionAlgorithms()에 없는 플래그는 아무런 오류 메시지 없이 무시됩니다.

이 함수는 Qt 6.12에서 도입되었습니다.

acceptedCompressionAlgorithms() 및 supportedCompressionAlgorithms()도 참조하십시오 .

QGrpcChannelOptions &QGrpcChannelOptions::setDeadlineTimeout(std::chrono::milliseconds timeout)

timeout 를 설정하고, 업데이트된 객체에 대한 참조를 반환합니다.

데드라인은 클라이언트가 서버의 응답을 기다릴 수 있는 최대 시간을 설정합니다. 실제 데드라인은 RPC의 시작 시간에 응답 완료 시간( timeout )을 더하여 계산됩니다.

데드라인은 RPC의 전체 수명 주기에 적용되며, 여기에는 이전에 시작된 호출에 대한 최종 QGrpcStatus 수신도 포함되므로 (장기간 지속되는) 스트림의 경우 원치 않는 결과가 발생할 수 있습니다.

deadlineTimeout()도 참조하십시오 .

[since 6.11] QGrpcChannelOptions &QGrpcChannelOptions::setFilterServerMetadata(bool value)

value 가 true 인 경우, gRPC 전송 프로토콜에 의해 정의된 프로토콜 관련 메타데이터(예: 예약된 grpc- 키)는 제외됩니다. value 가 false 인 경우, 서버로부터 수신된 모든 메타데이터가 포함됩니다.

이 함수는 Qt 6.11에서 도입되었습니다.

filterServerMetadata() 및 QGrpcCallOptions::setFilterServerMetadata()도 참조하십시오 .

[since 6.12] QGrpcChannelOptions &QGrpcChannelOptions::setMaximumReceiveMessageSize(quint64 size)

수신 메시지의 최대 크기 size 를 바이트 단위로 설정하고, 업데이트된 객체에 대한 참조를 반환합니다.

이 제한을 초과하는 메시지는 페이로드가 버퍼에 저장되기 전에 ` StatusCode::ResourceExhausted ` 오류와 함께 거부됩니다. 이 값은 그대로 사용되므로, ` size ` 값이 ` 0 `인 경우 빈 메시지만 허용됩니다.

이 함수는 Qt 6.12에서 도입되었습니다.

maximumReceiveMessageSize() 및 QGrpcCallOptions::setMaximumReceiveMessageSize()도 참조하십시오 .

이 함수는 버전 6.13에서 사용 중단될 예정입니다.

대신 ` QMultiHash ` 오버로드를 사용하십시오.

metadata 를 설정하고 업데이트된 객체에 대한 참조를 반환합니다.

metadata()도 참조하십시오 .

metadata 를 설정하고, 업데이트된 객체에 대한 참조를 반환합니다.

이 함수들은 Qt 6.10에서 도입되었습니다.

metadata(QtGrpc::MultiValue_t)도 참조하십시오 .

[since 6.12] QGrpcChannelOptions &QGrpcChannelOptions::setRequestCompression(QtGrpc::CompressionAlgorithm algorithm)

클라이언트가 전송하는 메시지를 압축하는 데 사용되는 압축 방식 algorithm 을 설정하고, 업데이트된 객체에 대한 참조를 반환합니다.

이 값이 설정되면 해당 알고리즘이 ` grpc-encoding ` 요청 헤더에 명시됩니다. 각 메시지는 독립적으로 압축되며, 압축으로 인해 페이로드 크기가 줄어들지 않는 경우에도 ` Compressed-Flag `가 ` 0 `로 설정된 상태에서 메시지는 압축되지 않은 상태로 전송됩니다.

이 함수는 Qt 6.12에서 도입되었습니다.

requestCompression() 및 QGrpcCallOptions::setRequestCompression()도 참조하십시오 .

[since 6.8] QGrpcChannelOptions &QGrpcChannelOptions::setSerializationFormat(const QGrpcSerializationFormat &format)

채널에 대한 직렬화 format 를 설정하고, 업데이트된 객체에 대한 참조를 반환합니다.

이 함수는 Qt 6.8에서 도입되었습니다.

serializationFormat()도 참조하십시오 .

QGrpcChannelOptions &QGrpcChannelOptions::setSslConfiguration(const QSslConfiguration &sslConfiguration)

채널의 sslConfiguration 를 설정하고, 업데이트된 객체에 대한 참조를 반환합니다.

sslConfiguration()도 참조하십시오 .

std::optional<QSslConfiguration> QGrpcChannelOptions::sslConfiguration() const

채널의 SSL 구성을 반환합니다.

이 필드가 설정되지 않은 경우, 빈 std::optional 를 반환합니다.

setSslConfiguration()도 참조하십시오 .

[static noexcept, since 6.12] QtGrpc::CompressionAlgorithms QGrpcChannelOptions::supportedCompressionAlgorithms()

현재 Qt 빌드가 협상할 수 있는 압축 알고리즘을 반환합니다. gRPC 사양에서는 비압축 메시지를 의무화하고 있으므로 ‘ Identity ’는 항상 존재합니다. ‘ Deflate ’와 ‘ Gzip ’는 항상 지원됩니다.

이 함수는 Qt 6.12에서 도입되었습니다.

acceptedCompressionAlgorithms() 및 setAcceptedCompressionAlgorithms()도 참조하십시오 .

[noexcept, since 6.8] void QGrpcChannelOptions::swap(QGrpcChannelOptions &other)

other 를 이 객체로 교체합니다. 이 작업은 매우 빠르며 실패하는 일이 없습니다.

이 함수는 Qt 6.8에서 도입되었습니다.

[since 6.8] QGrpcChannelOptions::operator QVariant() const

이 객체를 기반으로 새로운 ` QVariant ` 객체를 생성합니다.

이 함수는 Qt 6.8에서 도입되었습니다.

[noexcept] QGrpcChannelOptions &QGrpcChannelOptions::operator=(QGrpcChannelOptions &&other)

other 를 이 QGrpcChannelOptions 로 이동-할당하고, 업데이트된 객체에 대한 참조를 반환합니다.

QGrpcChannelOptions &QGrpcChannelOptions::operator=(const QGrpcChannelOptions &other)

이 QGrpcChannelOptions 에 other 를 할당하고, 업데이트된 객체에 대한 참조를 반환합니다.