WerkzeugHTTP模块中的常用方法

Werkzeug是一个Python的WSGI工具库，其中的WerkzeugHTTP模块提供了一些常用的HTTP相关的函数和类。下面是一些常用的方法以及它们的使用例子。

1. parse_options_header(header)

解析HTTP头中的Content-Type字段，返回一个元组(content_type, options)。

例子：

   from werkzeug.http import parse_options_header
   
   header = 'multipart/form-data; boundary=---------------------------9051914041544843365972754266'
   content_type, options = parse_options_header(header)
   
   print(content_type)  # 输出 'multipart/form-data'
   print(options)  # 输出 {'boundary': '---------------------------9051914041544843365972754266'}
   

2. is_resource_modified(environ, etag=None, data=None, last_modified=None)

检查资源是否已经被修改，以便决定是否返回304 Not Modified响应。

例子：

   from werkzeug.http import is_resource_modified
   
   environ = {'HTTP_IF_NONE_MATCH': '"12345"'}
   etag = '12345'
   data = b'Hello World'
   
   if not is_resource_modified(environ, etag=etag, data=data):
       print('Not Modified')
   else:
       print('Modified')
   

3. generate_etag(data)

根据数据生成一个ETag（实体标签）。

例子：

   from werkzeug.http import generate_etag
   
   data = b'Hello World'
   etag = generate_etag(data)
   
   print(etag)  # 输出 '9+se58A8+crzXU112zaRlQ=='
   

4. quote_header_value(value, extra_chars='', allow_token=True)

对HTTP头值进行URL编码。

例子：

   from werkzeug.http import quote_header_value
   
   value = 'attachment; filename="中文.txt"'
   quoted_value = quote_header_value(value)
   
   print(quoted_value)  # 输出 'attachment; filename*=utf-8''%E4%B8%AD%E6%96%87.txt'
   

5. unquote_header_value(value, is_filename=False)

对URL编码的HTTP头值进行解码。

例子：

   from werkzeug.http import unquote_header_value
   
   value = 'attachment; filename*=utf-8''%E4%B8%AD%E6%96%87.txt'
   unquoted_value = unquote_header_value(value, is_filename=True)
   
   print(unquoted_value)  # 输出 'attachment; filename="中文.txt"'
   

6. parse_dict_header(value)

解析HTTP头值为一个字典。

例子：

   from werkzeug.http import parse_dict_header
   
   value = 'foo="bar"; baz=42, qux=1.23'
   dict_header = parse_dict_header(value)
   
   print(dict_header)  # 输出 {'foo': 'bar', 'baz': '42', 'qux': '1.23'}
   

7. http_date(timestamp=None)

将给定的时间戳转换为HTTP格式的日期字符串。

例子：

   from werkzeug.http import http_date
   from datetime import datetime, timezone
   
   timestamp = datetime(2021, 1, 1, tzinfo=timezone.utc).timestamp()
   date_string = http_date(timestamp)
   
   print(date_string)  # 输出 'Fri, 01 Jan 2021 00:00:00 GMT'
   

以上是WerkzeugHTTP模块中常用的一些方法以及使用例子。这些方法可以帮助我们处理HTTP相关的任务，如解析HTTP头、检查资源是否已修改、生成ETag等。