Класс SocketImpl
- Все реализуемые интерфейсы:
SocketOptions
public abstract class SocketImpl extends Object implements SocketOptions
SocketImpl является общим суперклассом всех классов, которые непосредственно реализуют сокеты. Он используется для создания как клиентских, так и серверных сокетов.- Начиная с:
- 1.0
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
protected InetAddress |
address |
IP-адрес удалённого конца этого сокета. |
protected FileDescriptor |
fd |
Объект файлового дескриптора для этого сокета. |
protected int |
localport |
Локальный номер порта, к которому подключён этот сокет. |
protected int |
port |
Номер порта на удалённом хосте, к которому подключён этот сокет. |
Поля, объявленные в интерфейсе SocketOptions
IP_MULTICAST_IF, IP_MULTICAST_IF2, IP_MULTICAST_LOOP, IP_TOS, SO_BINDADDR, SO_BROADCAST, SO_KEEPALIVE, SO_LINGER, SO_OOBINLINE, SO_RCVBUF, SO_REUSEADDR, SO_REUSEPORT, SO_SNDBUF, SO_TIMEOUT, TCP_NODELAY
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
SocketImpl() |
Инициализирует новый экземпляр этого класса |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
protected abstract void |
accept |
Принимает соединение. |
protected abstract int |
available() |
Возвращает количество байтов, которые можно прочитать из этого сокета без блокировки. |
protected abstract void |
bind |
Привязывает этот сокет к указанному локальному IP-адресу и номеру порта. |
protected abstract void |
close() |
Закрывает этот сокет. |
protected abstract void |
connect |
Подключает этот сокет к указанному порту на хосте с заданным именем. |
protected abstract void |
connect |
Подключает этот сокет к указанному номеру порта на указанном хосте. |
protected abstract void |
connect |
Подключает этот сокет к указанному номеру порта на указанном хосте. |
protected abstract void |
create |
Создаёт потоковый сокет. |
protected FileDescriptor |
getFileDescriptor() |
Возвращает значение поля fd этого сокета. |
protected InetAddress |
getInetAddress() |
Возвращает значение поля address этого сокета. |
protected abstract InputStream |
getInputStream() |
Возвращает входной поток для этого сокета. |
protected int |
getLocalPort() |
Возвращает значение поля localport этого сокета. |
protected <T> T |
getOption |
Вызывается для получения параметра сокета. |
protected abstract OutputStream |
getOutputStream() |
Возвращает выходной поток для этого сокета. |
protected int |
getPort() |
Возвращает значение поля port этого сокета. |
protected abstract void |
listen |
Устанавливает максимальную длину очереди для поступающих запросов на соединение (запросов на подключение) равной значению аргумента count. |
protected abstract void |
sendUrgentData |
Отправляет один байт срочных данных через сокет. |
protected <T> void |
setOption |
Вызывается для установки параметра сокета. |
protected void |
setPerformancePreferences |
Задаёт предпочтения производительности для этого сокета. |
protected void |
shutdownInput() |
Переводит входной поток этого сокета в состояние «конец потока». |
protected void |
shutdownOutput() |
Отключает выходной поток этого сокета. |
protected Set |
supportedOptions() |
Возвращает набор SocketOptions, поддерживаемых этой реализацией и её сокетом (Socket или ServerSocket) |
protected boolean |
supportsUrgentData() |
Возвращает, поддерживает ли эта реализация SocketImpl отправку срочных данных. |
String |
toString() |
Возвращает адрес и порт этого сокета в виде String. |
Методы, объявленные в классе Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Методы, объявленные в интерфейсе SocketOptions
getOption, setOption
Подробное описание полей
fd
protected FileDescriptor fd
address
protected InetAddress address
port
protected int port
localport
protected int localport
Подробное описание конструкторов
SocketImpl
public SocketImpl()
Подробное описание методов
create
protected abstract void create(boolean stream) throws IOException
- Примечание API:
- Параметр
streamв ранних выпусках JDK предоставлял возможность создатьSocket, использующий датаграммный сокет. API Socket больше не предоставляет такой возможности, поэтому методcreateвсегда будет вызываться со значениемstream, равнымtrue. - Параметры:
-
stream— должен иметь значениеtrue. - Исключения:
-
IOException— если при создании сокета произошла ошибка ввода-вывода.
connect
protected abstract void connect(String host, int port) throws IOException
- Параметры:
-
host— имя удалённого хоста. -
port— номер порта. - Исключения:
-
IOException— если при подключении к удалённому хосту произошла ошибка ввода-вывода.
connect
protected abstract void connect(InetAddress address, int port) throws IOException
- Параметры:
-
address— IP-адрес удалённого хоста. -
port— номер порта. - Исключения:
-
IOException— если при попытке подключения произошла ошибка ввода-вывода.
connect
protected abstract void connect(SocketAddress address, int timeout) throws IOException
- Параметры:
-
address— адрес сокета удалённого хоста. -
timeout— время ожидания в миллисекундах или ноль, если время ожидания не ограничено. - Исключения:
-
IOException— если при попытке подключения произошла ошибка ввода-вывода. - Начиная с:
- 1.4
bind
protected abstract void bind(InetAddress host, int port) throws IOException
- Параметры:
-
host— IP-адрес, принадлежащий локальному интерфейсу. -
port— номер порта. - Исключения:
-
IOException— если при привязке этого сокета произошла ошибка ввода-вывода.
listen
protected abstract void listen(int backlog) throws IOException
count. Если запрос на соединение поступает при заполненной очереди, в соединении будет отказано.- Параметры:
-
backlog— максимальная длина очереди. - Исключения:
-
IOException— если при создании очереди произошла ошибка ввода-вывода.
accept
protected abstract void accept(SocketImpl s) throws IOException
- Параметры:
-
s— принятое соединение. - Исключения:
-
IOException— если при принятии соединения произошла ошибка ввода-вывода.
getInputStream
protected abstract InputStream getInputStream() throws IOException
- Возвращает:
- поток для чтения из этого сокета.
- Исключения:
-
IOException— если при создании входного потока произошла ошибка ввода-вывода.
getOutputStream
protected abstract OutputStream getOutputStream() throws IOException
- Возвращает:
- выходной поток для записи в этот сокет.
- Исключения:
-
IOException— если при создании выходного потока произошла ошибка ввода-вывода.
available
protected abstract int available() throws IOException
- Возвращает:
- количество байтов, которые можно прочитать из этого сокета без блокировки.
- Исключения:
-
IOException— если при определении количества доступных байтов произошла ошибка ввода-вывода.
close
protected abstract void close() throws IOException
- Исключения:
-
IOException— если при закрытии этого сокета произошла ошибка ввода-вывода.
shutdownInput
protected void shutdownInput() throws IOException
available этого потока вернёт 0, а его методы read вернут -1 (конец потока).- Исключения:
-
IOException— если при отключении этого сокета произошла ошибка ввода-вывода. - Начиная с:
- 1.3
- См. также:
shutdownOutput
protected void shutdownOutput() throws IOException
- Исключения:
-
IOException— если при отключении этого сокета произошла ошибка ввода-вывода. - Начиная с:
- 1.3
- См. также:
getFileDescriptor
protected FileDescriptor getFileDescriptor()
fd этого сокета.- Возвращает:
- значение поля
fdэтого сокета. - См. также:
getInetAddress
protected InetAddress getInetAddress()
address этого сокета.- Возвращает:
- значение поля
addressэтого сокета. - См. также:
getPort
protected int getPort()
port этого сокета.- Возвращает:
- значение поля
portэтого сокета. - См. также:
supportsUrgentData
protected boolean supportsUrgentData()
- Возвращает:
- true, если срочные данные поддерживаются
- Начиная с:
- 1.4
- См. также:
sendUrgentData
protected abstract void sendUrgentData(int data) throws IOException
- Параметры:
-
data— отправляемый байт данных - Исключения:
-
IOException— если при отправке данных произошла ошибка. - Начиная с:
- 1.4
getLocalPort
protected int getLocalPort()
localport этого сокета.- Возвращает:
- значение поля
localportэтого сокета. - См. также:
toString
setPerformancePreferences
protected void setPerformancePreferences(int connectionTime, int latency, int bandwidth)
По умолчанию сокеты используют протокол TCP/IP. Некоторые реализации могут предоставлять альтернативные протоколы с характеристиками производительности, отличающимися от TCP/IP. Этот метод позволяет приложению выразить собственные предпочтения относительно того, как следует учитывать эти компромиссы при выборе реализацией одного из доступных протоколов.
Предпочтения производительности задаются тремя целыми числами, значения которых указывают относительную важность короткого времени установления соединения, низкой задержки и высокой пропускной способности. Абсолютные значения целых чисел не имеют значения; при выборе протокола сравниваются только сами значения: чем больше значение, тем выше соответствующее предпочтение. Отрицательные значения обозначают более низкий приоритет, чем положительные. Например, если приложение предпочитает короткое время установления соединения низкой задержке и высокой пропускной способности, оно может вызвать этот метод со значениями (1, 0, 0). Если приложение предпочитает высокую пропускную способность низкой задержке, а низкую задержку — короткому времени установления соединения, оно может вызвать этот метод со значениями (0, 1, 2). По умолчанию этот метод ничего не делает, если он не переопределён в подклассе.
- Параметры:
-
connectionTime—int, выражающий относительную важность короткого времени установления соединения -
latency—int, выражающий относительную важность низкой задержки -
bandwidth—int, выражающий относительную важность высокой пропускной способности - Начиная с:
- 1.5
setOption
protected <T> void setOption(SocketOption<T> name, T value) throws IOException
- Требования к реализации:
- Реализация этого метода по умолчанию сначала проверяет, что заданный параметр сокета
nameне равен null, а затем выбрасываетUnsupportedOperationException. Подклассам следует переопределить этот метод, предоставив подходящую реализацию. - Параметры типа:
T— тип значения параметра сокета- Параметры:
-
name— параметр сокета -
value— значение параметра сокета. Для некоторых параметров допустимо значениеnull. - Исключения:
-
UnsupportedOperationException— если SocketImpl не поддерживает этот параметр -
IllegalArgumentException— если значение недопустимо для этого параметра -
IOException— если произошла ошибка ввода-вывода или сокет закрыт -
NullPointerException— если имя равноnull - Начиная с:
- 9
getOption
protected <T> T getOption(SocketOption<T> name) throws IOException
- Требования к реализации:
- Реализация этого метода по умолчанию сначала проверяет, что заданный параметр сокета
nameне равен null, а затем выбрасываетUnsupportedOperationException. Подклассам следует переопределить этот метод, предоставив подходящую реализацию. - Параметры типа:
T— тип значения параметра сокета- Параметры:
-
name— параметр сокета - Возвращает:
- значение указанного параметра
- Исключения:
-
UnsupportedOperationException— если SocketImpl не поддерживает этот параметр -
IOException— если произошла ошибка ввода-вывода или сокет закрыт -
NullPointerException— если имя равноnull - Начиная с:
- 9
supportedOptions
protected Set<SocketOption<?>> supportedOptions()
- Требования к реализации:
- Реализация этого метода по умолчанию возвращает пустой набор. Подклассам следует переопределить этот метод, предоставив подходящую реализацию.
- Возвращает:
- набор SocketOptions
- Начиная с:
- 9
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/net/SocketImpl.html