Starter Guide
Before we get started, one thing you should know is that this documentation does not teach you how to use Go. Instead, we will explore Macaron based on the basic Go knowledge you already have.
To install Macaron:
1
go get gopkg.in/macaron.v1
Copied!
And upgrade Macaron in the future:
1
go get -u gopkg.in/macaron.v1
Copied!
Minimal Example
Create a file called
main.go, and type following code:1
package main
2
3
import "gopkg.in/macaron.v1"
4
5
func main() {
6
m := macaron.Classic()
7
m.Get("/", func() string {
8
return "Hello world!"
9
})
10
m.Run()
11
}
Copied!
You may have questions about why the handler function can return a string as response? The magic is the Return Values, this is a special case/syntax for responding requests by string.
Then, execute command
go run main.go, you should see a log message is printed to the console:1
[Macaron] listening on 0.0.0.0:4000 (development)
Copied!
Extended Example
Let’s modify the
main.go and do some extended exercises.1
package main
2
3
import (
4
"log"
5
"net/http"
6
7
"gopkg.in/macaron.v1"
8
)
9
10
func main() {
11
m := macaron.Classic()
12
m.Get("/", myHandler)
13
14
log.Println("Server is running...")
15
log.Println(http.ListenAndServe("0.0.0.0:4000", m))
16
}
17
18
func myHandler(ctx *macaron.Context) string {
19
return "the request path is: " + ctx.Req.RequestURI
20
}
Copied!
If you execute command
go run main.go again, you’ll see string the request path is: / is on your screen.So what’s different now?
First of all, we still use Classic Macaron and register route for HTTP GET method of root path
/. We don’t use anonymous function anymore, but a named function called myHandler. Notice that there is no parentheses after function name when we register route because we do not call it at that point.The function
myHandler accepts one argument with type *macaron.Context and returns a string. You may notice that we didn’t tell Macaron what arguments should pass to myHandler when we register routes, and if you look at the m.Get method, you will see Macaron sees all handlers(macaron.Handler) as type interface{}. So how does Macaron know?This is related to the concept of Service Injection,
*macaron.Context is one of the default injected services, so you can use it directly. Don’t worry about how to inject your own services, it’s just not the time to tell you yet.Like the previous example, we need to make server listen on a address. This time, we use function from Go standard library called
http.ListenAndServe, which shows any Macaron Instance is fully compatible with Go standard library.Go Further
You now know about how to write simple code based on Macaron, please try to modify two examples above and make sure you fully understand the words you read.
When you feel comfortable, get up and keep reading on following chapters.
Last modified 2yr ago
Copy link