Метод header класса HttpRequest.Builder

Метод header класса HttpRequest.Builder добавляет HTTP-заголовок к запросу, который создается с помощью этого билдера. В первом параметре мы передаем имя заголовка в виде строки, во второй - его значение в виде строки. Метод возвращает тот же самый объект HttpRequest.Builder, что позволяет выстраивать цепочку вызовов. Один и тот же заголовок можно добавлять несколько раз - тогда в запросе он будет присутствовать несколько раз с разными значениями.

Синтаксис

builder.header(name, value)

Пример

Давайте создадим запрос с двумя заголовками и выведем их на экран:

import java.net.http.HttpRequest;

public class Main
{
	public static void main(String[] args)
	{
		HttpRequest request = HttpRequest.newBuilder()
			.uri(java.net.URI.create("https://example.com"))
			.header("User-Agent", "Mozilla/5.0")
			.header("Accept", "text/html")
			.build();
		
		System.out.println(request.headers().map());
	}
}

Результат выполнения кода:

{Accept=[text/html], User-Agent=[Mozilla/5.0]}

Пример

Давайте добавим один и тот же заголовок дважды и посмотрим, что получится:

import java.net.http.HttpRequest;

public class Main
{
	public static void main(String[] args)
	{
		HttpRequest request = HttpRequest.newBuilder()
			.uri(java.net.URI.create("https://example.com"))
			.header("Accept", "text/html")
			.header("Accept", "application/json")
			.build();
		
		System.out.println(request.headers().allValues("Accept"));
	}
}

Результат выполнения кода:

[text/html, application/json]

Смотрите также

класс HttpRequest.Builder,
который создает HTTP-запросы
метод build,
который завершает построение запроса
метод uri,
который задает адрес запроса
класс HttpHeaders,
который хранит заголовки запроса