| Portability | non-portable |
|---|---|
| Stability | experimental |
| Maintainer | Anders Kaseorg <andersk@mit.edu> |
| Safe Haskell | None |
Network.CGI.Monad
Description
Internal stuff that most people shouldn't have to use. This module mostly deals with the internals of the CGIT monad transformer.
- class Monad m => MonadCGI m where
- cgiAddHeader :: HeaderName -> String -> m ()
- cgiGet :: (CGIRequest -> a) -> m a
- newtype CGIT m a = CGIT {
- unCGIT :: ReaderT CGIRequest (WriterT Headers m) a
- type CGI a = CGIT IO a
- runCGIT :: Monad m => CGIT m a -> CGIRequest -> m (Headers, a)
- data CGIRequest = CGIRequest {
- cgiVars :: Map String String
- cgiInputs :: [(String, Input)]
- cgiRequestBody :: ByteString
- throwCGI :: (MonadCGI m, MonadIO m) => SomeException -> m a
- catchCGI :: (MonadCGI m, MonadCatchIO m) => m a -> (SomeException -> m a) -> m a
- tryCGI :: (MonadCGI m, MonadCatchIO m) => m a -> m (Either SomeException a)
- handleExceptionCGI :: (MonadCGI m, MonadCatchIO m) => m a -> (SomeException -> m a) -> m a
CGI monad class
class Monad m => MonadCGI m whereSource
The class of CGI monads. Most CGI actions can be run in any monad which is an instance of this class, which means that you can use your own monad transformers to add extra functionality.
Methods
cgiAddHeader :: HeaderName -> String -> m ()Source
Add a response header.
cgiGet :: (CGIRequest -> a) -> m aSource
Get something from the CGI request.
CGI monad transformer
The CGIT monad transformer.
Instances
| MonadTrans CGIT | |
| (Monad (CGIT m), MonadCatchIO m) => MonadError SomeException (CGIT m) | |
| Monad m => Monad (CGIT m) | |
| (Functor m, Monad m) => Functor (CGIT m) | |
| (MonadIO (CGIT m), MonadCatchIO m) => MonadCatchIO (CGIT m) | |
| (Monad (CGIT m), MonadIO m) => MonadIO (CGIT m) | |
| (Monad (CGIT m), Monad m) => MonadCGI (CGIT m) | |
| (Typeable1 m, Typeable a) => Typeable (CGIT m a) |
Request info
data CGIRequest Source
The input to a CGI action.
Constructors
| CGIRequest | |
Fields
| |
Instances
Error handling
throwCGI :: (MonadCGI m, MonadIO m) => SomeException -> m aSource
catchCGI :: (MonadCGI m, MonadCatchIO m) => m a -> (SomeException -> m a) -> m aSource
Catches any expection thrown by a CGI action, and uses the given exception handler if an exception is thrown.
tryCGI :: (MonadCGI m, MonadCatchIO m) => m a -> m (Either SomeException a)Source
Catches any exception thrown by an CGI action, and returns either the exception, or if no exception was raised, the result of the action.
handleExceptionCGI :: (MonadCGI m, MonadCatchIO m) => m a -> (SomeException -> m a) -> m aSource