使用 Go 的 net/url 包處理 URL
URL（統一資源定位符）是互聯網最重要的基礎設施之一。在構建 Web 應用程序時，您需要操作 URL 來定位和檢索資源。
當您構建更複雜的 Web 應用程序時，您需要在更細粒度的級別上使用 URL。您可能需要確定方案、主機名、路徑和查詢參數。您還需要了解如何對 URL 進行編碼和解碼，以便處理特殊字符並確保您的 Web 應用程序安全。
Go 的標準庫提供了 net/url 包來處理 URL 和 URL 組件。
網址包
url包提供了用於處理 URL 及其獨立部分的綜合功能和特性。它提供了解析、構造、編碼和解碼 URL 的功能，使該包對 Web 開發非常有用。
url包的一些關鍵特性是能夠將 URL 解析為單獨的組件，以便為 HTTP 請求進行操作和 URL 構建。url包還提供了一個URL結構和一個用於將字符串解析為 URL 的Parse方法。
這是url.URL結構模型：
package main
type URL struct {
// Scheme is the protocol scheme of the URL,
// such as "http"or "https"
Scheme string
// Opaque is used to hold any opaque data
// that should be encoded in the URL
Opaque string
// User holds information about the user making the request,
// such as a username and password
User *Userinfo
// Host is the hostname or IP address
// of the server hosting the URL
Host string
// Path is the path of the URL on the server
Path string
// RawPath is the original,
// encoded path of the URL
RawPath string
// ForceQuery indicates whether the URL should include a query string
// even if it is empty
ForceQuery bool
// RawQuery is the original,
//encoded query string of the URL
RawQuery string
// Fragment is the fragment identifier of the URL,
// used for linking to a specific element on a page
Fragment string
// RawFragment is the original,
// encoded fragment identifier of the URL
RawFragment string
}
了解如何訪問URL結構的各個部分對於驗證等任務很有用。
使用 Parse 函數解析 URL
url包的Parse函數提供了將 URL 字符串解析為獨立組件的功能。Parse函數將單個 URL 作為參數並返回指向url.URL結構的指針，該結構包含 URL 的已解析數據和錯誤類型。
下面介紹如何使用Parse函數檢索 URL 的元素。
import (
"fmt"
"net/url"
)
func main() {
// The URL you want to parse
exampleURL: = "https://www.example.com/path?param1=value1¶m2=value2"
// Parse the URL
parsedURL, err: = url.Parse(exampleURL)
if err! = nil {
fmt.Println(err)
return
}
// Print all the fields of the URL
fmt.Println("Scheme:", parsedURL.Scheme)
fmt.Println("Opaque:", parsedURL.Opaque)
fmt.Println("User:", parsedURL.User)
fmt.Println("Host:", parsedURL.Host)
fmt.Println("Path:", parsedURL.Path)
fmt.Println("RawPath:", parsedURL.RawPath)
fmt.Println("ForceQuery:", parsedURL.ForceQuery)
fmt.Println("RawQuery:", parsedURL.RawQuery)
fmt.Println("Fragment:", parsedURL.Fragment)
fmt.Println("RawFragment:", parsedURL.RawFragment)
}
exampleURL變量保存完整的、未解析的 URL，Parse函數解析 exampleURL 變量的內容並返回解析後的 URL。該程序以對Println的一系列調用結束，以演示URL結構的各個字段。
parse 函數不檢查 URL 是否是實際存在的真實 URL，它僅從語法上解析 URL。您可以使用http包向 URL 發出 GET 請求並檢查響應：
import (
"fmt"
"net/http"
)
func main() {
// The URL you want to check
exampleURL: = "https://www.example.com"
// Make an HTTP GET request to the URL
response, err: = http.Get(exampleURL)
if err! = nil {
fmt.Println(err)
return
}
defer response.Body.Close()
// Check the response status code
if response.StatusCode == http.StatusOK {
fmt.Println("URL exists.")
} else {
fmt.Println("URL does not exist.")
}
}
main函數使用http包的Get函數向exampleURL發出GET請求。該函數返迴響應實例和錯誤類型。該程序以if語句結束，通過檢查 HTTP 狀態代碼與http包中的StatusOk常量來驗證網站的存在。
這種方法允許您根據檢查結果採取行動，例如將用戶重定向到不同的頁面、顯示錯誤消息或在一定時間後重試請求。
編碼和解碼 URL 參數
url包提供了Encode方法來對 URL 參數進行編碼。Encode函數對URL 參數中的特殊字符和空格進行百分號編碼。
import (
"fmt"
"net/url"
)
func main() {
// create a new url.Values struct
params: = url.Values{}
// add values to the struct
params.Add("name", "John Smith")
params.Add("age", "30")
params.Add("gender", "male")
// encode the struct into a string
encodedParams: = params.Encode()
fmt.Println(encodedParams)
// Output: "age=30&gender=male&name=John+Smith"
}
main函數新建一個url包的Values結構體實例，struct實例的Add方法向struct實例中添加鍵值對數據。
Encode方法將鍵值對轉換為 URL 字符串格式“key1=value1&key2=value2&key3=value3”。
您可以使用url包的ParseQuery函數解碼編碼的 URL 字符串。
import (
"fmt"
"net/url"
)
func main() {
// encoded string of URL parameters
encodedParams: = "age=30&gender=male&name=John+Smith"
// parse the encoded string into a url.Values struct
params, err: = url.ParseQuery(encodedParams)
if err! = nil {
fmt.Println(err)
}
// print the struct
fmt.Println(params)
// Output: map[age:[30] gender:[male] name:[John Smith]]
}
encodedParameter變量是編碼的 URL 字符串。ParseQuery函數接收encodedParameter變量並返回解碼後的 URL 字符串和一個錯誤。
這些 Go 包可以讓你的網絡路由遊戲更上一層樓
您用於 Web 應用程序頁面的 URL 有助於其在搜索引擎上的性能和可見性。Web 路由是根據 URL 將傳入請求定向到適當的處理函數的過程。
您可以使用 http 包或流行的第三方包（如 Gorilla Mux、Chi、Pat 或 Httprouter）進行路由。這些包通過抽像出它的一些複雜性使路由比 http 包更容易。
發佈留言