HTTP 强 Etag 和 弱 Etag

发布于:2025-03-12 ⋅ 阅读:(18) ⋅ 点赞:(0)

强校验和弱校验

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


网站公告

今日签到

点亮在社区的每一天
去签到