请求对象

以下方法描述Request的公共接口，所以可以在子类中重写所有。它还定义了几个公共属性，客户端可以使用它们来检查parsedrequest.

Request.full_url

原始URL传递给构造函数.

更改版本3.4.

Request.full_url是一个带有setter，getter和deleter的属性。获取full_url返回带有碎片的原始请求URL（如果存在）

Request.type

URI方案.

Request.host

URI权限，通常是主机，但也可能包含由冒号分隔的端口.

Request.origin_req_host

请求的原始主机，没有port.

Request.selector

URI路径。如果Request使用代理，那么选择器将是传递给代理的完整URL .

Request.data

请求的实体主体，或None如果没有说明的话

版本3.4更改：改变Request.data如果以前设置或计算过，则删除“Content-Length”标题.

Request.unverifiable

boolean，表示请求是否无法验证，如 RFC 2965 .

Request.method

所定义的HTTP请求方法。默认情况下它的值是None，这意味着get_method()将对正在使用的方法进行正常计算。它的值可以设置（从而覆盖get_method()）通过在中的类级别设置默认值来提供默认值Request子类，或绕过一个值到Request构造函数来自methodargument.

3.3版本中的新功能

版本3.4更改：现在可以在子类中设置默认值;以前它只能通过构造函数参数设置.

Request.get_method ()

返回一个表示HTTP请求方法的字符串。如果Request.method不是None，则返回其值，否则返回"GET"如果Request.data是None，或"POST"如果不是。这只对HTTP请求有意义.

更改版本3.3： get_method现在查看Request.method.

Request.add_header（key, val）的值

在请求中添加另一个标头。除了HTTP处理程序之外，所有处理程序都会忽略标头，并将它们添加到发送到服务器的标头列表中。请注意，不能有多个带有相同名称的标头，以后的调用将覆盖以前的调用以防key碰撞。目前，这不会丢失HTTP功能，因为所有标头在使用时都会超过曾经有一个（特定于标题）的方法，只使用一个标题来获得相同的功能.

Request.add_unredirected_header (key, header )

添加一个不会添加到重定向请求的标题.

Request.has_header(header)

返回实例是否具有指定标题（检查常规和非重定向）.

Request.remove_header（header）

从请求实例中删除命名标题（包括常规标题和未标题标题）.

版本3.4.

Request.get_full_url中的新内容（）

返回构造函数中给出的URL。

更改版本3.4.

返回Request.full_url

Request.set_proxy（host, type）

通过连接到代理服务器来准备请求。host和type将替换实例的那些，实例的选择器将是构造函数中给出的originalURL .

Request.get_header (header_name, default=None）

返回给定标题的值。如果标题不存在，则返回默认值.

Request.header_items ()

返回请求标题的元组列表（header_name，header_value）.

OpenerDirector Objects

OpenerDirector实例有以下方法：

OpenerDirector.add_handler（handler）

handler应该是BaseHandler。搜索以下方法，并将其添加到可能的链中（注意HTTP错误是特殊情况）.

• protocol_open() – 表示处理程序知道如何打开protocolURLs.
• http_error_type()– 表示处理程序知道如何使用HTTP错误代码来处理HTTPerrors type.
• protocol_error()– 表示处理程序知道如何处理错误（非_http）protocol.
• protocol_request()– 表示处理程序知道如何预处理protocol requests
• protocol_response() – 表示处理程序知道如何处理protocol响应.

OpenerDirector.open（url, data=None [, timeout] ）

打开给定的url（可以是请求对象或字符串），可选地通过给定的data。提出的参数，返回值和异常与urlopen()（它只是在当前安装的全局open()上调用OpenerDirector方法）。Theoptional timeout参数指定阻塞操作（如连接尝试）的超时秒数（如果未指定，将使用全局defaulttimeout设置）。超时功能实际上只适用于HTTP，HTTPS和FTP连接）.

OpenerDirector.error（proto, *args）

处理给定协议的错误。这将使用给定的参数（具体是协议）调用给定协议的已注册错误处理程序。HTTP协议是一种特殊情况，它使用HTTP响应代码来确定特定的错误处理程序;请参阅http_error_*()处理程序类的方法.

返回的值和异常与urlopen().

相同OpenerDirector对象分三个阶段打开URL：

通过排序处理程序实例确定每个阶段中调用这些方法的顺序。

1. 使用名为protocol_request()有那种方法要求预处理请求.

2. 处理程序的方法名为protocol_open()被召唤来处理请求。当一个处理程序返回非_时，此阶段结束None值（即响应），或引发异常（通常是URLError）。允许异常传播.

   实际上，上面的算法首先尝试用于default_open()。如果所有这些方法都返回None，则对于名为protocol_open()的方法重复该算法。如果所有这些方法都返回None，则对于名为unknown_open().

   请注意，这些方法的实现可能涉及父母的调用OpenerDirector实例的open()和error()方法。

3. 每个处理程序都有一个名为protocol_response()那个方法叫做后处理响应.

BaseHandler Objects

BaseHandler对象提供了一些直接有用的方法，以及其他旨在由派生类使用的方法。这些用于直接使用：

BaseHandler.add_parent（director）

添加导演为父母.

BaseHandler.close（）

删除任何父母.

以下属性和方法只能用于BaseHandler.

BaseHandler.parent

有效OpenerDirector，可用于打开使用不同的协议，或处理错误.

BaseHandler.default_open (req）

这个方法not在BaseHandler，但子类应该定义它，如果他们想要捕获所有的URL .

这个方法，如果实现，将由父亲调用OpenerDirector。它应该返回一个类似文件的对象，如open() OpenerDirector或None的返回值所述。它应该提升URLError，除非a真正特别的事情发生（例如，MemoryError不应该映射到URLError).

这个方法将在任何协议特定的打开方法之前调用.

BaseHandler.protocol_open (req )

这个方法not在BaseHandler，但如果他们想要使用给定的协议来处理URL，则子类应该定义它.

这个方法，如果定义，将由父亲调用OpenerDirector。返回值应与default_open().

BaseHandler.unknown_open（req）

这个方法是not在BaseHandler中定义的，但是子类应该定义它，如果他们想要捕获所有没有特定注册处理程序的URL来打开它.

这个方法，如果实现，将由parentOpenerDirector。返回值应与default_open().

BaseHandler.http_error_default（req, fp, code, msg, hdrs）

这个方法是not在中定义BaseHandler但是，如果子类打算为其他未处理的HTTPerrors提供一个catch-all，则应该重新设置它。它会被OpenerDirector得到错误，通常不应该在其他情况下调用.

req将是一个Request对象，fp将是一个类似文件的对象，带有HTTP错误体，code将是错误的三位数代码，msg将是用户可见的代码说明，而hdrs将是一个带有错误标题的映射对象.

提出的返回值和异常应与urlopen().

BaseHandler.http_error_nnn（req, fp, code, msg, hdrs）

nnn的返回值和异常应该是三位数的HTTP错误代码。这个方法也没有定义BaseHandler，但是当发生代码nnn的HTTP错误时，将在asubclass实例上调用（如果存在）.

子类应该覆盖此方法来处理特定的HTTP错误.

引发的参数，返回值和异常应该与http_error_default().

BaseHandler.protocol_request（req）

相同。这个方法是not在BaseHandler但是，如果子类想要预先处理给定协议的请求，则应该定义它.

这个方法，如果定义的话，将被父级调用OpenerDirector.req将是Request宾语。返回值应为Request宾语。

BaseHandler.protocol_response（req, response）

这个方法是not在中定义BaseHandler但是，如果子类想要对给定协议的后处理响应，则应该定义它.

这个方法，如果定义的话，将被父级调用OpenerDirector.req将是Request object。response将是与urlopen()的返回值相同的接口。其值应该实现与urlopen().

HTTPRedirectHandler对象的返回值相同的接口

HTTPRedirectHandler.redirect_request (req, fp, code, msg, hdrs, newurl)

返回Request 要么 None响应重定向。当从服务器接收到aredirection时，这是由http_error_30*()方法的默认实现调用的。如果要进行重定向，请返回一个新的Request允许http_error_30*()执行到newurl的重定向。否则，举起HTTPError如果没有其他处理程序应该尝试处理这个URL，或者如果你不能再用其他处理程序返回None.

注意

这种方法的默认实现并不严格遵循 RFC 2616 ，它表示301和302响应POST如果没有用户确认，请求不得自动重定向。实际上，browsersdo允许自动重定向这些响应，将POST更改为GET，默认实现再现了这种行为.

HTTPRedirectHandler.http_error_301(req, fp, code, msg, hdrs)

转到Location:或URI:网址。这个方法由theparent OpenerDirector获得HTTP’永久移动’响应时

HTTPRedirectHandler.http_error_302（req, fp, code, msg, hdrs）

和一样http_error_301()，但要求’发现’的回应.

HTTPRedirectHandler.http_error_303（req, fp, code, msg, hdrs）

和一样http_error_301()，但要求’看到其他’的回应.

HTTPRedirectHandler.http_error_307（req, fp, code, msg, hdrs）

和一样http_error_301()，但要求’临时重定向’响应.

HTTPCookieProcessor对象

HTTPCookieProcessor实例有一个属性：

HTTPCookieProcessor.cookiejar

http.cookiejar.CookieJar其中存放饼干.

ProxyHandler对象

ProxyHandler.protocol_open（request）

ProxyHandler会有一个方法protocol_open()每一个protocol在中有代理proxies在构造函数中给出的字典。该方法将修改通过代理的请求，通过调用request.set_proxy()，并调用链中的下一个处理程序来实际执行协议.

HTTPPasswordMgr对象

这些方法可以在HTTPPasswordMgr和HTTPPasswordMgrWithDefaultRealm对象上找到

HTTPPasswordMgr.add_password// (realm, uri, user, passwd）

uri可以是单个URI或一系列URI。realm, user和passwd必须是字符串。当(user, passwd)的认证和任何给定URI的超级URI被给出时，这会导致realm用作身份验证令牌.

HTTPPasswordMgr.find_user_password (realm, authuri)

获取给定领域和URI的用户/密码（如果有）。这个方法会返回(None, None)如果没有匹配的用户/密码.

对于HTTPPasswordMgrWithDefaultRealm物品，领域None如果给出realm没有匹配的用户/密码.

HTTPPasswordMgrWithPriorAuth对象

此密码管理器将HTTPPasswordMgrWithDefaultRealm扩展为支持应始终发送身份验证凭据的URI .

HTTPPasswordMgrWithPriorAuth.add_password（realm, uri, user, passwd, is_authenticated=False）

realm, uri, user, passwd至于HTTPPasswordMgr.add_password(). is_authenticated设置is_authenticated给定URI或URI列表的标志。如果is_authenticated被指定为True, realm被忽略了

HTTPPasswordMgr.find_user_password（realm, authuri）

与HTTPPasswordMgrWithDefaultRealm对象

HTTPPasswordMgrWithPriorAuth.update_authenticated（self, uri, is_authenticated=False）

更新给定is_authenticated或listof URI的uri标志.

HTTPPasswordMgrWithPriorAuth.is_authenticated (self, authuri）

返回给定URI的is_authenticated标志的当前状态.

AbstractBasicAuthHandler Objects

AbstractBasicAuthHandler.http_error_auth_reqed（authreq, host, req, headers）

通过获取用户/密码对并重新尝试请求来处理身份验证请求。authreq应该是请求中包含有关域的信息的头的名称，host指定要验证的URL和路径，req应该是（失败的）Request对象和headers应该是错误标题.

host是一个权限（例如"python.org"）或一个包含一个权限组件的URL（例如"http://python.org/"）。在任何一种情况下，授权都不能包含userinfo组件（因此，"python.org"和"python.org:80"很好，"joe:[email protected]"不是）.

HTTPBasicAuthHandler对象

HTTPBasicAuthHandler.http_error_401（req, fp, code, msg, hdrs）

如果可用，请使用身份验证信息重试请求.

ProxyBasicAuthHandler对象

ProxyBasicAuthHandler.http_error_407（req, fp, code, msg, hdrs）

如果可用，请使用身份验证信息重试请求.

AbstractDigestAuthHandler对象

AbstractDigestAuthHandler.http_error_auth_reqed（authreq, host, req, headers）

authreq应该是头部的名称，其中包含请求中包含的有关realmis的信息，host应该是要验证的主机，req应该是（失败的）Request对象，而headers应该是错误的头文件

HTTPDigestAuthHandler对象

HTTPDigestAuthHandler.http_error_401（req, fp, code, msg, hdrs）

用身份验证信息重试请求。如果可用.

ProxyDigestAuthHandler对象

ProxyDigestAuthHandler.http_error_407（req, fp, code, msg, hdrs）

使用身份验证信息重试请求。如果可用.

HTTPHandler对象

HTTPHandler.http_open（req）

发送HTTP请求，可以是GET或POST，具体取决于req.has_data().

HTTPSHandler对象

HTTPSHandler.https_open（req）

发送HTTPS请求，可以是GET或POST，取决于req.has_data().

FileHandler Objects

FileHandler.file_open（req）

如果没有主机名，则在本地打开文件，或者主机名是"localhost".

在版本3.2中更改：此方法仅适用于本地主机名。当给出一个remotehostname时，会引发一个URLError。

DataHandler Objects

DataHandler.data_open（req）

读取一个数据URL。这种URL包含URLitself中编码的内容。数据URL语法在 RFC 2397 中指定。此实现在base64编码数据URL中标记空格，因此URL可以包含在它来自的任何源文件中。但即使有些浏览器没有注意到base64编码数据URL末尾缺少填充，这种实现会在这种情况下提升ValueError

FTPHandler Objects

FTPHandler.ftp_open（req）

打开req指示的FTP文件。登录总是使用emptyusername和password.

CacheFTPHandler对象

CacheFTPHandler对象是FTPHandler对象，具有以下附加方法：

CacheFTPHandler.setTimeout（t）

设置连接超时到t秒.

CacheFTPHandler.setMaxConns (m）

设置最大缓存连接数m.

UnknownHandler Objects

UnknownHandler.unknown_open（）

举起URLErrorexception.

HTTPErrorProcessor Objects

HTTPErrorProcessor.http_response（request, response）

处理HTTP错误响应

对于200个错误代码，响应对象是立即返回.

对于非200错误代码，这只是将作业传递给protocol_error_code()处理程序方法，通过OpenerDirector.error()。最后，HTTPDefaultErrorHandler将如果没有其他处理程序处理错误，则HTTPError举起

HTTPErrorProcessor.https_response（request, response)

进程HTTPS错误响应

行为是与http_response().

相同示例

除了以下示例之外，还有更多示例在 HOWTO使用urllib包获取Internet资源.

此示例获取python.org主页并显示前300个字节.

>>> import urllib.request>>> with urllib.request.urlopen("http://www.python.org/") as f:...     print(f.read(300))...b"<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\n\n\n<htmlxmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\n\n<head>\n<meta http-equiv="content-type" content="text/html; charset=utf-8" />\n<title>Python Programming "

请注意，urlopen返回一个bytes对象。这是因为没有办法自动确定从HTTP服务器接收的字节流的编码。通常，一旦程序确定或猜测出适当的编码，程序就会将返回的字节对象解码为字符串.

以下W3C文档https://www.w3.org/International/O-charset列出了（X）HTML或XML文档可以指定编码信息的各种方式.

由于python.org网站使用其元标记中指定的 utf-8 编码，我们将使用相同的方法来解码字节对象.

>>> with urllib.request.urlopen("http://www.python.org/") as f:...     print(f.read(100).decode("utf-8"))...<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtm

不使用上下文管理器方法

>>> import urllib.request>>> f = urllib.request.urlopen("http://www.python.org/")>>> print(f.read(100).decode("utf-8"))<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtm

在下面的示例中，我们将数据流发送到CGI的stdin并读取它返回给我们的数据。请注意，此示例仅在Python安装支持SSL时才起作用.

>>> import urllib.request>>> req = urllib.request.Request(url="https://localhost/cgi-bin/test.cgi",...                       data=b"This data is passed to stdin of the CGI")>>> with urllib.request.urlopen(req) as f:...     print(f.read().decode("utf-8"))...Got Data: "This data is passed to stdin of the CGI"

上例中使用的示例CGI的代码是：

#!/usr/bin/env pythonimport sysdata = sys.stdin.read()print("Content-type: text/plain\n\nGot Data: "%s"" % data)

这是使用PUT执行Request请求的示例：

import urllib.requestDATA = b"some data"req = urllib.request.Request(url="http://localhost:8080", data=DATA,method="PUT")with urllib.request.urlopen(req) as f:    passprint(f.status)print(f.reason)

使用BasicHTTP身份验证：

import urllib.request# Create an OpenerDirector with support for Basic HTTP Authentication...auth_handler = urllib.request.HTTPBasicAuthHandler()auth_handler.add_password(realm="PDQ Application",                          uri="https://mahler:8092/site-updates.py",                          user="klem",                          passwd="kadidd!ehopper")opener = urllib.request.build_opener(auth_handler)# ...and install it globally so it can be used with urlopen.urllib.request.install_opener(opener)urllib.request.urlopen("http://www.example.com/login.html")

build_opener()默认提供许多处理程序，包括ProxyHandler。默认情况下，ProxyHandler使用名为<scheme>_proxy的环境变量，其中<scheme>是所涉及的URL方案。例如，http_proxy读取环境变量以获取HTTP代理URL .

这个例子取代了默认的ProxyHandler使用以编程方式提供的代理URL，并添加代理授权支持ProxyBasicAuthHandler.

proxy_handler = urllib.request.ProxyHandler({"http": "http://www.example.com:3128/"})proxy_auth_handler = urllib.request.ProxyBasicAuthHandler()proxy_auth_handler.add_password("realm", "host", "username", "password")opener = urllib.request.build_opener(proxy_handler, proxy_auth_handler)# This time, rather than install the OpenerDirector, we use it directly:opener.open("http://www.example.com/login.html")

添加HTTP头：

使用headers参数Request构造函数，要么：

import urllib.requestreq = urllib.request.Request("http://www.example.com/")req.add_header("Referer", "http://www.python.org/")# Customize the default User-Agent header value:req.add_header("User-Agent", "urllib-example/0.1 (Contact: . . .)")r = urllib.request.urlopen(req)

OpenerDirector自动添加User-Agent标题to//very Request。要改变这个：

import urllib.requestopener = urllib.request.build_opener()opener.addheaders = [("User-agent", "Mozilla/5.0")]opener.open("http://www.example.com/")

另外，请记住一些标准标题（Content-Length,Content-Type和Host）当Request被传递到urlopen()（要么OpenerDirector.open()）.

这是一个使用GET方法检索URL包含参数的示例会话：

>>> import urllib.request>>> import urllib.parse>>> params = urllib.parse.urlencode({"spam": 1, "eggs": 2, "bacon": 0})>>> url = "http://www.musi-cal.com/cgi-bin/query?%s" % params>>> with urllib.request.urlopen(url) as f:...     print(f.read().decode("utf-8"))...

以下示例使用POST方法而不是。请注意，从urlencode输出的params在被发送到urlopen之前被编码为字节作为data：

>>> import urllib.request>>> import urllib.parse>>> data = urllib.parse.urlencode({"spam": 1, "eggs": 2, "bacon": 0})>>> data = data.encode("ascii")>>> with urllib.request.urlopen("http://requestb.in/xrbl82xr", data) as f:...     print(f.read().decode("utf-8"))...

以下示例使用显式指定的HTTP代理，overridingen环境设置：

>>> import urllib.request>>> proxies = {"http": "http://proxy.example.com:8080/"}>>> opener = urllib.request.FancyURLopener(proxies)>>> with opener.open("http://www.python.org") as f:...     f.read().decode("utf-8")...

以下示例在以下示例中不使用代理all，覆盖环境设置：

>>> import urllib.request>>> opener = urllib.request.FancyURLopener({})>>> with opener.open("http://www.python.org/") as f:...     f.read().decode("utf-8")...

Legacy interface

以下函数和类从Python 2模块urllib移植（而不是urllib2）。他们可能会在将来的某个时候被弃用.

urllib.request.urlretrieve(url, filename=None, reporthook=None, data=None)

将URL表示的网络对象复制到本地文件。如果URL指向本地文件，除非提供了filename，否则不会复制该对象。返回一个元组(filename, headers)其中filename是可以在其下找到对象的本地文件名，headers是w//verthe info() urlopen()返回的对象的方法返回（远程对象）。例外情况与urlopen().

第二个参数（如果存在）指定要复制到的文件位置（如果有，则该位置将是具有生成名称的临时文件）。第三个参数（如果存在）是一个可调用的，一旦建立网络连接就会被调用，并且在每个块之后被调用一次。callable将传递三个参数;到目前为止传输的块数，块大小（以字节为单位）以及文件的总大小。第三个参数可能是-1在较旧的FTP服务器上，它们没有返回文件大小以响应检索请求.

以下示例说明了最常见的使用场景：

>>> import urllib.request>>> local_filename, headers = urllib.request.urlretrieve("http://python.org/")>>> html = open(local_filename)>>> html.close()

如果url使用http:方案标识符，可以给出data参数可选指定POST请求（通常请求类型为GET）。data参数必须是标准application/x-www-form-urlencoded格式的字节对象;看urllib.parse.urlencode()功能

urlretrieve()会举起ContentTooShortError当它检测到可用数据量小于预期数量时（这是Content-Length报头报告的大小）。例如，下载中断时会发生这种情况.

Content-Length被视为下限：如果有更多数据要读取，urlretrieve会读取更多数据，但如果可用的数据较少，则会引发异常.

在这种情况下你仍然可以检索下载的数据，它存储在异常实例的content属性中.

如果没有Content-Length提供了标头，urlretrieve无法检查它已下载的数据的大小，只返回它。在这种情况下，你只需假设下载成功.

urllib.request.urlcleanup ( )

清除以前调用可能遗留的临时文件到urlretrieve().

class urllib.request.URLopener（proxies=None, **x509）

自版本3.3以后已弃用.

用于打开和读取URL的基类。除非你需要使用http:, ftp:或file:以外的方案支持openobjects，你可能想要使用FancyURLopener.

默认情况下，URLopener类发送一个User-Agent标题urllib/VVV，VVV是个 urllib版本号。应用程序可以定义自己的User-Agent通过子类化URLopener要么 FancyURLopener并设置类属性version在子类定义中适当的字符串值.

可选proxies参数应该是字典映射方案名称toproxy URL，其中空字典完全关闭代理。它的默认值是​​None，在这种情况下，如果存在，将使用环境代理设置，如上面urlopen()的定义所讨论的

//在x509，可以在使用https:方案时使用客户端的身份验证。关键字key_file和cert_file支持提供SSL密钥和证书;两者都需要支持客户端身份验证.

URLopener如果服务器返回错误代码，对象将引发OSError异常.

open（fullurl, data=None）

使用适当的协议打开fullurl。此方法设置缓存和代理信息，然后使用其输入参数调用适当的open方法。如果方案无法识别，open_unknown()叫data参数和data // urlopen().

open_unknown（fullurl, data=None）

的参数含义相同@Otridable接口打开未知网址类型.

retrieve(url, filename=None, reporthook=None, data=None)

检索url并把它放在filename。返回值是一个元组，由一个本地文件名和email.message.Message对象组成，包含响应头（对于远程URL）或None（对于本地URL）。然后打电话者必须打开并阅读filename的内容。如果没有给出filename并且URL引用了alocal文件，则返回输入文件名。如果URL是非本地的并且filename如果没有给出，则文件名是tempfile.mktemp()的输出，其后缀与inputURL的最后一个路径组件的后缀相匹配。如果reporthook如果给出，它必须是一个接受三个数字参数的函数：一个块号，读入的最大大小块和下载的总大小（如果未知，则为-1）。它将在开始时调用一次，并在从网络中读取每个数据块之后调用。reporthook被忽略为本地URL

如果url使用http:方案标识符，则可以选择data参数指定POST请求（通常请求类型为GET）。data参数必须采用标准application/x-www-form-urlencoded格式;参见urllib.parse.urlencode() function.

version

Variable，指定开启者对象的用户代理。要获得urllib告诉服务器它是一个特定的用户代理，在调用baseconstructor之前在asubclass中将其设置为类变量或在构造函数中设置.

class urllib.request.FancyURLopener (…）

自版本3.3以后不推荐使用.

FancyURLopener子类URLopener为以下HTTP响应代码提供默认处理：301,302,303,307和401.对于上面列出的30xresponse代码，Locationheader用于获取实际的URL。对于401响应代码（需要身份验证），执行基本HTTP身份验证。对于30x响应代码，递归受到maxtries属性，默认为10.

对于所有其他响应代码，调用方法http_error_default()，你可以在子类中覆盖以适当地处理错误.

注意

根据 RFC 2616 未经用户确认，不得自动重定向，301和302对POST请求的响应。Inreality，浏览器允许自动重定向这些响应，将POST更改为GET和urllib再现这种行为.

构造函数的参数与URLopener.

注意

执行基本身份验证时，FancyURLopener实例调用prompt_user_passwd()方法。默认实现向用户询问控制终端上所需的信息。如果需要，子类可以使用此方法来支持更合适的行为.

FancyURLopenerclass提供了一个额外的方法，应该重载以提供适当的行为：

prompt_user_passwd（host, realm）

返回在指定安全领域中给定主机上验证用户所需的信息。返回值应为元组(user,password)，可用于基本认证.

实施提示在终端上提供此信息;应用程序应该覆盖此方法以在localenvironment中使用适当的交互模型.

urllib.request限制

• 目前，仅支持以下协议：HTTP（版本0.9和1.0），FTP，本地文件和数据URL。

  更改版本3.4：添加了对数据URL的支持。

• 的缓存功能urlretrieve()已被禁用，直到有人找到时间来破解到期时间标题的正确处理.

• 应该有一个函数来查询特定的URL是否在缓存中.

• 为了向后兼容，如果是URL似乎指向本地文件，但无法打开文件，使用FTP协议重新解释URL。这有时会导致令人困惑的错误信息.

• urlopen()和urlretrieve()功能会在等待网络连接建立时造成任意长时间的延迟。这意味着很难使用这些函数构建交互式Web客户端而不使用线程

• // urlopen()或urlretrieve()返回的数据是服务器的原始数据。这可以是二进制数据（例如图像），纯文本（例如）HTML。HTTP协议在replyheader中提供类型信息，可以通过查看Content-Type标题来检查。如果返回的数据是HTML，你可以使用模块html.parser来解析它.

• 处理FTP协议的代码无法区分文件和内容。尝试读取指向无法访问的文件的URL时，这可能会导致意外行为。如果URL以/结尾，则认为它引用了一个目录并将进行相应的处理。但是，如果试图读取文件会导致550错误（意味着无法找到URL或通常出于权限原因而无法访问该URL），则该路径将被视为adirectory，以便处理URL指定目录时的情况但尾随/已被取消。当您尝试获取其读取权限使其无法访问的文件时，这可能会导致误导性结果;FTPcode将尝试读取它，失败并出现550错误，然后为不可读文件执行目录列表。如果需要细粒度控制，可以考虑使用ftplib模块，子类化FancyURLopener，或者更改_urlopener来满足你的需要.