Safe Haskell	None
Language	Haskell2010

Airship.Resource

Synopsis

Documentation

data Resource m Source

Constructors

Resource

Fields

allowMissingPost :: Webmachine m Bool: Whether to allow HTTP POSTs to a missing resource. Default: false.
allowedMethods :: Webmachine m [Method]: The set of HTTP methods that this resource allows. Default: GET and HEAD. If a request arrives with an HTTP method not included herein, 501 Not Implemented is returned.
contentTypesAccepted :: Webmachine m [(MediaType, Webmachine m ())]: An association list of MediaTypes and Webmachine actions that correspond to the accepted Content-Type values that this resource can accept in a request body. If a Content-Type header is present but not accounted for in contentTypesAccepted, processing will halt with 415 Unsupported Media Type. Otherwise, the corresponding Webmachine action will be executed and processing will continue.
contentTypesProvided :: Webmachine m [(MediaType, Webmachine m ResponseBody)]: An association list of MediaType values and ResponseBody values. The response will be chosen by looking up the MediaType that most closely matches the Content-Type header. Should there be no match, processing will halt with 406 Not Acceptable.
deleteCompleted :: Webmachine m Bool: When a DELETE request is enacted (via a True value returned from deleteResource), a False value returns a 202 Accepted response. Returning True will continue processing, usually ending up with a 204 No Content response. Default: False.
deleteResource :: Webmachine m Bool: When processing a DELETE request, a True value allows processing to continue. Returns 500 Forbidden if False. Default: false.
entityTooLarge :: Webmachine m Bool: Returns 413 Request Entity Too Large if true. Default: false.
forbidden :: Webmachine m Bool: Checks if the given request is allowed to access this resource. Returns 403 Forbidden if true. Default: false.
generateETag :: Webmachine m (Maybe ETag): If this returns a non-Nothing ETag, its value will be added to every HTTP response in the ETag: field.
implemented :: Webmachine m Bool: Checks if this resource has actually implemented a handler for a given HTTP method. Returns 501 Not Implemented if false. Default: true.
isAuthorized :: Webmachine m Bool: Returns 401 Unauthorized if false. Default: true.
isConflict :: Webmachine m Bool: When processing PUT requests, a True value returned here will halt processing with a 409 Conflict.
knownContentType :: Webmachine m Bool: Returns 415 Unsupported Media Type if false. We recommend you use the contentTypeMatches helper function, which accepts a list of MediaType values, so as to simplify proper MIME type handling. Default: true.
lastModified :: Webmachine m (Maybe UTCTime): In the presence of an If-Modified-Since header, returning a Just value from lastModifed allows the server to halt with 304 Not Modified if appropriate.
languageAvailable :: Webmachine m Bool: If an Accept-Language value is present in the HTTP request, and this function returns False, processing will halt with 406 Not Acceptable.
malformedRequest :: Webmachine m Bool: Returns 400 Bad Request if true. Default: false.
movedPermanently :: Webmachine m (Maybe ByteString): When processing a resource for which resourceExists returned False, returning a Just value halts with a 301 Moved Permanently response. The contained ByteString will be added to the HTTP response under the Location: header.
movedTemporarily :: Webmachine m (Maybe ByteString): Like movedPermanently, except with a 307 Moved Temporarily response.
multipleChoices :: Webmachine m Bool: When handling a PUT request, returning True here halts processing with 300 Multiple Choices. Default: False.
previouslyExisted :: Webmachine m Bool: When processing a request for which resourceExists returned False, returning True here allows the movedPermanently and movedTemporarily functions to process the request.
processPost :: Webmachine m (PostResponse m): When handling POST requests, the value returned determines whether to treat the request as a PUT, a PUT and a redirect, or a plain POST. See the documentation for PostResponse for more information. The default implemetation returns a PostProcess with an empty handler.
resourceExists :: Webmachine m Bool: Does the resource at this path exist? Returning false from this usually entails a 404 Not Found response. (If allowMissingPost returns True or an If-Match: * header is present, it may not).
serviceAvailable :: Webmachine m Bool: Returns 503 Service Unavailable if false. Default: true.
uriTooLong :: Webmachine m Bool: Returns 414 Request URI Too Long if true. Default: false.
validContentHeaders :: Webmachine m Bool: Returns 501 Not Implemented if false. Default: true.

Instances

MonadWriter [(Route, Resource m)] (RoutingSpec m)

data PostResponse m Source

Used when processing POST requests so as to handle the outcome of the binary decisions between handling a POST as a create request and whether to redirect after the POST is done. Credit for this idea goes to Richard Wallace (purefn) on Webcrank.

Constructors

PostCreate [Text]	Treat this request as a PUT.
PostCreateRedirect [Text]	Treat this request as a PUT, then redirect.
PostProcess (Webmachine m ())	Process as a POST, but don't redirect.
PostProcessRedirect (Webmachine m ByteString)	Process and redirect.

serverError :: Monad m => Webmachine m a Source

A helper function that terminates execution with 500 Internal Server Error.

defaultResource :: Monad m => Resource m Source

The default Airship resource, with "sensible" values filled in for each entry. You construct new resources by extending the default resource with your own handlers.