地址类QUrl

QUrl 是 PySide6.QtCore 模块中的一个类，用于处理和操作 URL（统一资源定位符）。它可以解析、构建、修改和验证 URL 字符串，广泛应用于网络编程和需要处理地址的场景。

主要功能

• 解析和构建 URL：可以从字符串创建 QUrl 对象，也可以将 QUrl 对象转换为字符串。
• 分解和修改 URL 各部分：如 scheme（协议）、host（主机）、port（端口）、path（路径）、query（查询参数）、fragment（片段）等。
• 编码与解码：自动处理 URL 编码和解码，保证特殊字符的正确传递。
• 验证 URL：可以判断 URL 是否有效（isValid）、是否为本地文件（isLocalFile）等。

URL 格式介绍

URL（统一资源定位符）通常由以下几个部分组成：

• scheme（协议）：指定访问资源所用的协议，如 http、https、ftp、file 等。
• user（用户名） 和 password（密码）：可选，部分协议支持在 URL 中包含用户名和密码。
• host（主机）：资源所在的服务器地址，可以是域名或 IP 地址。
• port（端口）：可选，指定服务器的端口号，若省略则使用协议的默认端口。
• path（路径）：资源在服务器上的具体位置。
• query（查询参数）：可选，提供额外的参数信息，格式为 key=value。
• fragment（片段）：可选，指向资源内部的某个位置，常用于网页锚点。

一个典型的 URL 格式如下：

scheme://user:password@host:port/path?query#fragment

例如：

https://user:pass@example.com:8080/path/page.html?query=123#section

部分	示例值	说明
scheme	https	协议
user	user	用户名（可选）
password	pass	密码（可选）
host	example.com	主机
port	8080	端口（可选）
path	/path/page.html	路径
query	query=123	查询参数（可选）
fragment	section	片段（可选）

常见 scheme（协议）类型

scheme	说明
http	超文本传输协议
https	安全超文本传输协议
ftp	文件传输协议
file	本地文件
ws	WebSocket
wss	安全 WebSocket
mailto	电子邮件地址
data	内嵌数据
smb	Windows 共享文件协议
nfs	网络文件系统
ssh	安全 Shell 协议
telnet	终端网络传输协议
imap	电子邮件 IMAP 协议
pop3	邮件 POP3 协议
tel	电子电话号码
javascript	JavaScript 脚本
vnc	虚拟桌面协议
rtsp	实时传输流协议
rtmp	实时传输媒体协议
rmi	远程方法调用协议
irc	Internet 聊天协议
gopher	互联网文件传输协议
nntp	网络新闻传输协议
nc	网络控制协议
sshs	安全 Shell 协议
sftp	安全文件传输协议
rlogin	远程登录协议
rsync	远程同步协议
rsh	远程 shell 协议
ssh2	安全 Shell 协议
MMS	多媒体分享协议
ed2k	eDonkey 电驴网络传输协议
thunder	迅雷网络传输协议
Flashget	FlashGet 网络传输协议

不同的 scheme 决定了 URL 的用途和访问方式，QUrl 支持多种协议，具体可参考官方文档。

QUrl 类常用方法

• QUrl()：构造一个空的 QUrl 对象。
• QUrl(string)：通过字符串创建 QUrl 对象。
• isValid()：判断 URL 是否有效。
• isEmpty()：判断 URL 是否为空。
• isLocalFile()：判断是否为本地文件路径。
• scheme()：获取协议部分（如 http、https）。
• setScheme(scheme)：设置协议部分。
• host()：获取主机名。
• setHost(host)：设置主机名。
• port()：获取端口号。
• setPort(port)：设置端口号。
• userName()：获取用户名。
• setUserName(name)：设置用户名。
• password()：获取密码。
• setPassword(password)：设置密码。
• path()：获取路径部分。
• setPath(path)：设置路径部分。
• query()：获取查询参数字符串。
• setQuery(query)：设置查询参数字符串。
• fragment()：获取片段（锚点）。
• setFragment(fragment)：设置片段。
• toString()：将 QUrl 对象转换为字符串。
• fromLocalFile(path)：通过本地文件路径创建 QUrl 对象。
• toLocalFile()：将 QUrl 转换为本地文件路径。
• resolved(relative)：合并相对路径，返回新的 QUrl。

常用方法示例

from PySide6.QtCore import QUrl# 创建 QUrl 对象
url = QUrl("https://www.example.com:8080/path/page.html?query=123#section")# 获取各部分
print(url.scheme())    # https
print(url.host())      # www.example.com
print(url.port())      # 8080
print(url.path())      # /path/page.html
print(url.query())     # query=123
print(url.fragment())  # section# 修改 URL
url.setHost("www.qt.io")
print(url.toString())  # https://www.qt.io:8080/path/page.html?query=123#section# 检查有效性
print(url.isValid())   # True# 判断是否为本地文件
local_url = QUrl.fromLocalFile("C:/Users/Example/file.txt")
print(local_url.isLocalFile())  # True

典型应用场景

• 网络请求时构建和解析 URL
• 处理本地文件路径与网络地址的转换
• 管理和校验用户输入的地址信息

更多详细内容可参考官方文档：QUrl — Qt for Python