add 抽象方法

void add(
  1. String name,
  2. Object value,
  3. {@Since("2.8") bool preserveHeaderCase = false}
)

添加一个标头值。

名为 name 的标头将由从 value 分离得到的字符串值添加到其值列表中。

某些标头是单值,对于这些标头,添加的值将替换先前值。如果 value 是一个 DateTime,则将应用 HTTP 日期格式。如果值是 Iterable,则每个元素将单独添加。对于所有其他类型,将使用默认的 Object.toString 方法。

除非将 preserveHeaderCase 设置为 true,否则标头名称将被转换为小写。如果转换小写后两个标头名称相同,它们被认为是同一个标头,具有一组值。

标头名称的当前情况下,就是上次用于那个标头的 setadd 调用所使用的名称。

实现

void add(String name, Object value,
    {@Since("2.8") bool preserveHeaderCase = false});