SocketOptions (Платформа Java SE 7)

Все Известные Классы с реализацией:

DatagramSocketImpl, SocketImpl
```
public interface SocketOptions
```
Интерфейс методов, чтобы получить/установить опции сокета. Этот интерфейс реализуется: SocketImpl и DatagramSocketImpl. Подклассы их должны переопределить методы этого интерфейса, чтобы поддерживать их собственные опции.
Методы и константы, которые определяют опции в этом интерфейсе, для реализации только. Если Вы не разделите на подклассы SocketImpl или DatagramSocketImpl, то Вы не будете использовать их непосредственно. Есть безопасные с точки зрения типов методы, чтобы получить/установить каждую из этих опций в Сокете, ServerSocket, DatagramSocket и MulticastSocket.

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static int`	`IP_MULTICAST_IF` Набор, который исходящий интерфейс, в котором можно отправить многоадресные пакеты.
`static int`	`IP_MULTICAST_IF2` То же самое как выше.
`static int`	`IP_MULTICAST_LOOP` Эта опция включает или отключает локальную обратную петлю многоадресных дейтаграмм.
`static int`	`IP_TOS` Эта опция устанавливает тип службы или поле класса трафика в заголовке IP для сокета UDP или TCP.
`static int`	`SO_BINDADDR` Выберите локальную привязку адреса сокета (эта опция не может быть "установлена" только "полученная", так как сокеты связываются во время создания, и таким образом, локально связанный адрес не может быть изменен).
`static int`	`SO_BROADCAST` Наборы SO_BROADCAST для сокета.
`static int`	`SO_KEEPALIVE` Когда keepalive опция устанавливается для сокета TCP, и никакие данные не передавались через сокет ни в одном направлении в течение 2 часов (ПРИМЕЧАНИЕ: фактическое значение является зависящим от реализации), TCP автоматически отправляет зонд keepalive коллеге.
`static int`	`SO_LINGER` Определите, что тайм-аут "задерживается на завершении".
`static int`	`SO_OOBINLINE` Когда опция OOBINLINE будет установлена, любой TCP, срочные данные, полученные на сокете, будут получены через входной поток сокета.
`static int`	`SO_RCVBUF` Установите подсказку размер базовых буферов, используемых платформой для входящего сетевого ввода-вывода.
`static int`	`SO_REUSEADDR` Наборы SO_REUSEADDR для сокета.
`static int`	`SO_SNDBUF` Установите подсказку размер базовых буферов, используемых платформой для исходящего сетевого ввода-вывода.
`static int`	`SO_TIMEOUT` Установите тайм-аут при блокировании операций Сокета:
`static int`	`TCP_NODELAY` Отключите алгоритм Нэйгла для этого соединения.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`Объект`	`getOption(int optID)` Выберите значение опции.
`void`	`setOption(int optID, Object value)` Позвольте/отключите опции, определенной optID.

- Полевая Деталь
  - TCP_NODELAY
```
static final int TCP_NODELAY
```
    Отключите алгоритм Нэйгла для этого соединения. Записанные данные к сети не буферизуются подтверждение на ожидании ранее записанных данных.
    Допустимый для TCP только: SocketImpl.
    
    См. Также:
    Socket.setTcpNoDelay(boolean), Socket.getTcpNoDelay(), Постоянные Значения полей
  - SO_BINDADDR
```
static final int SO_BINDADDR
```
    Выберите локальную привязку адреса сокета (эта опция не может быть "установлена" только "полученная", так как сокеты связываются во время создания, и таким образом, локально связанный адрес не может быть изменен). Локальный адрес по умолчанию сокета является INADDR_ANY, означая любой локальный адрес на многосетевом узле. Многосетевой узел может использовать эту опцию, чтобы принять соединения с только одним из ее адресов (в случае ServerSocket или DatagramSocket), или определить ее обратный адрес к коллеге (для Сокета или DatagramSocket). Параметром этой опции является InetAddress.
    Эта опция должна быть определена в конструкторе.
    Допустимый для: SocketImpl, DatagramSocketImpl
    
    См. Также:
    Socket.getLocalAddress(), DatagramSocket.getLocalAddress(), Постоянные Значения полей
  - SO_REUSEADDR
```
static final int SO_REUSEADDR
```
    Наборы SO_REUSEADDR для сокета. Это используется только для MulticastSockets в java, и это устанавливается по умолчанию для MulticastSockets.
    Допустимый для: DatagramSocketImpl
    
    См. Также:
    Постоянные Значения полей
  - SO_BROADCAST
```
static final int SO_BROADCAST
```
    Наборы SO_BROADCAST для сокета. Эта опция включает и отключает возможность процесса отправить широковещательные сообщения. Это поддерживается для только сокетов дейтаграммы и только в сетях, которые поддерживают понятие широковещательного сообщения (например, Ethernet, маркерное кольцо, и т.д.), и это устанавливается по умолчанию для DatagramSockets.
    
    С тех пор:
    
    1.4
    
    См. Также:
    Постоянные Значения полей
  - IP_MULTICAST_IF
```
static final int IP_MULTICAST_IF
```
    Набор, который исходящий интерфейс, в котором можно отправить многоадресные пакеты. Полезный на узлах с многократными сетевыми интерфейсами, где приложения хотят использовать кроме системного значения по умолчанию. Берет/возвращается InetAddress.
    Допустимый для Многоадресной передачи: DatagramSocketImpl
    
    См. Также:
    MulticastSocket.setInterface(InetAddress), MulticastSocket.getInterface(), Постоянные Значения полей
  - IP_MULTICAST_IF2
```
static final int IP_MULTICAST_IF2
```
    То же самое как выше. Эта опция представляется так, чтобы поведение с IP_MULTICAST_IF было сохранено тем же самым как прежде, в то время как эта новая опция может поддерживать установку, исходящую интерфейсы с любым IPv4 и адресами IPv6. ОТМЕТЬТЕ: удостоверьтесь, что нет никакого конфликта с этим
    
    С тех пор:
    
    1.4
    
    См. Также:
    MulticastSocket.setNetworkInterface(NetworkInterface), MulticastSocket.getNetworkInterface(), Постоянные Значения полей
  - IP_MULTICAST_LOOP
```
static final int IP_MULTICAST_LOOP
```
    Эта опция включает или отключает локальную обратную петлю многоадресных дейтаграмм. Эта опция включается по умолчанию для Многоадресных Сокетов.
    
    С тех пор:
    
    1.4
    
    См. Также:
    Постоянные Значения полей
  - IP_TOS
```
static final int IP_TOS
```
    Эта опция устанавливает тип службы или поле класса трафика в заголовке IP для сокета UDP или TCP.
    
    С тех пор:
    
    1.4
    
    См. Также:
    Постоянные Значения полей
  - SO_LINGER
```
static final int SO_LINGER
```
    Определите, что тайм-аут "задерживается на завершении". Эта опция непосредственный возврат disables/enables из завершения () Сокета TCP. Включение этой опции с ненулевым Целочисленным тайм-аутом означает, что завершение () блокирует ожидание передачи и подтверждения всех данных, записанных коллеге, в которой точке сокет закрывается корректно. После достижения задерживаться тайм-аута сокет закрывается сильно с TCP RST. Включение опции с тайм-аутом нуля сразу делает действительное завершение. Если указанное значение тайм-аута превысит 65 535, то оно будет уменьшено до 65 535.
    Допустимый только для TCP: SocketImpl
    
    См. Также:
    Socket.setSoLinger(boolean, int), Socket.getSoLinger(), Постоянные Значения полей
  - SO_TIMEOUT
```
static final int SO_TIMEOUT
```
    Установите тайм-аут при блокировании операций Сокета:
```
 ServerSocket.accept();
 SocketInputStream.read();
 DatagramSocket.receive();
 
```
    Опция должна быть установлена до ввода работы блокирования, чтобы вступить в силу. Если бы тайм-аут истекает, и работа продолжала бы блокировать, java.io. InterruptedIOException повышается. Сокет не закрывается в этом случае.
    Допустимый для всех сокетов: SocketImpl, DatagramSocketImpl
    См. Также:
    Socket.setSoTimeout(int), ServerSocket.setSoTimeout(int), DatagramSocket.setSoTimeout(int), Постоянные Значения полей
  - SO_SNDBUF
```
static final int SO_SNDBUF
```
    Установите подсказку размер базовых буферов, используемых платформой для исходящего сетевого ввода-вывода. Когда использующийся в наборе, это - предложение к ядру из приложения о размере буферов, чтобы использовать для данных, которые будут отправлены по сокету. Когда использующийся в добираются, это должно возвратить размер буфера, фактически используемого платформой, отсылая данные на этом сокете. Допустимый для всех сокетов: SocketImpl, DatagramSocketImpl
    
    См. Также:
    Socket.setSendBufferSize(int), Socket.getSendBufferSize(), DatagramSocket.setSendBufferSize(int), DatagramSocket.getSendBufferSize(), Постоянные Значения полей
  - SO_RCVBUF
```
static final int SO_RCVBUF
```
    Установите подсказку размер базовых буферов, используемых платформой для входящего сетевого ввода-вывода. Когда использующийся в наборе, это - предложение к ядру из приложения о размере буферов, чтобы использовать для данных, которые будут получены по сокету. Когда использующийся в добираются, это должно возвратить размер буфера, фактически используемого платформой, получая в данных на этом сокете. Допустимый для всех сокетов: SocketImpl, DatagramSocketImpl
    
    См. Также:
    Socket.setReceiveBufferSize(int), Socket.getReceiveBufferSize(), DatagramSocket.setReceiveBufferSize(int), DatagramSocket.getReceiveBufferSize(), Постоянные Значения полей
  - SO_KEEPALIVE
```
static final int SO_KEEPALIVE
```
    Когда keepalive опция устанавливается для сокета TCP, и никакие данные не передавались через сокет ни в одном направлении в течение 2 часов (ПРИМЕЧАНИЕ: фактическое значение является зависящим от реализации), TCP автоматически отправляет зонд keepalive коллеге. Этот зонд является сегментом TCP, на который должна ответить коллега. Один из трех ответов ожидается: 1. Коллега отвечает ожидаемым ACK. Приложение не уведомляется (так как все в порядке). TCP отправит другой зонд еще после 2 часов неактивности. 2. Коллега отвечает RST, который говорит локальному TCP, что равноправный узел разрушил и перезагрузил. Сокет закрывается. 3. От коллеги нет никакого ответа. Сокет закрывается. Цель этой опции состоит в том, чтобы обнаружить, если равноправный узел отказывает. Допустимый только для сокета TCP: SocketImpl
    
    См. Также:
    Socket.setKeepAlive(boolean), Socket.getKeepAlive(), Постоянные Значения полей
  - SO_OOBINLINE
```
static final int SO_OOBINLINE
```
    Когда опция OOBINLINE будет установлена, любой TCP, срочные данные, полученные на сокете, будут получены через входной поток сокета. Когда опция отключается (который является значением по умолчанию), срочные данные тихо отбрасываются.
    
    См. Также:
    Socket.setOOBInline(boolean), Socket.getOOBInline(), Постоянные Значения полей
- Деталь метода
  - setOption
```
void setOption(int optID,
             Object value)
               throws SocketException
```
    Позвольте/отключите опции, определенной optID. Если опция должна быть включена, и она принимает специфичное для опции "значение", это передают в значении. Фактический тип имеющий значение специфичен для опции, и это - ошибка передать что-то, что не имеет ожидаемого типа:
```
 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. Булевская переменная:
```
 s.setOption(TCP_NODELAY, new Boolean(true));
    // OK - enables TCP_NODELAY, a binary option
 
```
    Любая опция может быть отключена, используя этот метод с Булевской переменной (ложь):
```
 s.setOption(TCP_NODELAY, new Boolean(false));
    // OK - disables TCP_NODELAY
 s.setOption(SO_LINGER, new Boolean(false));
    // OK - disables SO_LINGER
 
```
    Для опции, которая имеет понятие на и прочь, и требует, небулев параметр, устанавливая его значение во что-либо кроме Булевской переменной (ложь) неявно включает ему.
    Произошли броски SocketException, если опция является нераспознанной, сокет, закрывается, или некоторая низкоуровневая ошибка,
    Параметры:
    optID - идентифицирует опцию
    value - параметр опции сокета
    
    Броски:
    
    SocketException - если опция является нераспознанной, сокет закрывается, или некоторая низкоуровневая ошибка произошла
    См. Также:
    getOption(int)
  - getOption
```
Object getOption(int optID)
                 throws SocketException
```
    Выберите значение опции. Двоичные опции возвратят java.lang. Булевская переменная (истина) если включено, java.lang. Булевская переменная (ложь) если отключено, например:
```
 SocketImpl s;
 ...
 Boolean noDelay = (Boolean)(s.getOption(TCP_NODELAY));
 if (noDelay.booleanValue()) {
     // true if TCP_NODELAY is enabled...
 ...
 }
 
```
    Для опций, которые берут определенный тип в качестве параметра, getOption (интервал), возвратит значение параметра, еще это возвратит java.lang. Булевская переменная (ложь):
```
 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);
 }
 
```
    Параметры:
    optID - int идентификация опции, чтобы выбрать
    
    Возвраты:
    значение опции
    
    Броски:
    
    SocketException - если сокет закрывается
    
    SocketException - если optID неизвестен вдоль стека протокола (включая SocketImpl)
    См. Также:
    setOption(int, java.lang.Object)

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный SocketOptions

Полевая Сводка

Сводка метода

Полевая Деталь

TCP_NODELAY

SO_BINDADDR

SO_REUSEADDR

SO_BROADCAST

IP_MULTICAST_IF

IP_MULTICAST_IF2

IP_MULTICAST_LOOP

IP_TOS

SO_LINGER

SO_TIMEOUT

SO_SNDBUF

SO_RCVBUF

SO_KEEPALIVE

SO_OOBINLINE

Деталь метода

setOption

getOption