faqs.md

FAQs

How do I integrate with existing servers?

Every Macaron instance implements http.Handler, so it can easily be used to serve subtrees on existing Go servers. For example this is a working Macaron app for Google App Engine:

package hello

import (
	"net/http"
	
	"gopkg.in/macaron.v1"
)

func init() {
	m := macaron.Classic()
	m.Get("/", func() string {
		return "Hello world!"
	})
	http.Handle("/", m)
}

How do I change the port/host?

Macaron's Run function looks for the PORT and HOST environment variables and uses those. Otherwise Macaron will default to localhost:4000. To have more flexibility over port and host, use the http.ListenAndServe function instead.

m := macaron.Classic()
// ...
log.Fatal(http.ListenAndServe(":8080", m))

Or following ways:

• m.Run("0.0.0.0"), listen on 0.0.0.0:4000
• m.Run(8080), listen on 0.0.0.0:8080
• m.Run("0.0.0.0", 8080), listen on 0.0.0.0:8080

How do I graceful shutdown?

package main

import (
	...
	"net/http"

	"gopkg.in/macaron.v1"
    "gopkg.in/tylerb/graceful.v1"
)

func main() {
	m := macaron.Classic()

	...

	mux := http.NewServeMux()
    mux.Handle("/", m)
    graceful.Run(":4000", 60*time.Second, mux)
}

How do I pass data in request-level other than service inject?

There is a field called Data with type map[string]interface{} in *macaron.Context where you can store and retrieve any type of data. It comes with *macaron.Context so every request is independent.

See example here.

What's the idea behind this other than Martini?

• Integrate frequently used middlewares and helper methods with less reflection.
• Replace default router with faster multi-tree router.
• Make it much easier to power Gogs project.
• Make a deep source study against Martini.

Why Logo is a dragon?

Shouldn't it be some sort of dessert?

The transliteration of Macaron in Chinese is Maca Long, Long means dragon, so actually the Logo is a dragon whose name is Maca. Hah!

Live code reload?

Bra is the prefect fit for live reloading Macaron and other apps.