How do you use the " net / http " package to build an HTTP server in Go?

In Go, building an HTTP server using the net/http package is intuitive and powerful. The net/http package provides implementations for both HTTP clients and servers. I will walk you through the steps to build a simple HTTP server using this package:

1. Importing the Package

First, you need to import the net/http package and any other required packages.

go
import (
    "fmt"
    "net/http"
)

2. Writing Handler Functions

The core of an HTTP server's operation is the handler function, which responds to HTTP requests. In Go, such functions must conform to the http.HandlerFunc type. Typically, a handler function takes two parameters: http.ResponseWriter and *http.Request.

go
func helloWorldHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Hello, world!")
}

In this example, the helloWorldHandler function simply sends the 'Hello, world!' string to the client.

3. Setting Up Routes

Use the http.HandleFunc function to bind a URL path to a handler function. When an HTTP request matches the specified path, the corresponding handler function is invoked.

go
func main() {
    http.HandleFunc("/", helloWorldHandler)
}

In this code, all requests to the root path "/" are handled by the helloWorldHandler function.

4. Starting the Server

The final step is to call http.ListenAndServe, which sets the server to listen on a specified port and begins processing requests. This function blocks, and the server continues running until externally interrupted.

go
func main() {
    http.HandleFunc("/", helloWorldHandler)
    fmt.Println("Server is running on http://localhost:8080")
    if err := http.ListenAndServe(:8080, nil); err != nil {
        log.Fatal(err)
    }
}

Here, we set the server to listen on port 8080 of the local machine.

Complete Example Code

Combining the above parts, the complete server code is as follows:

go
package main

import (
    "fmt"
    "log"
    "net/http"
)

func helloWorldHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Hello, world!")
}

func main() {
    http.HandleFunc("/", helloWorldHandler)
    fmt.Println("Server is running on http://localhost:8080")
    if err := http.ListenAndServe(:8080, nil); err != nil {
        log.Fatal(err)
    }
}

This code builds a simple HTTP server listening on port 8080, where all requests to the root path receive the 'Hello, world!' response.

Conclusion

Through the net/http package, Go provides a simple and efficient way to build HTTP servers. Extending and maintaining the server is straightforward, as you can add more handler functions and routes to enhance its functionality.