Etag 笔记

用于标识出资源的状态。当资源发生变更时，如果其头信息中一个或者多个发生变化，或者消息实体发生变化，那么ETag也随之发生变化。
ETag常与If-None-Match或者If-Match一起，由客户端通过HTTP头信息(包括ETag值)发送给服务端处理。ETag使用如下：

request headers

......
If-None-Match: "3c64e7a072b3b57e100c96134e5ed2929e8dc56c"
......

response headers

HTTP/1.1 304 Not Modified

Date: Tue, 10 May 2016 06:29:05 GMT

Etag: "3c64e7a072b3b57e100c96134e5ed2929e8dc56c"

Server: TornadoServer/4.3

Tornado Etag 实现

根据请求的返回的数据_write_buffer，通过hashlib.sha1算出etag

def compute_etag(self):
    """Computes the etag header to be used for this request.

     By default uses a hash of the content written so far.

     May be overridden to provide custom etag implementations,
     or may return None to disable tornado's default etag support.
     """
     hasher = hashlib.sha1()
     for part in self._write_buffer:
         hasher.update(part)
     return '"%s"' % hasher.hexdigest()

通过request.headers的If-None-Match" 获取上一次的etag和这次的etag比较

 def check_etag_header(self):
        """Checks the ``Etag`` header against requests's ``If-None-Match``.

        Returns ``True`` if the request's Etag matches and a 304 should be
        returned. For example::

            self.set_etag_header()
            if self.check_etag_header():
                self.set_status(304)
                return

        This method is called automatically when the request is finished,
        but may be called earlier for applications that override
        `compute_etag` and want to do an early check for ``If-None-Match``
        before completing the request.  The ``Etag`` header should be set
        (perhaps with `set_etag_header`) before calling this method.
        """
        computed_etag = utf8(self._headers.get("Etag", ""))
        # Find all weak and strong etag values from If-None-Match header
        # because RFC 7232 allows multiple etag values in a single header.
        etags = re.findall(
            br'\*|(?:W/)?"[^"]*"',
            utf8(self.request.headers.get("If-None-Match", ""))
        )
        if not computed_etag or not etags:
            return False
        match = False
        if etags[0] == b'*':
            match = True
        else:
            # Use a weak comparison when comparing entity-tags.
            val = lambda x: x[2:] if x.startswith(b'W/') else x
            for etag in etags:
                if val(etag) == val(computed_etag):
                    match = True
                    break
        return match

如果一样说明没改变，不返还内容只返回304

......
if self.check_etag_header():
       self._write_buffer = []
       self.set_status(304)
......