【Qt Libraries】QUrl 的基本使用方法

参考博客：

• https://www.cnblogs.com/liushui-sky/p/10892097.html
• https://www.cnblogs.com/ShineLeBlog/p/14951512.html

简述： QUrl类提供了一个方便的接口使用Urls，它可以构造解析编码和未编码形式的URls。QUrl也支持国际化域名（IDNs）。

1、Create Object

QUrl url("https://www.baidu.com/");
// 或
QUrl url;
url.setUrl("https://www.baidu.com/");

URls形式有两种：编码或未编码。未编码形式适用于显示给用户，编码形式通常会发送到一个web服务器。

2、Base Usage

void setScheme(const QString &scheme);
QString scheme() const;
void setAuthority(const QString &authority, ParsingMode mode = TolerantMode);
QString authority(ComponentFormattingOptions options = PrettyDecoded) const;
void setUserInfo(const QString &userInfo, ParsingMode mode = TolerantMode);
QString userInfo(ComponentFormattingOptions options = PrettyDecoded) const;
void setUserName(const QString &userName, ParsingMode mode = DecodedMode);
QString userName(ComponentFormattingOptions options = FullyDecoded) const;
void setPassword(const QString &password, ParsingMode mode = DecodedMode);
QString password(ComponentFormattingOptions = FullyDecoded) const;
void setHost(const QString &host, ParsingMode mode = DecodedMode);
QString host(ComponentFormattingOptions = FullyDecoded) const;
QString topLevelDomain(ComponentFormattingOptions options = FullyDecoded) const;
void setPort(int port);
int port(int defaultPort = -1) const;
void setPath(const QString &path, ParsingMode mode = DecodedMode);
QString path(ComponentFormattingOptions options = FullyDecoded) const;
QString fileName(ComponentFormattingOptions options = FullyDecoded) const;
bool hasQuery() const;
void setQuery(const QString &query, ParsingMode mode = TolerantMode);
void setQuery(const QUrlQuery &query);
QString query(ComponentFormattingOptions = PrettyDecoded) const;
bool hasFragment() const;
QString fragment(ComponentFormattingOptions options = PrettyDecoded) const;
void setFragment(const QString &fragment, ParsingMode mode = TolerantMode);

3、URL Format

3.1、Scheme

scheme指定使用的传输协议，它由 URL 起始部分的一个或多个 ASCII 字符表示。scheme 只能包含 ASCII 字符，对输入不做转换或解码，必须以 ASCII 字母开始。

// scheme 严格兼容 RFC 3986：
scheme = ALPHA *( ALPHA / DIGIT / “+” / “-” / “.”）

QUrl url;
url.setScheme("ftp");

传输协议类型如下表：

协议	描述
file	资源是本地计算机上的文件。格式：file:///，注意后边应是三个斜杠
ftp	通过 FTP 访问资源。格式：FTP://
gopher	通过 Gopher 协议访问该资源
http	通过 HTTP 访问该资源。格式：HTTP://
https	通过安全的 HTTPS 访问该资源。格式：HTTPS://
mailto	资源为电子邮件地址，通过 SMTP 访问。格式：mailto:
MMS	通过支持MMS（流媒体）协议的播放该资源（代表软件：Windows Media Player）。格式：MMS://
ed2k	通过支持ed2k（专用下载链接）协议的P2P软件访问该资源（代表软件：电驴）。格式：ed2k://
Flashget	通过支持Flashget:（专用下载链接）协议的P2P软件访问该资源（代表软件：快车）。格式： Flashget://
thunder	通过支持thunder（专用下载链接）协议的 P2P 软件访问该资源（代表软件：迅雷）。格式： thunder://
news	通过 NNTP 访问该资源

3.2、Authority

URL 的 authority 由用户信息，主机名和端口组成。所有这些元素都是可选的，即使 authority 为空，也是有效的。

格式：username：password@hostname:port

用户信息和主机名由 " @ " 分割，主机和端口由 ":" 分割。如果用户信息为空，则 " @ " 必须被省略。如果端口为空，允许使用 " :"

host：指存放资源的服务器的域名系统（DNS）主机名或 IP地址。port：整数，可选，省略时使用方案的默认端口，各种传输协议都有默认的端口号，如HTTP的默认端口80。如果输入时省略，则使用默认端口号。

3.3、user info

user info 指用户信息，是URL中 authority 可选的一部分。用户信息包括用户名和一个可选密码，由 " : " 分割 。如果密码为空， ": " 须被省略。

3.4、path

由零个或多个 / 隔开的字符串，一般用来表示主机上的一个目录或文件地址。 在 authority 之后，query之前。

对于没有层级的 schemes , 路径将是 scheme 后的所有部分，如下：

3.5、query

query 指查询字符串，可选，用于给动态网页（例如：使用 CGI、ISAPI、PHP/JSP/ASP/ASP、.NET 等技术制作的网页）传递参数，可有数个参数，用 & 隔开，每个参数的名和值用 =隔开。

3.6、fragment

fragment 指定网络资源中的片段。是URL的最后一部分，由 *#*后面的跟的字符串表示。通常指的是用于HTTp页面上的某个链接或点

4、Other Application

bool isValid()const;//如果返回false，应该在继续之前clear()URL，或通过setUrl()传递一个新的URL
QTcpSocket sock;
sock.connectToHost(url.host(),url.port(80));//通过socket连接到一个指定QUrl包含的主机、端口
QUrl url1=QUrl::fromLocalFile("E:\\Qt.txt");//使用fromLocalFile()构造一个QUrl，通过传递一个本地文件路径
//toLocalFile()将一个URL转换为本地文件路径。
QUrl url2("http://qt-project.org/support/file.html");
url2.fileName();//返回文件的名称。若url以斜杠结束，文件的名称是空的。若路径不包含任何斜线，完全返回作为文件名
[static] QUrl fromUserInput(const QString &userInput);//返回从一个用户提供的用户输入的字符串的一个有效的URL
QUrl resolved(const QUrl &relative)const Q_REQUIRED_RESULT;//相对的URL可被转变通过将它作为参数传递给resolved()，会返回一个绝对URL
//如果relative不是一个相对URL，该函数会直接返回relative。
bool isRelative()const;//判断url是否相对
bool isParentOf(const QUrl &url)const;//判断一个URL是否是另一个的parent

//处理编码和解码的百分比
static QString fromPercentEncoding(const QByteArray&);
static QByteArray toPercentEncoding(const QString&,
                                    const QByteArray &exclude=QByteArray(),
                                    const QByteArray &include=QByteArray());