Documentation

Abortion is an Exception that aborts the execution of Network.HTTP.Lucu.Rsrc monad with a StatusCode, additional response headers, and an optional message text.

If the Network.HTTP.Lucu.Rsrc is in the Deciding Header or any precedent states, throwing an Abortion affects the HTTP response to be sent to the client.
Otherwise it's too late to overwrite the HTTP response so the only possible thing the system can do is to dump the exception to the stderr. See cnfDumpTooLateAbortionToStderr.

Note that the status code doesn't necessarily have to satisfy isError so you can abuse this exception for redirections as well as error reporting e.g.

   Network.HTTP.Lucu.abort $ Network.HTTP.Lucu.mkAbortion MovedPermanently
           [("Location", "http:example.net/")]
           (Just "It's been moved to example.net.")

Instances

Eq Abortion
Show Abortion
Typeable Abortion
Exception Abortion
HasHeaders Abortion

mkAbortion :: (StatusCode sc, Foldable f (CIAscii, Ascii)) => sc -> f -> Maybe Text -> Abortion Source

Construct an Abortion with additional headers and an optional message text.

mkAbortion' :: StatusCode sc => sc -> Text -> Abortion Source

Construct an Abortion without any additional headers but with a message text.

abort :: MonadIO m => Abortion -> m aSource

Throw an Abortion in a MonadIO, including the very Network.HTTP.Lucu.Rsrc monad.