@lund-org/cherry/src/server/CherryServer.js

A light framework to quickly create a web server

const CherryServerConfigurator = require('./CherryServerConfigurator')

class CherryServer {
  constructor (cherry) {
    this.server = null
    this.options = {}
    this.cherry = cherry
  }

  /**
   * Setup the configuration to the server
   * @param {Object} options The options provided to configure the server
   */
  setOptions (options) {
    const serverConfigurator = new CherryServerConfigurator()
    this.options = serverConfigurator.buildConfiguration(options)
  }

  /**
   * Attach additionnal datas to the request
   * @param {CherryIncomingMessage} req The current request
   */
  boundOptionsToRequest (req) {
    req.setCherry(this.cherry)
  }

  /**
   * Attach Access Control options (and other things) to the response object
   * @param {CherryServerResponse} res The response object
   */
  boundOptionsToResponse (res) {
    res.boundOptions(this.options.securityOptions)
    res.setCherry(this.cherry)
  }

  /**
   * The handler when a request comes to the server
   * @param {CherryIncomingMessage} request The current request
   * @param {CherryServerResponse} response The response object
   */
  bootstrap (request, response) {
    let shouldContinue = true

    this.boundOptionsToRequest(request)
    this.boundOptionsToResponse(response)
    if (this.options.optionCallback === null) {
      shouldContinue = !this.defaultOptionsManagement(request, response)
    } else if (typeof this.options.optionCallback === 'function') {
      shouldContinue = !(this.options.optionCallback.bind(this)(request, response))
    }

    if (shouldContinue) {
      try {
        this.cherry.dispatcher.dispatch(request, response)
      } catch (error) {
        console.log(error)
        this.cherry.defaultErrorPageConfigurator.manager.serverErrorPage(request, response, error)
      }
    }
  }

  /**
   * Start the server to listen on a specific port
   */
  start () {
    console.log(`Start server on the port : ${this.options.port}`)
    this.server.listen(this.options.port)
  }

  /**
   * Stop the server to listen on a specific port
   */
  async stop (callback) {
    return new Promise((resolve, reject) => {
      console.log(`Stop server on the port : ${this.options.port}`)
      this.server.close(() => {
        callback().then((data) => {
          resolve(data)
        }).catch((err) => {
          reject(err)
        })
      })
    })
  }

  /* ---- Default behaviours ---- */

  /**
   * The default behavior in case of an option (to not block the ajax calls)
   * @param {CherryIncomingMessage} req The current request
   * @param {CherryServerResponse} res The response object
   */
  defaultOptionsManagement (req, res) {
    if (req.method.toUpperCase() === 'OPTIONS' && this.options.securityOptions['Access-Control-Allow-Methods'].includes('OPTIONS')) {
      res.writeHead(200)
      res.end()
      return true
    }

    return false
  }
}

module.exports = CherryServer