compact1, compact2, compact3

java.net

Интерфейс SocketOptions

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

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 Эта опция устанавливает тип службы или поле class трафика в заголовке 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

@Native
static final int TCP_NODELAY

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

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

См. Также:

Socket.setTcpNoDelay(boolean), Socket.getTcpNoDelay(), Постоянные Значения полей

SO_BINDADDR

@Native
static final int SO_BINDADDR

Выберите локальную привязку по адресу сокета (эта опция не может быть "установлена" только "полученная", так как сокеты связываются во время создания, и таким образом, локально связанный адрес не может быть изменен). Значение по умолчанию локальный адрес сокета является INADDR_ANY, означая любой локальный адрес на многосетевом узле. Многосетевой узел может использовать эту опцию, чтобы принять соединения с только одним из ее адресов (в случае ServerSocket или DatagramSocket), или определить ее обратный адрес к коллеге (для Сокета или DatagramSocket). Параметром этой опции является InetAddress.

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

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

См. Также:

Socket.getLocalAddress(), DatagramSocket.getLocalAddress(), Постоянные Значения полей

SO_REUSEADDR

@Native
static final int SO_REUSEADDR

Наборы SO_REUSEADDR для сокета. Это используется только для MulticastSockets в java, и это устанавливается по умолчанию для MulticastSockets.

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

См. Также:

Постоянные Значения полей

SO_BROADCAST

@Native
static final int SO_BROADCAST

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

С тех пор:

1.4

См. Также:

Постоянные Значения полей

IP_MULTICAST_IF

@Native
static final int IP_MULTICAST_IF

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

Допустимый для Многоадресной передачи: DatagramSocketImpl

См. Также:

MulticastSocket.setInterface(InetAddress), MulticastSocket.getInterface(), Постоянные Значения полей

IP_MULTICAST_IF2

@Native
static final int IP_MULTICAST_IF2

То же самое как выше. Эта опция представляется так, чтобы поведение с IP_MULTICAST_IF было сохранено тем же самым как прежде, в то время как эта новая опция может поддерживать установку, исходящую интерфейсы с любым IPv4 и адресами IPv6. ОТМЕТЬТЕ: удостоверьтесь, что нет никакого конфликта с этим

С тех пор:

1.4

См. Также:

MulticastSocket.setNetworkInterface(NetworkInterface), MulticastSocket.getNetworkInterface(), Постоянные Значения полей

IP_MULTICAST_LOOP

@Native
static final int IP_MULTICAST_LOOP

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

С тех пор:

1.4

См. Также:

Постоянные Значения полей

IP_TOS

@Native
static final int IP_TOS

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

С тех пор:

1.4

См. Также:

Постоянные Значения полей

SO_LINGER

@Native
static final int SO_LINGER

Определите, что тайм-аут "задерживается на завершении". Эта опция непосредственный возврат disables/enables из завершения () Сокета TCP. Включение этой опции с ненулевым Целочисленным тайм-аутом означает, что завершение () блокирует ожидание передачи и подтверждения всех данных, записанных коллеге, в которой точке сокет закрывается корректно. После достижения задерживаться тайм-аута сокет закрывается сильно с TCP RST. Включение опции с тайм-аутом нуля сразу делает действительное завершение. Если указанное значение тайм-аута превысит 65 535, то оно будет уменьшено до 65 535.

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

См. Также:

Socket.setSoLinger(boolean, int), Socket.getSoLinger(), Постоянные Значения полей

SO_TIMEOUT

@Native
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

@Native
static final int SO_SNDBUF

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

См. Также:

Socket.setSendBufferSize(int), Socket.getSendBufferSize(), DatagramSocket.setSendBufferSize(int), DatagramSocket.getSendBufferSize(), Постоянные Значения полей

SO_RCVBUF

@Native
static final int SO_RCVBUF

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

См. Также:

Socket.setReceiveBufferSize(int), Socket.getReceiveBufferSize(), DatagramSocket.setReceiveBufferSize(int), DatagramSocket.getReceiveBufferSize(), Постоянные Значения полей

SO_KEEPALIVE

@Native
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

@Native
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)