lib/webserver/server.go

   1 package webserver
   2
   3 import (
   4         "fmt"
   5         "log"
   6         "net/http"
   7         "os"
   8
   9         "path"
  10
  11         "github.com/Sirupsen/logrus"
  12         "github.com/gin-contrib/static"
  13         "github.com/gin-gonic/gin"
  14         "github.com/googollee/go-socket.io"
  15         "github.com/iotbzh/xds-server/lib/apiv1"
  16         "github.com/iotbzh/xds-server/lib/crosssdk"
  17         "github.com/iotbzh/xds-server/lib/model"
  18         "github.com/iotbzh/xds-server/lib/session"
  19         "github.com/iotbzh/xds-server/lib/xdsconfig"
  20 )
  21
  22 // Server .
  23 type Server struct {
  24         router    *gin.Engine
  25         api       *apiv1.APIService
  26         sIOServer *socketio.Server
  27         webApp    *gin.RouterGroup
  28         cfg       *xdsconfig.Config
  29         sessions  *session.Sessions
  30         mfolders  *model.Folders
  31         sdks      *crosssdk.SDKs
  32         log       *logrus.Logger
  33         stop      chan struct{} // signals intentional stop
  34 }
  35
  36 const indexFilename = "index.html"
  37 const cookieMaxAge = "3600"
  38
  39 // New creates an instance of Server
  40 func New(cfg *xdsconfig.Config, mfolders *model.Folders, sdks *crosssdk.SDKs, logr *logrus.Logger) *Server {
  41
  42         // Setup logging for gin router
  43         if logr.Level == logrus.DebugLevel {
  44                 gin.SetMode(gin.DebugMode)
  45         } else {
  46                 gin.SetMode(gin.ReleaseMode)
  47         }
  48
  49         // Redirect gin logs into logrus logger
  50         gin.DefaultWriter = logr.Out
  51         gin.DefaultErrorWriter = logr.Out
  52         log.SetOutput(logr.Out)
  53
  54         // FIXME - fix pb about isTerminal=false when out is in VSC Debug Console
  55
  56         // Creates gin router
  57         r := gin.New()
  58
  59         svr := &Server{
  60                 router:    r,
  61                 api:       nil,
  62                 sIOServer: nil,
  63                 webApp:    nil,
  64                 cfg:       cfg,
  65                 sessions:  nil,
  66                 mfolders:  mfolders,
  67                 sdks:      sdks,
  68                 log:       logr,
  69                 stop:      make(chan struct{}),
  70         }
  71
  72         return svr
  73 }
  74
  75 // Serve starts a new instance of the Web Server
  76 func (s *Server) Serve() error {
  77         var err error
  78
  79         // Setup middlewares
  80         s.router.Use(gin.Logger())
  81         s.router.Use(gin.Recovery())
  82         s.router.Use(s.middlewareXDSDetails())
  83         s.router.Use(s.middlewareCORS())
  84
  85         // Sessions manager
  86         s.sessions = session.NewClientSessions(s.router, s.log, cookieMaxAge)
  87
  88         // Create REST API
  89         s.api = apiv1.New(s.router, s.sessions, s.cfg, s.mfolders, s.sdks)
  90
  91         // Websocket routes
  92         s.sIOServer, err = socketio.NewServer(nil)
  93         if err != nil {
  94                 s.log.Fatalln(err)
  95         }
  96
  97         s.router.GET("/socket.io/", s.socketHandler)
  98         s.router.POST("/socket.io/", s.socketHandler)
  99         /* TODO: do we want to support ws://...  ?
 100         s.router.Handle("WS", "/socket.io/", s.socketHandler)
 101         s.router.Handle("WSS", "/socket.io/", s.socketHandler)
 102         */
 103
 104         // Web Application (serve on / )
 105         idxFile := path.Join(s.cfg.FileConf.WebAppDir, indexFilename)
 106         if _, err := os.Stat(idxFile); err != nil {
 107                 s.log.Fatalln("Web app directory not found, check/use webAppDir setting in config file: ", idxFile)
 108         }
 109         s.log.Infof("Serve WEB app dir: %s", s.cfg.FileConf.WebAppDir)
 110         s.router.Use(static.Serve("/", static.LocalFile(s.cfg.FileConf.WebAppDir, true)))
 111         s.webApp = s.router.Group("/", s.serveIndexFile)
 112         {
 113                 s.webApp.GET("/")
 114         }
 115
 116         // Serve in the background
 117         serveError := make(chan error, 1)
 118         go func() {
 119                 fmt.Printf("Web Server running on localhost:%s ...\n", s.cfg.FileConf.HTTPPort)
 120                 serveError <- http.ListenAndServe(":"+s.cfg.FileConf.HTTPPort, s.router)
 121         }()
 122
 123         // Wait for stop, restart or error signals
 124         select {
 125         case <-s.stop:
 126                 // Shutting down permanently
 127                 s.sessions.Stop()
 128                 s.log.Infoln("shutting down (stop)")
 129         case err = <-serveError:
 130                 // Error due to listen/serve failure
 131                 s.log.Errorln(err)
 132         }
 133
 134         return nil
 135 }
 136
 137 // Stop web server
 138 func (s *Server) Stop() {
 139         close(s.stop)
 140 }
 141
 142 // serveIndexFile provides initial file (eg. index.html) of webapp
 143 func (s *Server) serveIndexFile(c *gin.Context) {
 144         c.HTML(200, indexFilename, gin.H{})
 145 }
 146
 147 // Add details in Header
 148 func (s *Server) middlewareXDSDetails() gin.HandlerFunc {
 149         return func(c *gin.Context) {
 150                 c.Header("XDS-Version", s.cfg.Version)
 151                 c.Header("XDS-API-Version", s.cfg.APIVersion)
 152                 c.Next()
 153         }
 154 }
 155
 156 // CORS middleware
 157 func (s *Server) middlewareCORS() gin.HandlerFunc {
 158         return func(c *gin.Context) {
 159                 if c.Request.Method == "OPTIONS" {
 160                         c.Header("Access-Control-Allow-Origin", "*")
 161                         c.Header("Access-Control-Allow-Headers", "Content-Type")
 162                         c.Header("Access-Control-Allow-Methods", "GET, POST, DELETE")
 163                         c.Header("Access-Control-Max-Age", cookieMaxAge)
 164                         c.AbortWithStatus(204)
 165                         return
 166                 }
 167
 168                 c.Next()
 169         }
 170 }
 171
 172 // socketHandler is the handler for the "main" websocket connection
 173 func (s *Server) socketHandler(c *gin.Context) {
 174
 175         // Retrieve user session
 176         sess := s.sessions.Get(c)
 177         if sess == nil {
 178                 c.JSON(500, gin.H{"error": "Cannot retrieve session"})
 179                 return
 180         }
 181
 182         s.sIOServer.On("connection", func(so socketio.Socket) {
 183                 s.log.Debugf("WS Connected (SID=%v)", so.Id())
 184                 s.sessions.UpdateIOSocket(sess.ID, &so)
 185
 186                 so.On("disconnection", func() {
 187                         s.log.Debugf("WS disconnected (SID=%v)", so.Id())
 188                         s.sessions.UpdateIOSocket(sess.ID, nil)
 189                 })
 190         })
 191
 192         s.sIOServer.On("error", func(so socketio.Socket, err error) {
 193                 s.log.Errorf("WS SID=%v Error : %v", so.Id(), err.Error())
 194         })
 195
 196         s.sIOServer.ServeHTTP(c.Writer, c.Request)
 197 }