Movatterモバイル変換

[0]ホーム
URL:

Up one LevelPython Library ReferenceContentsModule IndexIndex
Previous:Up:18. Internet Protocols andNext:

18.7httplib -- HTTP protocol client

This module defines classes which implement the client side of theHTTP and HTTPS protocols. It is normally not used directly -- themoduleurllib uses it to handle URLsthat use HTTP and HTTPS.

Note:HTTPS support is only available if thesocket module was compiled with SSL support.

Note:The public interface for this module changed substantially in Python 2.0. TheHTTP class is retained only for backward compatibility with 1.5.2. It should not be used in new code. Refer to the online docstrings for usage.

The module provides the following classes:

class HTTPConnection(host[, port[, strict]])
AnHTTPConnection instance represents one transaction with an HTTPserver. It should be instantiated passing it a host and optional port number.If no port number is passed, the port is extracted from the host string if ithas the formhost:port, else the default HTTP port (80) isused. When True, the optional parameterstrictcausesBadStatusLine to be raised if the status line can't be parsedas a valid HTTP/1.0 or 1.1 status line.

For example, the following calls all create instances that connect tothe server at the same host and port:

>>> h1 = httplib.HTTPConnection('www.cwi.nl')>>> h2 = httplib.HTTPConnection('www.cwi.nl:80')>>> h3 = httplib.HTTPConnection('www.cwi.nl', 80)
New in version 2.0.

class HTTPSConnection(host[, port[, key_file[, cert_file[, strict]]]])
A subclass ofHTTPConnection that uses SSL for communication withsecure servers. Default port is443.key_file isthe name of a PEM formatted file that contains your privatekey.cert_file is a PEM formatted certificate chain file.

Warning:This does not do any certificate verification!

New in version 2.0.

class HTTPResponse(sock[, debuglevel=0][, strict=0])
Class whose instances are returned upon successful connection. Notinstantiated directly by user.New in version 2.0.

The following exceptions are raised as appropriate:

exception HTTPException
The base class of the other exceptions in this module. It is asubclass ofException.New in version 2.0.

exception NotConnected
A subclass ofHTTPException.New in version 2.0.

exception InvalidURL
A subclass ofHTTPException, raised if a port is given and iseither non-numeric or empty.New in version 2.3.

exception UnknownProtocol
A subclass ofHTTPException.New in version 2.0.

exception UnknownTransferEncoding
A subclass ofHTTPException.New in version 2.0.

exception UnimplementedFileMode
A subclass ofHTTPException.New in version 2.0.

exception IncompleteRead
A subclass ofHTTPException.New in version 2.0.

exception ImproperConnectionState
A subclass ofHTTPException.New in version 2.0.

exception CannotSendRequest
A subclass ofImproperConnectionState.New in version 2.0.

exception CannotSendHeader
A subclass ofImproperConnectionState.New in version 2.0.

exception ResponseNotReady
A subclass ofImproperConnectionState.New in version 2.0.

exception BadStatusLine
A subclass ofHTTPException. Raised if a server responds with aHTTP status code that we don't understand.New in version 2.0.

The constants defined in this module are:

HTTP_PORT
The default port for the HTTP protocol (always80).

HTTPS_PORT
The default port for the HTTPS protocol (always443).

and also the following constants for integer status codes:

ConstantValueDefinition
CONTINUE100HTTP/1.1,RFC 2616, Section 10.1.1
SWITCHING_PROTOCOLS101HTTP/1.1,RFC 2616, Section 10.1.2
PROCESSING102WEBDAV,RFC 2518, Section 10.1
OK200HTTP/1.1,RFC 2616, Section 10.2.1
CREATED201HTTP/1.1,RFC 2616, Section 10.2.2
ACCEPTED202HTTP/1.1,RFC 2616, Section 10.2.3
NON_AUTHORITATIVE_INFORMATION203HTTP/1.1,RFC 2616, Section 10.2.4
NO_CONTENT204HTTP/1.1,RFC 2616, Section 10.2.5
RESET_CONTENT205HTTP/1.1,RFC 2616, Section 10.2.6
PARTIAL_CONTENT206HTTP/1.1,RFC 2616, Section 10.2.7
MULTI_STATUS207WEBDAVRFC 2518, Section 10.2
IM_USED226Delta encoding in HTTP,RFC 3229, Section 10.4.1
MULTIPLE_CHOICES300HTTP/1.1,RFC 2616, Section 10.3.1
MOVED_PERMANENTLY301HTTP/1.1,RFC 2616, Section 10.3.2
FOUND302HTTP/1.1,RFC 2616, Section 10.3.3
SEE_OTHER303HTTP/1.1,RFC 2616, Section 10.3.4
NOT_MODIFIED304HTTP/1.1,RFC 2616, Section 10.3.5
USE_PROXY305HTTP/1.1,RFC 2616, Section 10.3.6
TEMPORARY_REDIRECT307HTTP/1.1,RFC 2616, Section 10.3.8
BAD_REQUEST400HTTP/1.1,RFC 2616, Section 10.4.1
UNAUTHORIZED401HTTP/1.1,RFC 2616, Section 10.4.2
PAYMENT_REQUIRED402HTTP/1.1,RFC 2616, Section 10.4.3
FORBIDDEN403HTTP/1.1,RFC 2616, Section 10.4.4
NOT_FOUND404HTTP/1.1,RFC 2616, Section 10.4.5
METHOD_NOT_ALLOWED405HTTP/1.1,RFC 2616, Section 10.4.6
NOT_ACCEPTABLE406HTTP/1.1,RFC 2616, Section 10.4.7
PROXY_AUTHENTICATION_REQUIRED407HTTP/1.1,RFC 2616, Section 10.4.8
REQUEST_TIMEOUT408HTTP/1.1,RFC 2616, Section 10.4.9
CONFLICT409HTTP/1.1,RFC 2616, Section 10.4.10
GONE410HTTP/1.1,RFC 2616, Section 10.4.11
LENGTH_REQUIRED411HTTP/1.1,RFC 2616, Section 10.4.12
PRECONDITION_FAILED412HTTP/1.1,RFC 2616, Section 10.4.13
REQUEST_ENTITY_TOO_LARGE413HTTP/1.1,RFC 2616, Section 10.4.14
REQUEST_URI_TOO_LONG414HTTP/1.1,RFC 2616, Section 10.4.15
UNSUPPORTED_MEDIA_TYPE415HTTP/1.1,RFC 2616, Section 10.4.16
REQUESTED_RANGE_NOT_SATISFIABLE416HTTP/1.1,RFC 2616, Section 10.4.17
EXPECTATION_FAILED417HTTP/1.1,RFC 2616, Section 10.4.18
UNPROCESSABLE_ENTITY422WEBDAV,RFC 2518, Section 10.3
LOCKED423WEBDAVRFC 2518, Section 10.4
FAILED_DEPENDENCY424WEBDAV,RFC 2518, Section 10.5
UPGRADE_REQUIRED426HTTP Upgrade to TLS,RFC 2817, Section 6
INTERNAL_SERVER_ERROR500HTTP/1.1,RFC 2616, Section 10.5.1
NOT_IMPLEMENTED501HTTP/1.1,RFC 2616, Section 10.5.2
BAD_GATEWAY502HTTP/1.1RFC 2616, Section 10.5.3
SERVICE_UNAVAILABLE503HTTP/1.1,RFC 2616, Section 10.5.4
GATEWAY_TIMEOUT504HTTP/1.1RFC 2616, Section 10.5.5
HTTP_VERSION_NOT_SUPPORTED505HTTP/1.1,RFC 2616, Section 10.5.6
INSUFFICIENT_STORAGE507WEBDAV,RFC 2518, Section 10.6
NOT_EXTENDED510An HTTP Extension Framework,RFC 2774, Section 7

responses
This dictionary maps the HTTP 1.1 status codes to the W3C names.

Example:httplib.responses[httplib.NOT_FOUND] is'Not Found'.New in version 2.5.


Subsections

Up one LevelPython Library ReferenceContentsModule IndexIndex
Previous:Up:18. Internet Protocols andNext:
Release 2.5.2, documentation updated on 21st February, 2008.
SeeAbout this document... for information on suggesting changes.
[8]ページ先頭
©2009-2025 Movatter.jp