api.go 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101
  1. package api
  2. import (
  3. "context"
  4. "git.sxidc.com/go-tools/utils/strutils"
  5. "git.sxidc.com/service-supports/fserr"
  6. "github.com/gin-gonic/gin"
  7. "net/http"
  8. )
  9. type Api struct {
  10. options Options
  11. server *http.Server
  12. rootRouter *RootRouter
  13. prefixRouter *PrefixRouter
  14. }
  15. func New(opts ...Option) *Api {
  16. options := new(Options)
  17. for _, opt := range opts {
  18. opt(options)
  19. }
  20. if strutils.IsStringEmpty(options.port) {
  21. options.port = "8080"
  22. }
  23. engine := gin.New()
  24. server := &http.Server{
  25. Addr: ":" + options.port,
  26. Handler: engine,
  27. }
  28. api := &Api{
  29. options: *options,
  30. server: server,
  31. rootRouter: newRootRouter(engine),
  32. }
  33. if strutils.IsStringNotEmpty(options.urlPrefix) {
  34. api.prefixRouter = newPrefixRouter(engine.Group(options.urlPrefix))
  35. }
  36. return api
  37. }
  38. func (api *Api) Start() error {
  39. err := api.server.ListenAndServe()
  40. if err != nil && !fserr.Is(err, http.ErrServerClosed) {
  41. return err
  42. }
  43. return nil
  44. }
  45. func (api *Api) Finish() error {
  46. return api.server.Shutdown(context.Background())
  47. }
  48. func (api *Api) Options() Options {
  49. return api.options
  50. }
  51. func (api *Api) RootRouter() Router {
  52. return api.rootRouter
  53. }
  54. func (api *Api) PrefixRouter() Router {
  55. if api.prefixRouter == nil {
  56. return api.rootRouter
  57. }
  58. return api.prefixRouter
  59. }
  60. const (
  61. RouterRoot = "root"
  62. RouterPrefix = "prefix"
  63. )
  64. func (api *Api) ChooseRouter(routerType string, version string) Router {
  65. var router Router
  66. switch routerType {
  67. case RouterRoot:
  68. router = api.RootRouter()
  69. case RouterPrefix:
  70. router = api.PrefixRouter()
  71. default:
  72. router = api.PrefixRouter()
  73. }
  74. if strutils.IsStringNotEmpty(version) {
  75. router = router.VersionedRouter(version)
  76. }
  77. return router
  78. }