Network.Wai.Middleware.Routes.Handler

Provides a HandlerM Monad that makes it easy to build Handlers

Documentation

type HandlerM sub master a = HandlerMI sub master IO a

The HandlerM Monad

A Monad that makes it easier to build a Handler

runHandlerM :: HandlerM sub master () -> HandlerS sub master

Run HandlerM, resulting in a Handler

Run a HandlerM to get a Handler

request :: HandlerM sub master Request

Get the request

Access the request data

routeAttrSet :: RouteAttrs sub => HandlerM sub master (Set Text)

Get the current route attributes

Access the route attribute list

rootRouteAttrSet :: RouteAttrs master => HandlerM sub master (Set Text)

Get the attributes for the current root route

Access the route attribute list for the root route

maybeRoute :: HandlerM sub master (Maybe (Route sub))

Get the current route

Access the route data

maybeRootRoute :: HandlerM sub master (Maybe (Route master))

Get the current root route

Access the root route data

master :: HandlerM sub master master

Get the master

Access the master datatype

header :: HeaderName -> ByteString -> HandlerM sub master ()

Add a header to the application response TODO: Differentiate between setting and adding headers

Add a header to the response

status :: Status -> HandlerM sub master ()

Set the response status

Set the response status

raw :: ByteString -> HandlerM sub master ()

Set the response body TODO: Add functions to append to body, and also to flush body contents

Set the raw response body

json :: ToJSON a => a -> HandlerM sub master ()

Set the body of the response to the JSON encoding of the given value. Also sets "Content-Type" header to "application/json".

Set the json response body

text :: Text -> HandlerM sub master ()

Set the body of the response to the given Text value. Also sets "Content-Type" header to "text/plain".

Set the text response body

html :: ByteString -> HandlerM sub master ()

Set the body of the response to the given Text value. Also sets "Content-Type" header to "text/html".

Set the html response body

next :: HandlerM sub master ()

Run the next application

Run the next application in the stack