HTTPClient.Session

Documentation

data Session a

A session on an HTTP manager.

Instances

Monad Session

Methods

(>>=) :: Session a -> (a -> Session b) -> Session b

(>>) :: Session a -> Session b -> Session b

return :: a -> Session a

fail :: String -> Session a

Functor Session

Methods

fmap :: (a -> b) -> Session a -> Session b

(<$) :: a -> Session b -> Session a

Applicative Session

Methods

pure :: a -> Session a

(<*>) :: Session (a -> b) -> Session a -> Session b

(*>) :: Session a -> Session b -> Session b

(<*) :: Session a -> Session b -> Session a

MonadIO Session

Methods

liftIO :: IO a -> Session a

MonadError HttpException Session

Methods

throwError :: HttpException -> Session a

catchError :: Session a -> (HttpException -> Session a) -> Session a

run :: Session a -> Manager -> IO (Either HttpException a)

withManager :: (Manager -> IO (Either HttpException a)) -> Session a

requestLBSResponse :: Request -> Session (Response ByteString)

requestLBSBody :: Request -> Session ByteString

requestBSBody :: Request -> Session ByteString

Reexports

data Manager :: *

Keeps track of open connections for keep-alive.

If possible, you should share a single Manager between multiple threads and requests.

Since 0.1.0

Instances

HasHttpManager Manager

Methods

getHttpManager :: Manager -> Manager

data HttpException :: *

An exception which may be generated by this library

Since: 0.5.0

Constructors

HttpExceptionRequest Request HttpExceptionContent

Most exceptions are specific to a Request. Inspect the HttpExceptionContent value for details on what occurred.

Since: 0.5.0

InvalidUrlException String String

A URL (first field) is invalid for a given reason (second argument).

Since: 0.5.0

Instances

Show HttpException

Methods

showsPrec :: Int -> HttpException -> ShowS

show :: HttpException -> String

showList :: [HttpException] -> ShowS

Exception HttpException

Methods

toException :: HttpException -> SomeException

fromException :: SomeException -> Maybe HttpException

displayException :: HttpException -> String

MonadError HttpException Session

Methods

throwError :: HttpException -> Session a

catchError :: Session a -> (HttpException -> Session a) -> Session a

data Request :: *

All information on how to connect to a host and what should be sent in the HTTP request.

If you simply wish to download from a URL, see parseRequest.

The constructor for this data type is not exposed. Instead, you should use either the defaultRequest value, or parseRequest to construct from a URL, and then use the records below to make modifications. This approach allows http-client to add configuration options without breaking backwards compatibility.

For example, to construct a POST request, you could do something like:

initReq <- parseRequest "http://www.example.com/path"
let req = initReq
            { method = "POST"
            }

For more information, please see http://www.yesodweb.com/book/settings-types.

Since 0.1.0

Instances

Show Request

Methods

showsPrec :: Int -> Request -> ShowS

show :: Request -> String

showList :: [Request] -> ShowS