QWebEngineUrlScheme Class
QWebEngineUrlScheme 클래스는 사용자 지정 URL 스키마를 구성합니다. 더 보기...
Header: | #include <QWebEngineUrlScheme> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore) target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
qmake: | QT += webenginecore |
공용 타입
enum | Flag { SecureScheme, LocalScheme, LocalAccessAllowed, NoAccessAllowed, ServiceWorkersAllowed, …, FetchApiAllowed } |
flags | Flags |
enum | SpecialPort { PortUnspecified } |
enum class | Syntax { HostPortAndUserInformation, HostAndPort, Host, Path } |
공용 함수
QWebEngineUrlScheme() | |
QWebEngineUrlScheme(const QByteArray &name) | |
QWebEngineUrlScheme(const QWebEngineUrlScheme &that) | |
QWebEngineUrlScheme(QWebEngineUrlScheme &&that) | |
~QWebEngineUrlScheme() | |
int | defaultPort() const |
QWebEngineUrlScheme::Flags | flags() const |
QByteArray | name() const |
void | setDefaultPort(int newValue) |
void | setFlags(QWebEngineUrlScheme::Flags newValue) |
void | setName(const QByteArray &newValue) |
void | setSyntax(QWebEngineUrlScheme::Syntax newValue) |
QWebEngineUrlScheme::Syntax | syntax() const |
bool | operator!=(const QWebEngineUrlScheme &that) const |
QWebEngineUrlScheme & | operator=(QWebEngineUrlScheme &&that) |
QWebEngineUrlScheme & | operator=(const QWebEngineUrlScheme &that) |
bool | operator==(const QWebEngineUrlScheme &that) const |
정적 공용 멤버
void | registerScheme(const QWebEngineUrlScheme &scheme) |
QWebEngineUrlScheme | schemeByName(const QByteArray &name) |
상세 설명
웹 엔진 URL 스키마는 웹 엔진의 관점에서 URL 스키마를 설명하며, 이 스키마의 URL을 구문 분석하는 방법과 해당 URL에서 시작된 리소스에 대해 어떤 보안 제한을 적용해야 하는지를 지정합니다.
사용자 지정 URL 스키마는 애플리케이션 시작 시 Qt WebEngine 클래스를 만들기 전에 조기에 구성해야 합니다. 일반적으로 이는 QGuiApplication 또는 QApplication 인스턴스를 만들기 전에 스키마를 구성해야 함을 의미합니다.
등록된 모든 스키마 구성은 모든 프로필에 전역적으로 적용됩니다.
int main(int argc, char **argv) { QWebEngineUrlScheme scheme("myscheme"); scheme.setSyntax(QWebEngineUrlScheme::Syntax::HostAndPort); scheme.setDefaultPort(2345); scheme.setFlags(QWebEngineUrlScheme::SecureScheme); QWebEngineUrlScheme::registerScheme(scheme); ... }
실제로 사용자 지정 URL 체계를 사용하려면 QWebEngineUrlSchemeHandler 을 만들어 프로필에 등록해야 합니다.
QWebEngineUrlSchemeHandler 를참조하세요 .
멤버 유형 문서
열거형 QWebEngineUrlScheme::Flag
플래그 QWebEngineUrlScheme::Flags
이 열거형 유형은 URL 스키마에 적용해야 하는 보안 옵션을 지정합니다.
Constant | 값 | 설명 |
---|---|---|
QWebEngineUrlScheme::SecureScheme | 0x1 | URL 스키마가 잠재적으로 신뢰할 수 있음을 나타냅니다. 이 플래그는 암호화 또는 기타 수단을 통해 데이터 신뢰성, 기밀성 및 무결성을 보장하는 URL 체계에만 적용해야 합니다. 안전한 기본 제공 스키마의 예로는 https (인증 및 암호화됨) 및 qrc (로컬 리소스 전용)이 있으며, http 은 안전하지 않은 스키마의 예입니다. |
QWebEngineUrlScheme::LocalScheme | 0x2 | URL 스키마가 로컬 리소스에 대한 액세스를 제공함을 나타냅니다. 이 플래그의 목적은 네트워크 콘텐츠가 로컬 리소스에 액세스하는 것을 방지하는 것입니다. LocalAccessAllowed 플래그가 있는 스키마만 LocalScheme 플래그가 있는 스키마에서 리소스를 로드할 수 있습니다. 이 플래그가 있는 유일한 기본 제공 스키마는 file 입니다. |
QWebEngineUrlScheme::LocalAccessAllowed | 0x4 | 이 스키마의 콘텐츠가 LocalScheme 플래그가 있는 스키마에서 리소스를 로드할 수 있도록 허용해야 함을 나타냅니다. |
QWebEngineUrlScheme::NoAccessAllowed | 0x8 | 이 스키마의 모든 콘텐츠가 고유한 불투명 출처를 가져야 함을 나타냅니다(두 리소스의 출처가 같을 수 없음). |
QWebEngineUrlScheme::ServiceWorkersAllowed | 0x10 | 서비스 워커 API를 사용하도록 설정해야 함을 나타냅니다. |
QWebEngineUrlScheme::ViewSourceAllowed | 0x20 | 소스 보기 기능을 사용하도록 설정해야 함을 나타냅니다. |
QWebEngineUrlScheme::ContentSecurityPolicyIgnored | 0x40 | 이 체계에 대한 액세스가 모든 콘텐츠 보안 정책 검사를 우회해야 함을 나타냅니다. |
QWebEngineUrlScheme::CorsEnabled | 0x80 | 이 체계에 대해 CORS(교차 출처 리소스 공유)를 사용하도록 설정합니다. 이 플래그는 다른 출처의 문서에서 콘텐츠를 로드하는 데 필요하며, 여기에는 다른 스키마의 액세스가 포함됩니다. 적절한 CORS 헤더는 QWebEngineUrlRequestJob 클래스에 의해 자동으로 생성됩니다. 기본적으로 http 및 https 만 CORS가 활성화됩니다. (Qt 5.14에 추가됨) |
QWebEngineUrlScheme::FetchApiAllowed (since Qt 6.6) | 0x100 | HTML5 가져오기 API 및 본문과 함께 XMLHttpRequest.send 에서 사용할 URL 스키마를 활성화합니다. 기본적으로 http 및 https 만 Fetch API를 사용하거나 본문이 포함된 XMLHttpRequest 으로 전송할 수 있습니다. |
Flags 유형은 QFlags<Flag>에 대한 타입 정의입니다. 플래그 값의 OR 조합을 저장합니다.
enum QWebEngineUrlScheme::SpecialPort
이 열거형 유형은 defaultPort 에 대한 특수 값을 정의합니다.
상수 | 값 | 설명 |
---|---|---|
QWebEngineUrlScheme::PortUnspecified | -1 | URL 스키마에 포트 요소가 없음을 나타냅니다. |
enum class QWebEngineUrlScheme::Syntax
이 열거형 유형은 URL 구문의 유형을 나열합니다.
사용자 정의 URL 스키마에 동일 출처 정책을 적용하려면 WebEngine 에서 URL의 원본(호스트 및 포트 조합)을 계산할 수 있어야 합니다. Host...
옵션은 URL 구문이 표준 URL 구문(예: http
)을 따르며 자동으로 동일 출처 정책을 사용하도록 설정함을 나타냅니다. Path
옵션은 URL 구문이 비표준 구문을 사용하며 동일 출처 정책을 적용할 수 없음을 나타냅니다.
상수 | 값 | 설명 |
---|---|---|
QWebEngineUrlScheme::Syntax::HostPortAndUserInformation | 0 | 이 유형의 URL의 권한 구성 요소에는 호스트, 포트, 사용자 이름 및 비밀번호와 같은 모든 표준 요소가 포함됩니다. 포트가 없는 URL은 defaultPort ( PortUnspecified 이 아니어야 함)를 사용합니다. |
QWebEngineUrlScheme::Syntax::HostAndPort | 1 | 이 유형의 URL의 권한 구성 요소에는 호스트 및 포트 요소만 있습니다. 포트가 없는 URL은 defaultPort ( PortUnspecified)을 사용합니다. |
QWebEngineUrlScheme::Syntax::Host | 2 | 이 유형의 URL의 권한 구성 요소에는 호스트 부분만 있고 포트가 없습니다. defaultPort 은 PortUnspecified 으로 설정해야 합니다. |
QWebEngineUrlScheme::Syntax::Path | 3 | 이 유형의 URL에는 권한 구성 요소가 전혀 없습니다. 스키마 이름과 구분 문자(:) 뒤의 모든 것은 유효성 검사나 정규화 없이 그대로 유지됩니다. 이러한 스키마의 모든 URL은 출처가 동일한 것으로 간주됩니다( NoAccessAllowed 플래그가 사용되지 않는 한). |
멤버 함수 문서
QWebEngineUrlScheme::QWebEngineUrlScheme()
기본값으로 웹 엔진 URL 체계를 구성합니다.
[explicit]
QWebEngineUrlScheme::QWebEngineUrlScheme(const QByteArray &name)
주어진 name 으로 웹 엔진 URL 체계를 구축합니다.
QWebEngineUrlScheme::QWebEngineUrlScheme(const QWebEngineUrlScheme &that)
복사 that.
QWebEngineUrlScheme::QWebEngineUrlScheme(QWebEngineUrlScheme &&that)
이동 that.
[noexcept]
QWebEngineUrlScheme::~QWebEngineUrlScheme()
이 오브젝트를 파괴합니다.
int QWebEngineUrlScheme::defaultPort() const
이 URL 체계의 기본 포트를 반환합니다.
기본값은 PortUnspecified
입니다.
setDefaultPort()도 참조하세요 .
QWebEngineUrlScheme::Flags QWebEngineUrlScheme::flags() const
이 URL 체계에 대한 플래그를 반환합니다.
기본값은 빈 플래그 집합입니다.
QByteArray QWebEngineUrlScheme::name() const
이 URL 체계의 이름을 반환합니다.
기본값은 빈 문자열입니다.
setName()도 참조하세요 .
[static]
void QWebEngineUrlScheme::registerScheme(const QWebEngineUrlScheme &scheme)
scheme 을 웹 엔진의 URL 파서 및 보안 모델에 등록합니다.
기본 옵션을 사용하더라도 애플리케이션을 시작할 때 모든 사용자 지정 URL 체계를 이 기능에 먼저 등록하는 것이 좋습니다.
경고: 이 함수는 애플리케이션 시작 시 WebEngine 클래스를 만들기 전에 일찍 호출해야 합니다. 늦게 호출하면 무시됩니다.
schemeByName()도 참조하세요 .
[static]
QWebEngineUrlScheme QWebEngineUrlScheme::schemeByName(const QByteArray &name)
지정된 name 또는 기본 구성된 스키마를 사용하여 웹 엔진 URL 스키마를 반환합니다.
registerScheme()도 참조하세요 .
void QWebEngineUrlScheme::setDefaultPort(int newValue)
이 URL 체계의 기본 포트를 newValue 로 설정합니다.
defaultPort()도 참조하세요 .
void QWebEngineUrlScheme::setFlags(QWebEngineUrlScheme::Flags newValue)
이 URL 체계의 플래그를 newValue 로 설정합니다.
void QWebEngineUrlScheme::setName(const QByteArray &newValue)
이 URL 체계의 이름을 newValue 로 설정합니다.
참고: 이름은 자동으로 소문자로 변환됩니다.
name()도 참조하세요 .
void QWebEngineUrlScheme::setSyntax(QWebEngineUrlScheme::Syntax newValue)
이 URL 체계의 구문 유형을 newValue 로 설정합니다.
QWebEngineUrlScheme::Syntax QWebEngineUrlScheme::syntax() const
이 URL 구문 체계의 구문 유형을 반환합니다.
기본값은 Path
입니다.
bool QWebEngineUrlScheme::operator!=(const QWebEngineUrlScheme &that) const
이 객체와 that 객체가 같지 않으면 true
을 반환합니다.
QWebEngineUrlScheme &QWebEngineUrlScheme::operator=(QWebEngineUrlScheme &&that)
이동 that.
QWebEngineUrlScheme &QWebEngineUrlScheme::operator=(const QWebEngineUrlScheme &that)
복사 that.
bool QWebEngineUrlScheme::operator==(const QWebEngineUrlScheme &that) const
이 객체와 that 객체가 같으면 true
을 반환합니다.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.