HTTP 强 Etag 和弱 Etag

强校验和弱校验

ETag机制同时支持强校验和弱校验。它们通过ETag标识符的开头是否存在"W/"来区分，如：

"123456789" -- 一个强ETag验证符

W/"123456789" -- 一个弱ETag验证符

强校验的ETag匹配要求两个资源内容的每个字节需完全相同，包括所有其他实体字段（如Content-Language）不发生变化。强ETag允许重新装配和缓存部分响应，以及字节范围请求。弱校验的ETag匹配要求两个资源在语义上相等，这意味着在实际情况下它们可以互换，而且缓存副本也可以使用。不过这些资源不需要每个字节相同，因此弱ETag不适合字节范围请求。当Web服务器无法生成强ETag的时候，比如动态生成的内容，弱ETag就可能发挥作用了。

强 ETag 值和弱 ETag 值

强ETag值，无论实体发生多么细微的变化都会改变其值。

弱ETag值，只用于提示资源是否相同。只有资源发生了根本改变，产生差异时才会改变ETag的值。

正常(强)ETag和弱ETag之间的区别在于匹配的强ETag保证文件的字节与字节相同，而匹配的弱ETag表示内容在语义上相同。所以如果文件的内容发生变化，那么弱的ETag也会改变。

nodjs etag模块

etag(entity, options)

entity: 可以是String, Buffer, fs.Stats

options.weak: 是否生成弱的etag, 默认为false（即默认生成强的etag），但是如果entity为fs.Stats，那么生成弱的etag。

// 只列出核心代码，一些对参数的校验啥的已略过
function etag (entity, options) {
 // 判断entity是否为fs.Stats类型
 var isStats = isstats(entity)
 var weak = options && typeof options.weak === 'boolean'
 ? options.weak
 : isStats

 // generate entity tag
 var tag = isStats
 ? stattag(entity)
 : entitytag(entity)

 return weak
 ? 'W/' + tag // 弱etag
 : tag
}

// 弱的etag是根据fs.Stats生成
function stattag (stat) {
 // 得到mtime时间戳的16进制
 var mtime = stat.mtime.getTime().toString(16)
 // 得到size的16进制
 var size = stat.size.toString(16)
 // 按照规范etag，应该用双引号包裹生成的字符串。
 return '"' + size + '-' + mtime + '"'
}
// 强tag，是将buffer或者字符串进行sha1，
// 在进行base64编码，在截取前27位
function entitytag (entity) {
 if (entity.length === 0) {
 // fast-path empty
 return '"0-2jmj7l5rSw0yVb/vlWAYkK/YBwk"'
 }

 // compute hash of entity
 var hash = crypto
 .createHash('sha1')
 .update(entity, 'utf8')
 .digest('base64')
 .substring(0, 27)

 // 获取字符串或者buffer的字节数
 var len = typeof entity === 'string'
 ? Buffer.byteLength(entity, 'utf8')
 : entity.length

 // " + 字节数的16进制 + 连接符 + hash + " => 强etag
 return '"' + len.toString(16) + '-' + hash + '"'
}

参考链接：

HTTP ETag

http-etag-if-none-match

HTTP 强 Etag 和 弱 Etag

强校验和弱校验

强 ETag 值和弱 ETag 值

nodjs etag模块

HTTP 强 Etag 和弱 Etag