Data.IterIO.Http.Support.Action

Defines the Action monad which abstracts some of the details of handling HTTP requests with IterIO.

Documentation

type Action t b m a = StateT (ActionState t b m) m a

A StateT monad in which requests can be handled. It keeps track of the HttpReq, the form parameters from the request body and an HttpResp used to reply to the client.

data ActionState t b m

Constructors

ActionState

Fields

actionReq :: HttpReq t

actionResp :: HttpResp m

actionParams :: [Param]

actionBody :: b

data Param

A request parameter from a form field in the HTTP body

Constructors

Param

Fields

paramKey :: ByteString

paramValue :: ByteString

paramHeaders :: [(ByteString, ByteString)]

Header of a multipart/form-data post

Instances

Show Param

params :: Monad m => Action t b m [Param]

Returns a list of all Params.

param :: Monad m => ByteString -> Action t b m (Maybe Param)

Returns the Param corresponding to the specified key or Nothing if one is not present in the request.

paramVal :: Monad m => ByteString -> Action t b m ByteString

Force get parameter value

paramValM :: Monad m => (ByteString -> a) -> ByteString -> Action t b m (Maybe a)

Get (maybe) paramater value and transform it with f

setParams :: Monad m => [Param] -> Action t b m [Param]

Set the list of Params.

getBody :: Monad m => Action t b m b

Returns the body of the current request.

getHttpReq :: Monad m => Action t b m (HttpReq t)

Returns the HttpReq for the current request.

setSession :: Monad m => String -> Action t b m ()

Sets a the value for "_sess" in the cookie to the given string.

destroySession :: Monad m => Action t b m ()

Removes the "_sess" key-value pair from the cookie.

requestHeader :: Monad m => ByteString -> Action t b m (Maybe ByteString)

Returns the value of an Http Header from the request if it exists otherwise Nothing