diff options
author | Martin v. Löwis <martin@v.loewis.de> | 2002-03-17 18:37:22 (GMT) |
---|---|---|
committer | Martin v. Löwis <martin@v.loewis.de> | 2002-03-17 18:37:22 (GMT) |
commit | 587c98c863ca11d779a63f559d435c4c8f30eb93 (patch) | |
tree | 7a143ac8cd72445a5f5845e5bdcebfe7368f9b22 /Doc/lib/libbasehttp.tex | |
parent | 8ec03e0528d93c6b7cc9cf07d2f24e541661ba70 (diff) | |
download | cpython-587c98c863ca11d779a63f559d435c4c8f30eb93.zip cpython-587c98c863ca11d779a63f559d435c4c8f30eb93.tar.gz cpython-587c98c863ca11d779a63f559d435c4c8f30eb93.tar.bz2 |
Patch #430706: Persistent connections in BaseHTTPServer.
Diffstat (limited to 'Doc/lib/libbasehttp.tex')
-rw-r--r-- | Doc/lib/libbasehttp.tex | 22 |
1 files changed, 16 insertions, 6 deletions
diff --git a/Doc/lib/libbasehttp.tex b/Doc/lib/libbasehttp.tex index f867f4e..e00ae36 100644 --- a/Doc/lib/libbasehttp.tex +++ b/Doc/lib/libbasehttp.tex @@ -123,9 +123,12 @@ class variable. \end{memberdesc} \begin{memberdesc}{protocol_version} -This specifies the HTTP protocol version used in responses. -Typically, this should not be overridden. Defaults to -\code{'HTTP/1.0'}. +This specifies the HTTP protocol version used in responses. If set +to \code{'HTTP/1.1'}, the server will permit HTTP persistent +connections; however, your server \emph{must} then include an +accurate \code{Content-Length} header (using \method{send_header()}) +in all of its responses to clients. For backwards compatibility, +the setting defaults to \code{'HTTP/1.0'}. \end{memberdesc} \begin{memberdesc}{MessageClass} @@ -148,9 +151,16 @@ error response, and \var{longmessage} as the \var{explain} key A \class{BaseHTTPRequestHandler} instance has the following methods: \begin{methoddesc}{handle}{} -Overrides the superclass' \method{handle()} method to provide the -specific handler behavior. This method will parse and dispatch -the request to the appropriate \method{do_*()} method. +Calls \method{handle_one_request()} once (or, if persistent connections +are enabled, multiple times) to handle incoming HTTP requests. +You should never need to override it; instead, implement appropriate +\method{do_*()} methods. +\end{methoddesc} + +\begin{methoddesc}{handle_one_request}{} +This method will parse and dispatch +the request to the appropriate \method{do_*()} method. You should +never need to override it. \end{methoddesc} \begin{methoddesc}{send_error}{code\optional{, message}} |