No content

◦

◦ ◦ ◦ ◦ ◦ ◦

func h(w http.ResponseWriter, r *http.Request) { } Boilerplate code (logging, auth, parameters) Boilerplate code (response writing, etc) Main handler code

func h(w http.ResponseWriter, r *http.Request) { f(w, r) { } g(w, r) { } } Boilerplate code (logging, auth, parameters) Boilerplate code (response writing, etc) Main handler code

func f(w http.ResponseWriter, r *http.Request) { } func h(w http.ResponseWriter, r *http.Request) { } func g(w http.ResponseWriter, r *http.Request) { } Boilerplate code (logging, auth, parameters) Boilerplate code (response writing, etc) Main handler code

func(c siesta.Context, w http.ResponseWriter, r *http.Request) { // set interface{}s c.Set("foo", bar); // get interface{}s c.Get("foo") // => interface{}(bar) } ◦ ◦

gorilla/context ◦ ◦ ◦ func MyHandler(w http.ResponseWriter, r *http.Request) { // ... requestID := context.Get(r, "request-id") // ... }

No content

No content

No content

func (s *Service) ServeHTTPInContext(c Context, w http.ResponseWriter, r *http.Request) { // ... quit := false for _, m := range s.pre { // s.pre is a slice of handlers m(c, w, r, func() { quit = true }) if quit { break } } // ... }

flags ◦ GET /resources/:resourceID/things?all=true ◦ params.Int("resourceID", …) ◦ params.Bool("all", …)

var params siesta.Params // GET /resources/:resourceID/... resourceID := params.Int("resourceID", -1, "Resource identifier") err := params.Parse(r.Form) if err != nil { // Do something with the err } // Make sure we have a valid resource ID. if *resourceID == -1 { // Handle the invalid resource }

No content

No content

// responseGenerator converts response and/or error data passed through the // context into a structured response. func responseGenerator(c siesta.Context, w http.ResponseWriter, r *http.Request) { response := apiResponse{} if data := c.Get("data"); data != nil { response.Data = data } if err := c.Get("error"); err != nil { response.Error = err.(string) } c.Set("response", response) }

func TestHandler(t *testing.T) { c := siesta.NewSiestaContext() // c.Set(...) myHandler(c, mockResponseWriter, &http.Request{ Form: url.Values(map[string][]string{ "id": []string{"1"}, // maybe a GET /resource/:id }), } // c.Get(...) }

database/sql ◦ ◦ ◦ ◦

◦

sql.DB sql.Tx sql. DB sql.Tx ◦ database/sql sql.DB sql.Tx

sql.DB type SQLDB interface { Query(query string, args ...interface{}) (SQLRows, error) QueryRow(query string, args ...interface{}) SQLRow Exec(query string, args ...interface{}) (sql.Result, error) Begin() error Rollback() error Commit() error } type SQLRows interface { SQLRow Close() error Err() error Next() bool } type SQLRow interface { Scan(dest ...interface{}) error }

type DB struct { sqlDB *sql.DB tx *sql.Tx context siesta.Context } func (db *DB) Query(query string, args ...interface{}) (Rows, error) { // db.context is accessible! if db.tx != nil { return db.tx.Query(query, args...) } return db.sqlDB.Query(query, args...) } // ...

No content

$ curl localhost:8080/resources/1 -u abcde: { "data": "foo" } $ curl localhost:8080/resources/1?usage -u abcde: { "data": { "resourceID": [ "resourceID", "int", "Resource identifier" ], "usage": [ "usage", "bool", "Show usage" ] } } Name Type Description

// Check parameters var params siesta.Params resourceID := params.Int("resourceID", -1, "Resource identifier") params.Bool("usage", false, "Show usage") if r.URL.Query()["usage"] != nil { c.Set("data", params.Usage()) return } err := params.Parse(r.Form) // ...

/resources/:resourceID?summary=true { "method": "GET", "url": [ { "name": "resources", "type": "fixed" }, { "name": "resourceID", "type": "parameter" "parameterType": "int", "description": "Resource ID" } ], "queryString": [ { "name": "summary", "parameterType": "bool", "description": "Show only feature summary" } ], "endpoint": "/resources/:resourceID" }