flutter pub add uri基于插件公开信息、社区数据与项目使用情况整理的选型参考。
uri 包为 Dart 应用程序中的 URI 构造、解析和操作提供实用工具。它支持符合 RFC 6570 规范的 URI 模板解析，可实现带变量的动态 URL 生成。该包专为所有主要平台设计，可无缝集成到 HTTP 客户端和 Web 服务集成中。该包由 Google 维护，为 Flutter 和 Dart 项目中的复杂 URI 操作提供轻量且可靠的解决方案。
以下为关联源码仓库的 README 原文快照，最新内容请访问源码仓库。
Utilities for working with URIs in Dart, mostly parsing and generating URIs.
UriPattern is an interface for classes that match and parse URIs, much like the Pattern is for Strings. It defines the methods bool matches(Uri uri) and UriMatch match(Uri uri).
UriMatch is the result of UriPattern.match(). It contains the parameters parsed out of a URI and the "rest" of the URI left over after parsing, which is useful for parsing a single URI with multiple relative URI patterns that form a hierarchy.
UriTemplate is an implementation of RFC 6570 URI Templates. URI Templates are useful for generating URIs from data. UriTemplates are created from a template string, and then expanded with data to generate a URI:
var template = UriTemplate("http://example.com/~{user}/");
String fredUri = template.expand({'user': 'fred'});
print(fredUri); // prints: http://example.com/~fred/
URI templates are strings made up of fixed and variable parts. The variable parts are described with expressions, which are places within single curly-braces: { and }.
Expressions consist of an optional operator and a comma-separated list of variable specifications_. Variable specifications consist of a variable name and an optional modifier. The operator applies to the whole expression and controls how reserved characters are expanded, the prefix and separator, if any, applied to the expansion, and whether to expand the variable as a key/value pair. Modifiers apply to each variable in the expression and allow truncating the value, or "exploding" list and maps into multiple key/value pairs.
http://example.com/~{username}/http://example.com/dictionary/{term:1}/{term}http://example.com/search{?q,lang}URI template expansions does more than simple variable replacement, it has facilities for generating paths, fragments, query strings and more. To control the expansion, expressions can use one of the supported operators:
| Operator | Description |
|---|---|
| none | Simple string expansion |
| + | Reserved string expansion |
| # | Fragment expansion |
| . | Label expansion, dot-prefixed |
| / | Path segments, slash-prefixed |
| ; | Path-style parameters, semicolon-prefixed |
| ? | Form-style query, ampersand-separated |
| & | Form-style query continuation |
Modifiers control
| Modifier | Description |
|---|---|
| none | Default expansion |
| :n | Prefix: use only the first n characters of the value |
| * | "Explode" the lists and maps into key/value pairs |
UriParser parses URIs according to a UriTemplate, extracting parameters based on the variables defined in the template.
Since URI Templates are not designed to be parsable, only a restricted subset of templates can be used for parsing.
Parsable templates have the following restrictions over expandable templates:
UriBuilder is mutable container of URI components for incrementally building Uris.