javier
a621ada0bf
This PR contains the work done to replace the use of static _HTML_ files with type-safe HTML rendered server-side via **Elementary** through **Hummingbird**. To provide further details about the work done: * Added the **Elementary** dependencies. * Added the `IndexPage` and `ErrorPage` pages, ported from the old HTML boilerplate; removed the static files. * Added the `RootController` controller serving GET / using the `IndexPage` page, wired into the router. * Reworked the `NotFoundMiddleware` middleare to render `ErrorPage` page directly; non-notFound errors still propagate. * the `FileMiddleware` middleware no longer searches for any static `index.html` file. * Simplified the `StaticFile` enumeration, dropped unused constants and now-unnecessary throws. Reviewed-on: rock-n-code/loud-amsterdam#5 Co-authored-by: Javier Cicchelli <javier@rock-n-code.com> Co-committed-by: Javier Cicchelli <javier@rock-n-code.com>
90 lines
2.6 KiB
Swift
90 lines
2.6 KiB
Swift
import Configuration
|
|
import Hummingbird
|
|
import Logging
|
|
import WebsiteCore
|
|
|
|
/// Builds the website application.
|
|
///
|
|
/// Reads the log level, server name, and static files location from the configuration,
|
|
/// then assembles the router, server configuration, and logger.
|
|
/// - Parameter reader: the configuration reader the values are read from.
|
|
/// - Returns: the configured application, ready to run as a service.
|
|
func application(
|
|
reader: ConfigReader
|
|
) async -> some ApplicationProtocol {
|
|
let logLevel = reader.string(
|
|
forKey: .Log.level,
|
|
as: Logger.Level.self,
|
|
default: .info
|
|
)
|
|
let serverName = reader.string(
|
|
forKey: .HTTP.serverName,
|
|
default: .Server.name
|
|
)
|
|
let staticFilesPath = reader.string(
|
|
forKey: .Path.staticFiles,
|
|
default: .Path.staticResources
|
|
)
|
|
|
|
return Application(
|
|
router: router(
|
|
staticFilesPath: staticFilesPath,
|
|
logLevel: logLevel
|
|
),
|
|
configuration: ApplicationConfiguration(
|
|
reader: reader.scoped(to: "http")
|
|
),
|
|
logger: logger(
|
|
serverName: serverName,
|
|
logLevel: logLevel
|
|
)
|
|
)
|
|
}
|
|
|
|
// MARK: - Helpers
|
|
|
|
// Request context used by application
|
|
private typealias AppRequestContext = BasicRequestContext
|
|
|
|
/// Builds the application's logger.
|
|
/// - Parameters:
|
|
/// - serverName: the label applied to the logger.
|
|
/// - logLevel: the minimum level the logger emits.
|
|
/// - Returns: the configured logger.
|
|
private func logger(
|
|
serverName: String,
|
|
logLevel: Logger.Level
|
|
) -> Logger {
|
|
var logger = Logger(label: serverName)
|
|
|
|
logger.logLevel = logLevel
|
|
|
|
return logger
|
|
}
|
|
|
|
/// Builds the application's router.
|
|
///
|
|
/// Registers the request-logging middleware, the not-found middleware that serves the error
|
|
/// page, and the static file middleware that serves the contents of `staticFilesPath`, then
|
|
/// adds the `RootController` routes that render the landing page.
|
|
/// - Parameters:
|
|
/// - staticFilesPath: the folder, relative to the working directory, the static files are served from.
|
|
/// - logLevel: the level the request-logging middleware logs at.
|
|
/// - Returns: the configured router.
|
|
private func router(
|
|
staticFilesPath: String,
|
|
logLevel: Logger.Level
|
|
) -> Router<AppRequestContext> {
|
|
let router = Router(context: AppRequestContext.self)
|
|
|
|
router.addMiddleware {
|
|
LogRequestsMiddleware(logLevel)
|
|
NotFoundMiddleware()
|
|
FileMiddleware(staticFilesPath)
|
|
}
|
|
|
|
router.addRoutes(RootController<AppRequestContext>().routes)
|
|
|
|
return router
|
|
}
|