An lmug adapter for the Nova web server
Introduction ↟
Like Clojure's Ring before it, LFE's lmug provides the LFE programmer a means for creating middleware between an HTTP server request and the response that is returned to the client.
In particular, lmug-nova implements an lmug adaptor for use with the Nova framework's HTTP server, allowing lmug middleware to run on it by adapting lmug requests, responses, and handlers to the Nova API.
Installation ↟
{deps, [
{lmug-nova, "0.1.0", {pkg, lmug_nova}}
]}.Documentation ↟
Usage ↟
Define an app with a middleware chain. First, let's make a little static resource content:
mkdir static
echo "<html><body>lmug-nova dev server</body></html>" > static/index.htmllfe> (set app (clj:-> (lmug:app)
(lmug-mw-request-id:wrap)
(lmug-mw-content-type:wrap)
(lmug-mw-resource:wrap #m(doc-root "static"))
(lmug-mw-status-body:wrap)
(lmug-mw-log-request:wrap #m(log-level notice))))(set app (clj:-> (lmug:app)
(lmug-mw-resource:wrap)))
(lmug-nova:start app #m(port 5099))
(lmug-state:get-metadata)
(set app (clj:-> (lmug:app)
(lmug-mw-resource:wrap #m(doc-root "../"))))
(set app (clj:-> (lmug:app)
(lmug-mw-resource:wrap #m(doc-root "priv"))))
(set app (clj:-> (lmug:app)
(lmug-mw-resource:wrap #m(doc-root "../lmug/priv"))))
(set app (clj:-> (lmug:app)
(lmug-mw-resource:wrap
#m(doc-root "../lmug/priv"
watcher? true))))
(lmug-state:get-metadata)
(application:ensure_all_started 'fs)
(fs:subscribe)
(fs_demo:start_looper)
;; do stuff on filesystem
(flush)
(fs:start_link 'lfe> (lmug-nova:start app #m(port 5099))This can be tested from another terminal with curl:
curl -v "http://alice:sekr1t@localhost:5099/response.txt"Which will give something like the following:
* Trying 127.0.0.1:5099...
* Connected to localhost (127.0.0.1) port 5099 (#0)
* Server auth using Basic with user 'alice'
> GET /response.txt HTTP/1.1
> Host: localhost:5099
> Authorization: Basic YWxpY2U6c2VrcjF0
> User-Agent: curl/8.1.2
> Accept: */*
>
< HTTP/1.1 200 OK
< Date: Tue, 20 Feb 2024 01:41:26 GMT
< Server: XXX/TBD
< X-Request-ID: 11548829628205025075258581696865370112
< Content-Type: text/plain
< Content-Length: 3
<
* Connection #0 to host localhost left intact
200Then, to test the static resource middleware:
curl -v "http://localhost:5099/index.html"or:
curl -v "http://localhost:5099/"Will give something like the following:
* Trying 127.0.0.1:5099...
* Connected to localhost (127.0.0.1) port 5099 (#0)
> GET /index.html HTTP/1.1
> Host: localhost:5099
> User-Agent: curl/8.1.2
> Accept: */*
>
< HTTP/1.1 200 OK
< Date: Tue, 20 Feb 2024 01:42:54 GMT
< Server: XXX/TBD
< Content-Type: text/html
< Etag: tCTQL448
< Content-Length: 48
< Last-Modified: Mon, 19 Feb 2024 22:11:55 GMT
<
<html><body>lmug-nova dev server</body></html>
* Connection #0 to host localhost left intactLicense ↟
Copyright © 2016-2024, LFE Dragon Team
Distributed under the Apache License, Version 2.0.