Swift 构建和解析URL的URLComponents

在 Swift 中，URLComponents 是一个结构体，专门用于构建和解析 URL。它提供了一种结构化的方式，可以轻松创建和处理 URL 的各个部分（如协议、主机、路径、查询参数等），从而避免直接手动拼接 URL 字符串的麻烦。

URLComponents 的作用

构建 URL：通过设置协议、主机、路径、查询参数等属性，可以方便地构造符合标准的 URL。

解析 URL：将 URL 字符串分解成各个部分，比如协议、主机、端口、路径、查询参数等，便于获取和修改这些信息。

URLComponents 的常用属性

scheme：URL 的协议部分（如 http、https、ftp 等）。

host：主机（通常是域名或 IP 地址）。

path：资源路径，用于指定主机中的资源位置。

queryItems：一个 URLQueryItem 数组，表示查询参数。每个 URLQueryItem 包含一个键值对（name 和 value），用于构造 URL 的查询字符串。

port：端口号，整数类型，可选。若未设置，会使用协议的默认端口号。

构建 URL

通过设置 URLComponents 的各个属性，最终生成了一个完整的 URL：

import Foundation
var components = URLComponents()
components.scheme = "https"                   // 设置协议
components.host = "www.example.com"            // 设置主机
components.path = "/search"                    // 设置路径
components.queryItems = [
    URLQueryItem(name: "q", value: "Swift URL"),   // 添加查询参数
    URLQueryItem(name: "lang", value: "en")
]

if let url = components.url {  // 将 URLComponents 转化为 URL
    print("URL: \(url)")       // 输出完整的 URL
} else {
    print("URL 创建失败")
}

上述代码会生成并输出一个完整的 URL：

URL: https://www.example.com/search?q=Swift%20URL&lang=en

解析 URL

URLComponents 也可以解析现有的 URL，并提取其各个部分：

if let components = URLComponents(string: "https://www.example.com/search?q=Swift%20URL&lang=en") {
    print("Scheme: \(components.scheme ?? "")")         // 输出: https
    print("Host: \(components.host ?? "")")             // 输出: www.example.com
    print("Path: \(components.path)")                   // 输出: /search
    if let queryItems = components.queryItems {
        for item in queryItems {
            print("Query Item: \(item.name) = \(item.value ?? "")")
        }
    }
}

URLComponents 提供了一个便捷的方式来构建和解析 URL，使得代码更简洁、可读性更高，同时也避免了 URL 字符串拼接中的错误和繁琐的编码处理。