Skip to content

Commit

Permalink
Merge pull request #2866 from pmeenan/iesg
Browse files Browse the repository at this point in the history
[compression-dictionaries] Add unicode match example
  • Loading branch information
pmeenan authored Aug 20, 2024
2 parents 386b7fe + 58b1258 commit 8c5ef08
Showing 1 changed file with 18 additions and 5 deletions.
23 changes: 18 additions & 5 deletions draft-ietf-httpbis-compression-dictionary.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@ normative:
title: Structured Field Values for HTTP
date: 1 May 2024
target: https://datatracker.ietf.org/doc/draft-ietf-httpbis-sfbis/
URL: RFC3986
URLPattern:
title: URL Pattern - Living Standard
date: 18 March 2024
Expand All @@ -75,10 +76,12 @@ informative:

--- abstract

This specification defines a mechanism for using designated HTTP responses
as an external dictionary for future HTTP responses for compression schemes
that support using external dictionaries (e.g., Brotli (RFC 7932) and
Zstandard (RFC 8878)).
This document specifies a mechanism for dictionary-based compression in the
Hypertext Transfer Protocol (HTTP). By utilizing this technique, clients and
servers can reduce the size of transmitted data, leading to improved performance
and reduced bandwidth consumption. This document extends existing HTTP compression
methods and provides guidelines for the delivery and use of compression
dictionaries within the HTTP protocol.

--- middle

Expand Down Expand Up @@ -233,6 +236,16 @@ input=MATCH, and baseURL=URL.
The "match" value is required and MUST be included in the
Use-As-Dictionary response header for the dictionary to be considered valid.

Operating at the HTTP-level, the specified match patterns will operate on the
percent-encoded version of the URL path (see {{Section 2 of URL}}).

For example the URL "http://www.example.com/düsseldorf" would be encoded as
"http://www.example.com/d%C3%BCsseldorf" and a relevant match pattern would be:

~~~ http-message
Use-As-Dictionary: match="/d%C3%BCsseldorf"
~~~

### match-dest

The "match-dest" value of the Use-As-Dictionary header is an Inner List of
Expand Down Expand Up @@ -352,7 +365,7 @@ algorithm will return TRUE for a successful match and FALSE for no-match:
1. If the Origin of BASEURL and the Origin of URL are not the same, return
FALSE.
1. Let MATCH be the value of "match" for the given dictionary.
1. Let PATTERN be a URL Pattern {{URLPattern}} constructed by setting
1. Let PATTERN be a URLPattern {{URLPattern}} constructed by setting
input=MATCH, and baseURL=BASEURL.
1. Return the result of running the "test" method of PATTERN with input=URL.

Expand Down

0 comments on commit 8c5ef08

Please sign in to comment.