Интерфейс SocketOptions

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

Методы и константы, определяющие параметры в этом интерфейсе, предназначены только для реализации. Если вы не наследуете от SocketImpl или DatagramSocketImpl, вы не будете использовать их напрямую. Существуют безопасные по типу методы для получения/установки каждого из этих параметров в Socket, ServerSocket, DatagramSocket и MulticastSocket.

Поля

TCP_NODELAY

@Native
static final int TCP_NODELAY

См. также:

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

SO_BINDADDR

@Native
static final int SO_BINDADDR

См. также:

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

SO_REUSEADDR

@Native
static final int SO_REUSEADDR

См. также:

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

SO_BROADCAST

@Native
static final int SO_BROADCAST

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

С:

1.4

См. также:

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

IP_MULTICAST_IF

@Native
static final int IP_MULTICAST_IF

См. также:

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

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

С:

1.4

См. также:

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

SO_LINGER

@Native
static final int SO_LINGER

См. также:

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

SO_TIMEOUT

@Native
static final int SO_TIMEOUT

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

См. также:

Socket.setSoTimeout(int), ServerSocket.setSoTimeout(int), DatagramSocket.setSoTimeout(int), Значения постоянных полей

SO_SNDBUF

@Native
static final int SO_SNDBUF

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

См. также:

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

SO_RCVBUF

@Native
static final int SO_RCVBUF

Установить значение размера буферов, используемых платформой для входящего сетевого ввода-вывода. При использовании в set, это рекомендация для ядра от приложения о размере буферов, используемых для получаемых данных через сокет. При использовании в get, это необходимо вернуть размер буфера, реально используемого платформой при получении данных по этому сокету. Действительно для всех сокетов: 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. Если параметр должен быть включен и для него требуется определенное значение, оно передается в 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

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

Параметры:

optID - идентифицирует параметр

value - параметр сокета

Исключения:

SocketException - если параметр неизвестен, сокет закрыт или произошла какая-либо ошибка низкого уровня

См. также:

getOption(int)

getOption

Object getOption(int optID)
          throws SocketException

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

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)