Master Go’s net/url: Parse, Build, and Manipulate URLs with Ease

Go’s net/url package in the standard library offers powerful and flexible tools for handling URLs, covering parsing, building, query string manipulation, and escaping.

Parsing URLs

Use url.Parse to convert a URL string into a url.URL struct, then access components such as Scheme, Host, Path, and RawQuery.

u, err := url.Parse("https://example.com/path?query=123")
if err != nil {
    log.Fatal(err)
}
fmt.Println("Scheme:", u.Scheme)
fmt.Println("Host:", u.Host)
fmt.Println("Path:", u.Path)
fmt.Println("Query string:", u.RawQuery)

Building URLs

Populate a url.URL struct and call its String method to generate a properly encoded URL.

u := &url.URL{
    Scheme:   "https",
    Host:     "example.com",
    Path:     "search",
    RawQuery: "query=go",
}
fmt.Println(u.String()) // https://example.com/search?query=go

Query String Handling

The url.Values type (a map[string][]string alias) simplifies building and parsing query strings.

values := url.Values{}
values.Add("name", "John")
values.Add("age", "30")
queryString := values.Encode() // age=30&name=John
fmt.Println(queryString)

values, _ = url.ParseQuery(queryString)
fmt.Println(values.Get("name")) // John

Escaping and Unescaping

Use url.QueryEscape and url.QueryUnescape to safely encode or decode special characters in query components.

escaped := url.QueryEscape("name=John Doe&age=30")
fmt.Println(escaped) // name%3DJohn+Doe%26age%3D30

unescaped, _ := url.QueryUnescape(escaped)
fmt.Println(unescaped) // name=John Doe&age=30

Conclusion

The net/url package is a versatile tool for Go developers, providing concise solutions for parsing, constructing, and manipulating URLs, as well as handling query strings and character escaping, thereby streamlining network programming tasks.