Add Engine.RunCustom method

By this API the user can pass any net.Listener object to Engine.

It can be used by user's test code which run a Engine and bind to
a free port, then pass the real addres to the test function.

And I think if we added this API then the Engine.RunUnix is
unnecessary.
This commit is contained in:
snyh 2015-09-06 15:23:02 +08:00
parent 02df324cc6
commit e666eceaee

13
gin.go
View File

@ -225,6 +225,19 @@ func iterate(path, method string, routes RoutesInfo, root *node) RoutesInfo {
return routes
}
// RunCustom, run server by a net.Listener
// the main usage is to test, by a custom net.Listener we can let os to choose a free
// port and get it.
//
// r := gin.Default()
// l, err := net.Listen(":0")
// l.Addr()
// r.RunCustom(l)
func (engine *Engine) RunCustom(l net.Listener) error {
debugPrint("Listening and serving HTTP on %s\n", l.Addr())
return http.Serve(l, engine)
}
// Run attaches the router to a http.Server and starts listening and serving HTTP requests.
// It is a shortcut for http.ListenAndServe(addr, router)
// Note: this method will block the calling goroutine undefinitelly unless an error happens.