Интерфейс SocketOptions

@Native static final int TCP_NODELAY

Отключить алгоритм Нагле для этого подключения. Данные, записанные в сеть, не буферизуются, ожидая подтверждения ранее записанных данных.

Допустимо только для TCP: SocketImpl.

@Native static final int SO_BINDADDR

Получить привязку локального адреса сокета (этот параметр нельзя «установить», только «получить», так как сокеты привязываются во время создания, и поэтому локальный привязанный адрес нельзя изменить). По умолчанию локальный адрес сокета — INADDR_ANY, то есть любой локальный адрес на хосте с несколькими интерфейсами. Хост с несколькими интерфейсами может использовать этот параметр для приема подключений только к одному из своих адресов (в случае ServerSocket или DatagramSocket) или для указания адреса возврата подключению (в случае Socket или DatagramSocket). Параметром этого параметра является InetAddress.

Этот параметр обязательно должен быть указан в конструкторе.

Допустимо для: SocketImpl, DatagramSocketImpl

@Native static final int SO_REUSEADDR

Устанавливает SO_REUSEADDR для сокета. Используется только для MulticastSockets в Java, и по умолчанию установлен для MulticastSockets.

Допустимо для: DatagramSocketImpl

@Native static final int SO_REUSEPORT

Устанавливает SO_REUSEPORT для сокета. Этот параметр включает и выключает возможность иметь несколько сокетов, слушающих один и тот же адрес и порт.

Допустимо для: SocketImpl, DatagramSocketImpl

@Native static final int SO_BROADCAST

Устанавливает SO_BROADCAST для сокета. Этот параметр включает и выключает возможность процесса отправлять широковещательные сообщения. Поддерживается только для датаграммных сокетов и только в сетях, которые поддерживают концепцию широковещательных сообщений (например, Ethernet, Token Ring и т. д.), и по умолчанию установлен для DatagramSockets.

@Native static final int IP_MULTICAST_IF

Указывает выходной интерфейс для отправки мультимедийных пакетов. Полезно на хостах с несколькими сетевыми интерфейсами, когда приложения хотят использовать не системный интерфейс по умолчанию. Принимает/возвращает InetAddress.

Допустимо для мультимедийного: DatagramSocketImpl

@Native static final int IP_MULTICAST_IF2

То же самое, что и выше. Этот параметр введен для сохранения поведения с IP_MULTICAST_IF таким же, как и раньше, в то время как этот новый параметр может поддерживать установку выходных интерфейсов с адресами IPv4 и IPv6. ПРИМЕЧАНИЕ: убедитесь, что нет конфликта с этим.

@Native static final int IP_MULTICAST_LOOP

Этот параметр включает или отключает локальную петлю обратной связи для мультимедийных датаграмм. Этот параметр включен по умолчанию для мультимедийных сокетов.

@Native static final int IP_TOS

Этот параметр устанавливает поле типа обслуживания или класса трафика в заголовке IP для сокета TCP или UDP.

@Native static final int SO_LINGER

Указать таймаут ожидания при закрытии. Этот параметр отключает/включает немедленный возврат из метода close() сокета TCP. Включение этого параметра с ненулевым целым значением timeout означает, что close() будет блокироваться до тех пор, пока не будут переданы и подтверждены все данные, отправленные собеседнику, после чего сокет будет закрыт корректно. После истечения таймаута ожидания сокет закрывается принудительно с TCP RST. Включение параметра с таймаутом 0 выполняет принудительное закрытие немедленно. Если заданное значение таймаута превышает 65 535, оно будет уменьшено до 65 535.

Допустимо только для TCP: SocketImpl

@Native static final int SO_TIMEOUT

Установить таймаут для блокирующих операций сокета:

 ServerSocket.accept();
 SocketInputStream.read();
 DatagramSocket.receive();
 

Параметр должен быть установлен перед входом в блокирующую операцию, чтобы он вступил в силу. Если таймаут истекает и операция по-прежнему будет блокироваться, возникает исключение java.io.InterruptedIOException. Сокет в этом случае не закрывается.

Допустимо для всех сокетов: SocketImpl, DatagramSocketImpl

@Native static final int SO_SNDBUF

Указать предпочтительный размер буферов, используемых платформой для исходящего сетевого ввода/вывода. При установке — это предложение ядру от приложения о размере буферов для отправляемых данных. При получении — это размер буфера, фактически используемого платформой при отправке данных по этому сокету. Допустимо для всех сокетов: SocketImpl, DatagramSocketImpl

@Native static final int SO_RCVBUF

Указать предпочтительный размер буферов, используемых платформой для входящего сетевого ввода/вывода. При установке — это предложение ядру от приложения о размере буферов для принимаемых данных. При получении — это размер буфера, фактически используемого платформой при приеме данных по этому сокету. Допустимо для всех сокетов: SocketImpl, DatagramSocketImpl

@Native static final int SO_KEEPALIVE

Если для сокета TCP установлено значение keepalive и в течение 2 часов (ПРИМЕЧАНИЕ: фактическое значение зависит от реализации) по сокету не было обмена данными в обоих направлениях, TCP автоматически отправляет запрос keepalive своему партнёру. Этот запрос — это сегмент TCP, на который партнёр должен ответить. Ожидается один из трёх ответов: 1. Партнёр отвечает ожидаемым ACK. Приложение не уведомляется (поскольку всё в порядке). TCP отправит другой запрос после ещё 2 часов бездействия. 2. Партнёр отвечает RST, что сообщает локальному TCP о сбою и перезагрузке хоста партнёра. Сокет закрывается. 3. От партнёра нет ответа. Сокет закрывается. Цель этого параметра — определить, не произошёл ли сбой на хосте партнёра. Действительно только для сокета TCP: SocketImpl

@Native static final int SO_OOBINLINE

Когда установлен параметр OOBINLINE, любые срочные данные TCP, полученные по сокету, будут получены через входной поток сокета. При отключенном параметре (что является значением по умолчанию) срочные данные молча игнорируются.

void setOption(int optID, Object value) throws SocketException

Включить/выключить параметр, указанный в optID. Если параметр должен быть включён и требует специфического для параметра "значения", это значение передаётся в value. Фактический тип значения специфичен для параметра, и ошибка передавать что-либо, что не имеет ожидаемого типа:

 SocketImpl s;
 ...
 s.setOption(SO_LINGER, new Integer(10));
    // OK - set SO_LINGER w/ timeout of 10 sec.
 s.setOption(SO_LINGER, new Double(10));
    // ERROR - expects java.lang.Integer

Если запрашиваемый параметр является двоичным, его можно установить с помощью этого метода, используя java.lang.Boolean:

 s.setOption(TCP_NODELAY, Boolean.TRUE);
    // OK - enables TCP_NODELAY, a binary option
 

Любой параметр можно отключить с помощью этого метода с помощью Boolean.FALSE:

 s.setOption(TCP_NODELAY, Boolean.FALSE);
    // OK - disables TCP_NODELAY
 s.setOption(SO_LINGER, Boolean.FALSE);
    // OK - disables SO_LINGER
 

Для параметра, имеющего понятие включения и выключения и требующего параметра, отличного от булевого, установка его значения на что-либо, кроме Boolean.FALSE, неявно включает его.
Выбрасывает SocketException, если параметр не распознан, сокет закрыт или произошла ошибка низкого уровня

Object getOption(int optID) throws SocketException

Получить значение параметра. Двоичные параметры вернут java.lang.Boolean.TRUE, если включены, и java.lang.Boolean.FALSE, если отключены, например:

 SocketImpl s;
 ...
 Boolean noDelay = (Boolean)(s.getOption(TCP_NODELAY));
 if (noDelay.booleanValue()) {
     // true if TCP_NODELAY is enabled...
 ...
 }
 

Для параметров, которые принимают определённый тип в качестве параметра, getOption(int) вернёт значение параметра, иначе вернёт java.lang.Boolean.FALSE:

 Object o = s.getOption(SO_LINGER);
 if (o instanceof Integer) {
     System.out.print("Linger time is " + ((Integer)o).intValue());
 } else {
   // the true type of o is java.lang.Boolean.FALSE;
 }