<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Network.HTTP.HandleStream</title><link href="ocean.css" rel="stylesheet" type="text/css" title="Ocean" /><script src="haddock-util.js" type="text/javascript"></script><script type="text/javascript">//<![CDATA[
window.onload = function () {pageLoad();setSynopsis("mini_Network-HTTP-HandleStream.html");};
//]]>
</script></head><body><div id="package-header"><ul class="links" id="page-menu"><li><a href="src/Network-HTTP-HandleStream.html">Source</a></li><li><a href="index.html">Contents</a></li><li><a href="doc-index.html">Index</a></li></ul><p class="caption">HTTP-4000.1.1: A library for client-side HTTP</p></div><div id="content"><div id="module-header"><table class="info"><tr><th>Portability</th><td>non-portable (not tested)</td></tr><tr><th>Stability</th><td>experimental</td></tr><tr><th>Maintainer</th><td>Sigbjorn Finne <sigbjorn.finne@gmail.com></td></tr></table><p class="caption">Network.HTTP.HandleStream</p></div><div id="description"><p class="caption">Description</p><div class="doc"><p>A <code><a href="Network-TCP.html#t:HandleStream">HandleStream</a></code>-based version of <a href="Network-HTTP.html">Network.HTTP</a> interface.
</p><p>For more detailed information about what the individual exports do, please consult
the documentation for <a href="Network-HTTP.html">Network.HTTP</a>. <em>Notice</em> however that the functions here do
not perform any kind of normalization prior to transmission (or receipt); you are
responsible for doing any such yourself, or, if you prefer, just switch to using
<a href="Network-HTTP.html">Network.HTTP</a> function instead.
</p></div></div><div id="synopsis"><p id="control.syn" class="caption expander" onclick="toggleSection('syn')">Synopsis</p><ul id="section.syn" class="hide" onclick="toggleSection('syn')"><li class="src short"><a href="#v:simpleHTTP">simpleHTTP</a> :: <a href="Network-TCP.html#t:HStream">HStream</a> ty => <a href="Network-HTTP-Base.html#t:Request">Request</a> ty -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> (<a href="Network-Stream.html#t:Result">Result</a> (<a href="Network-HTTP-Base.html#t:Response">Response</a> ty))</li><li class="src short"><a href="#v:simpleHTTP_">simpleHTTP_</a> :: <a href="Network-TCP.html#t:HStream">HStream</a> ty => <a href="Network-TCP.html#t:HandleStream">HandleStream</a> ty -> <a href="Network-HTTP-Base.html#t:Request">Request</a> ty -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> (<a href="Network-Stream.html#t:Result">Result</a> (<a href="Network-HTTP-Base.html#t:Response">Response</a> ty))</li><li class="src short"><a href="#v:sendHTTP">sendHTTP</a> :: <a href="Network-TCP.html#t:HStream">HStream</a> ty => <a href="Network-TCP.html#t:HandleStream">HandleStream</a> ty -> <a href="Network-HTTP-Base.html#t:Request">Request</a> ty -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> (<a href="Network-Stream.html#t:Result">Result</a> (<a href="Network-HTTP-Base.html#t:Response">Response</a> ty))</li><li class="src short"><a href="#v:sendHTTP_notify">sendHTTP_notify</a> :: <a href="Network-TCP.html#t:HStream">HStream</a> ty => <a href="Network-TCP.html#t:HandleStream">HandleStream</a> ty -> <a href="Network-HTTP-Base.html#t:Request">Request</a> ty -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t:-40--41-">()</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> (<a href="Network-Stream.html#t:Result">Result</a> (<a href="Network-HTTP-Base.html#t:Response">Response</a> ty))</li><li class="src short"><a href="#v:receiveHTTP">receiveHTTP</a> :: <a href="Network-TCP.html#t:HStream">HStream</a> bufTy => <a href="Network-TCP.html#t:HandleStream">HandleStream</a> bufTy -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> (<a href="Network-Stream.html#t:Result">Result</a> (<a href="Network-HTTP-Base.html#t:Request">Request</a> bufTy))</li><li class="src short"><a href="#v:respondHTTP">respondHTTP</a> :: <a href="Network-TCP.html#t:HStream">HStream</a> ty => <a href="Network-TCP.html#t:HandleStream">HandleStream</a> ty -> <a href="Network-HTTP-Base.html#t:Response">Response</a> ty -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:simpleHTTP_debug">simpleHTTP_debug</a> :: <a href="Network-TCP.html#t:HStream">HStream</a> ty => <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="Network-HTTP-Base.html#t:Request">Request</a> ty -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> (<a href="Network-Stream.html#t:Result">Result</a> (<a href="Network-HTTP-Base.html#t:Response">Response</a> ty))</li></ul></div><div id="interface"><h1>Documentation</h1><div class="top"><p class="src"><a name="v:simpleHTTP" class="def">simpleHTTP</a> :: <a href="Network-TCP.html#t:HStream">HStream</a> ty => <a href="Network-HTTP-Base.html#t:Request">Request</a> ty -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> (<a href="Network-Stream.html#t:Result">Result</a> (<a href="Network-HTTP-Base.html#t:Response">Response</a> ty))<a href="src/Network-HTTP-HandleStream.html#simpleHTTP" class="link">Source</a></p><div class="doc"><p><code>simpleHTTP</code> transmits a resource across a non-persistent connection.
</p></div></div><div class="top"><p class="src"><a name="v:simpleHTTP_" class="def">simpleHTTP_</a> :: <a href="Network-TCP.html#t:HStream">HStream</a> ty => <a href="Network-TCP.html#t:HandleStream">HandleStream</a> ty -> <a href="Network-HTTP-Base.html#t:Request">Request</a> ty -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> (<a href="Network-Stream.html#t:Result">Result</a> (<a href="Network-HTTP-Base.html#t:Response">Response</a> ty))<a href="src/Network-HTTP-HandleStream.html#simpleHTTP_" class="link">Source</a></p><div class="doc"><p>Like <code><a href="Network-HTTP-HandleStream.html#v:simpleHTTP">simpleHTTP</a></code>, but acting on an already opened stream.
</p></div></div><div class="top"><p class="src"><a name="v:sendHTTP" class="def">sendHTTP</a> :: <a href="Network-TCP.html#t:HStream">HStream</a> ty => <a href="Network-TCP.html#t:HandleStream">HandleStream</a> ty -> <a href="Network-HTTP-Base.html#t:Request">Request</a> ty -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> (<a href="Network-Stream.html#t:Result">Result</a> (<a href="Network-HTTP-Base.html#t:Response">Response</a> ty))<a href="src/Network-HTTP-HandleStream.html#sendHTTP" class="link">Source</a></p><div class="doc"><p><code>sendHTTP hStream httpRequest</code> transmits <code>httpRequest</code> over
<code>hStream</code>, but does not alter the status of the connection, nor request it to be
closed upon receiving the response.
</p></div></div><div class="top"><p class="src"><a name="v:sendHTTP_notify" class="def">sendHTTP_notify</a> :: <a href="Network-TCP.html#t:HStream">HStream</a> ty => <a href="Network-TCP.html#t:HandleStream">HandleStream</a> ty -> <a href="Network-HTTP-Base.html#t:Request">Request</a> ty -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t:-40--41-">()</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> (<a href="Network-Stream.html#t:Result">Result</a> (<a href="Network-HTTP-Base.html#t:Response">Response</a> ty))<a href="src/Network-HTTP-HandleStream.html#sendHTTP_notify" class="link">Source</a></p><div class="doc"><p><code>sendHTTP_notify hStream httpRequest action</code> behaves like <code><a href="Network-HTTP-HandleStream.html#v:sendHTTP">sendHTTP</a></code>, but
lets you supply an IO <code>action</code> to execute once the request has been successfully
transmitted over the connection. Useful when you want to set up tracing of
request transmission and its performance.
</p></div></div><div class="top"><p class="src"><a name="v:receiveHTTP" class="def">receiveHTTP</a> :: <a href="Network-TCP.html#t:HStream">HStream</a> bufTy => <a href="Network-TCP.html#t:HandleStream">HandleStream</a> bufTy -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> (<a href="Network-Stream.html#t:Result">Result</a> (<a href="Network-HTTP-Base.html#t:Request">Request</a> bufTy))<a href="src/Network-HTTP-HandleStream.html#receiveHTTP" class="link">Source</a></p><div class="doc"><p><code>receiveHTTP hStream</code> reads a <code><a href="Network-HTTP-Base.html#t:Request">Request</a></code> from the <code><a href="Network-TCP.html#t:HandleStream">HandleStream</a></code> <code>hStream</code>
</p></div></div><div class="top"><p class="src"><a name="v:respondHTTP" class="def">respondHTTP</a> :: <a href="Network-TCP.html#t:HStream">HStream</a> ty => <a href="Network-TCP.html#t:HandleStream">HandleStream</a> ty -> <a href="Network-HTTP-Base.html#t:Response">Response</a> ty -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t:-40--41-">()</a><a href="src/Network-HTTP-HandleStream.html#respondHTTP" class="link">Source</a></p><div class="doc"><p><code>respondHTTP hStream httpResponse</code> transmits an HTTP <code><a href="Network-HTTP-Base.html#t:Response">Response</a></code> over
the <code><a href="Network-TCP.html#t:HandleStream">HandleStream</a></code> <code>hStream</code>. It could be used to implement simple web
server interactions, performing the dual role to <code><a href="Network-HTTP-HandleStream.html#v:sendHTTP">sendHTTP</a></code>.
</p></div></div><div class="top"><p class="src"><a name="v:simpleHTTP_debug" class="def">simpleHTTP_debug</a> :: <a href="Network-TCP.html#t:HStream">HStream</a> ty => <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:FilePath">FilePath</a> -> <a href="Network-HTTP-Base.html#t:Request">Request</a> ty -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> (<a href="Network-Stream.html#t:Result">Result</a> (<a href="Network-HTTP-Base.html#t:Response">Response</a> ty))<a href="src/Network-HTTP-HandleStream.html#simpleHTTP_debug" class="link">Source</a></p><div class="doc"><p><code>simpleHTTP_debug debugFile req</code> behaves like <code><a href="Network-HTTP-HandleStream.html#v:simpleHTTP">simpleHTTP</a></code>, but logs
the HTTP operation via the debug file <code>debugFile</code>.
</p></div></div></div></div><div id="footer"><p>Produced by <a href="http://www.haskell.org/haddock/">Haddock</a> version 2.9.2</p></div></body></html>
