Класс HeaderValue
Представление значения заголовка в формате:
value; parameter1=value1; parameter2=value2
HeaderValue может использоваться для удобного построения и разбора значений заголовков в этом формате.
Значения параметров могут быть опущены, в этом случае значение интерпретируется как null. Значения могут быть заключены в двойные кавычки, что позволяет использовать символы, не являющиеся символами RFC 7230 токена, и последовательности обратной косой черты могут использоваться для представления символов двойной кавычки и обратной косой черты.
Чтобы создать заголовок «принимает» со значением
text/plain; q=0.3, text/html
используйте код такого типа:
HttpClientRequest request = ...;
var v = HeaderValue("text/plain", {"q": "0.3"});
request.headers.add(HttpHeaders.acceptHeader, v);
request.headers.add(HttpHeaders.acceptHeader, "text/html"); Для разбора значений заголовков используйте статический метод parse.
HttpRequest request = ...;
List<String> values = request.headers[HttpHeaders.acceptHeader];
values.forEach((value) {
HeaderValue v = HeaderValue.parse(value);
// Use v.value and v.parameters
}); Экземпляр HeaderValue является неизменяемым.
- Реализуют
Конструкторы
- HeaderValue([String value = "", Map<
String, String?> parameters = const {}]) factory - Создаёт новый объект значения заголовка, устанавливая значение и параметры.
Свойства
- hashCode → int только для чтения, унаследованное
- Код хэша для этого объекта.
- parameters → Map<
String, String?> только для чтения - Карта параметров.
- runtimeType → Type только для чтения, унаследованное
- Представление типа объекта во время выполнения.
- value → String только для чтения
- Значение заголовка.
Методы
- noSuchMethod(
Invocation invocation) → dynamic унаследованное - Вызывается при доступе к несуществующему методу или свойству.
- toString(
) → String переопределённый - Возвращает отформатированное строковое представление в виде:
Операторы
- operator ==(
Object other) → bool унаследованное - Оператор равенства.
Статические методы
- parse(
String value, {String parameterSeparator = ";", String? valueSeparator, bool preserveBackslash = false}) → HeaderValue - Создаёт новый объект значения заголовка, анализируя строку значения заголовка с значением и необязательными параметрами.
© 2012 the Dart project authors
Licensed under the BSD 3-Clause "New" or "Revised" License.
https://api.dart.dev/stable/2.18.5/dart-io/HeaderValue-class.html