dart:io

Класс RawSecureSocket

RawSecureSocket обеспечивает безопасное (SSL или TLS) сетевое соединение.

Клиентские соединения с сервером создаются вызовом RawSecureSocket.connect. Защищённый сервер, созданный с помощью RawSecureServerSocket, также возвращает объекты RawSecureSocket, представляющие серверную сторону защищённого соединения. Сертификат, предоставленный сервером, проверяется с использованием доверенных сертификатов, заданных в объекте SecurityContext. Объект SecurityContext по умолчанию содержит встроенный набор доверенных корневых сертификатов известных центров сертификации.

Реализуемые типы

• RawSocket

Конструкторы

RawSecureSocket()

Свойства

address → InternetAddress

только чтение, унаследовано

InternetAddress, используемый для подключения этого сокета.

first → Future<RawSocketEvent>

только чтение, унаследовано

Первый элемент этого потока.

hashCode → int

только чтение, унаследовано

Хеш-код этого объекта.

isBroadcast → bool

только чтение, унаследовано

Является ли этот поток широковещательным.

isEmpty → Future<bool>

только чтение, унаследовано

Содержит ли этот поток какие-либо элементы.

last → Future<RawSocketEvent>

только чтение, унаследовано

Последний элемент этого потока.

length → Future<int>

только чтение, унаследовано

Количество элементов в этом потоке.

peerCertificate → X509Certificate?

только чтение

Получает сертификат удалённого узла для подключённого RawSecureSocket. Если этот RawSecureSocket является серверной стороной защищённого соединения сокета, peerCertificate возвращает сертификат клиента или null, если сертификат клиента не был получен. Если это клиентская сторона, peerCertificate возвращает сертификат сервера.

port → int

только чтение, унаследовано

Порт, используемый этим сокетом.

readEventsEnabled ↔ bool

чтение / запись, унаследовано

Задаёт или возвращает, должен ли RawSocket прослушивать события RawSocketEvent.read. Значение по умолчанию — true.

remoteAddress → InternetAddress

только чтение, унаследовано

Удалённый InternetAddress, к которому подключён этот сокет.

remotePort → int

только чтение, унаследовано

Удалённый порт, к которому подключён этот сокет.

runtimeType → Type

только чтение, унаследовано

Представление типа объекта во время выполнения.

selectedProtocol → String?

только чтение

Протокол, выбранный во время согласования протокола.

single → Future<RawSocketEvent>

только чтение, унаследовано

Единственный элемент этого потока.

writeEventsEnabled ↔ bool

чтение / запись, унаследовано

Задаёт или возвращает, должен ли RawSocket прослушивать события RawSocketEvent.write. Значение по умолчанию — true. Это одноразовый обработчик, и для получения следующего события записи необходимо снова установить writeEventsEnabled в true.

Методы

any(bool test(RawSocketEvent element)) → Future<bool>

унаследовано

Проверяет, принимает ли test какой-либо элемент, предоставленный этим потоком.

asBroadcastStream({void onListen(StreamSubscription<RawSocketEvent> subscription)?, void onCancel(StreamSubscription<RawSocketEvent> subscription)?}) → Stream<RawSocketEvent>

унаследовано

Возвращает поток с несколькими подписками, создающий те же события, что и этот поток.

asyncExpand<E>(Stream<E>? convert(RawSocketEvent event)) → Stream<E>

унаследовано

Преобразует каждый элемент в последовательность асинхронных событий.

asyncMap<E>(FutureOr<E> convert(RawSocketEvent event)) → Stream<E>

унаследовано

Создаёт новый поток, асинхронно преобразуя каждое событие данных этого потока в новое событие.

available() → int

унаследовано

Количество полученных, но ещё не прочитанных байтов в сокете, доступных для чтения.

cast<R>() → Stream<R>

унаследовано

Адаптирует этот поток к Stream<R>.

close() → Future<RawSocket>

унаследовано

Закрывает сокет.

contains(Object? needle) → Future<bool>

унаследовано

Возвращает, встречается ли needle среди элементов, предоставленных этим потоком.

distinct([bool equals(RawSocketEvent previous, RawSocketEvent next)?]) → Stream<RawSocketEvent>

унаследовано

Пропускает события данных, если они равны предыдущему событию данных.

drain<E>([E? futureValue]) → Future<E>

унаследовано

Отбрасывает все данные этого потока, но сообщает о его завершении или возникновении ошибки.

elementAt(int index) → Future<RawSocketEvent>

унаследовано

Возвращает значение события данных этого потока с индексом index.

every(bool test(RawSocketEvent element)) → Future<bool>

унаследовано

Проверяет, принимает ли test все элементы, предоставленные этим потоком.

expand<S>(Iterable<S> convert(RawSocketEvent element)) → Stream<S>

унаследовано

Преобразует каждый элемент этого потока в последовательность элементов.

firstWhere(bool test(RawSocketEvent element), {RawSocketEvent orElse()?}) → Future<RawSocketEvent>

унаследовано

Находит первый элемент этого потока, соответствующий test.

fold<S>(S initialValue, S combine(S previous, RawSocketEvent element)) → Future<S>

унаследовано

Объединяет последовательность значений, многократно применяя combine.

forEach(void action(RawSocketEvent element)) → Future

унаследовано

Выполняет action для каждого элемента этого потока.

getRawOption(RawSocketOption option) → Uint8List

унаследовано

Читает низкоуровневую информацию о RawSocket.

handleError(Function onError, {bool test(dynamic error)?}) → Stream<RawSocketEvent>

унаследовано

Создаёт поток-обёртку, перехватывающий некоторые ошибки этого потока.

join([String separator = ""]) → Future<String>

унаследовано

Объединяет строковые представления элементов в одну строку.

lastWhere(bool test(RawSocketEvent element), {RawSocketEvent orElse()?}) → Future<RawSocketEvent>

унаследовано

Находит последний элемент этого потока, соответствующий test.

listen(void onData(RawSocketEvent event)?, {Function? onError, void onDone()?, bool? cancelOnError}) → StreamSubscription<RawSocketEvent>

унаследовано

Добавляет подписку на этот поток.

map<S>(S convert(RawSocketEvent event)) → Stream<S>

унаследовано

Преобразует каждый элемент этого потока в новое событие потока.

noSuchMethod(Invocation invocation) → dynamic

унаследовано

Вызывается при обращении к несуществующему методу или свойству.

pipe(StreamConsumer<RawSocketEvent> streamConsumer) → Future

унаследовано

Передаёт события этого потока в streamConsumer.

read([int? len]) → Uint8List?

унаследовано

Считывает из сокета не более len байтов.

readMessage([int? count]) → SocketMessage?

унаследовано

Считывает из сокета сообщение, содержащее не более count байтов.

reduce(RawSocketEvent combine(RawSocketEvent previous, RawSocketEvent element)) → Future<RawSocketEvent>

унаследовано

Объединяет последовательность значений, многократно применяя combine.

renegotiate({bool useSessionCache = true, bool requestClientCertificate = false, bool requireClientCertificate = false}) → void

Ничего не делает.

sendMessage(List<SocketControlMessage> controlMessages, List<int> data, [int offset = 0, int? count]) → int

унаследовано

Записывает в сокет управляющие сообщения и байты данных.

setOption(SocketOption option, bool enabled) → bool

унаследовано

Настраивает RawSocket.

setRawOption(RawSocketOption option) → void

унаследовано

Настраивает RawSocket.

shutdown(SocketDirection direction) → void

унаследовано

Завершает работу сокета в направлении direction.

singleWhere(bool test(RawSocketEvent element), {RawSocketEvent orElse()?}) → Future<RawSocketEvent>

унаследовано

Находит единственный элемент этого потока, соответствующий test.

skip(int count) → Stream<RawSocketEvent>

унаследовано

Пропускает первые count событий данных этого потока.

skipWhile(bool test(RawSocketEvent element)) → Stream<RawSocketEvent>

унаследовано

Пропускает события данных этого потока, пока они соответствуют test.

take(int count) → Stream<RawSocketEvent>

унаследовано

Предоставляет не более первых count событий данных этого потока.

takeWhile(bool test(RawSocketEvent element)) → Stream<RawSocketEvent>

унаследовано

Передаёт события данных, пока test выполняется успешно.

timeout(Duration timeLimit, {void onTimeout(EventSink<RawSocketEvent> sink)?}) → Stream<RawSocketEvent>

унаследовано

Создаёт новый поток с теми же событиями, что и этот поток.

toList() → Future<List<RawSocketEvent>>

унаследовано

Собирает все элементы этого потока в List.

toSet() → Future<Set<RawSocketEvent>>

унаследовано

Собирает данные этого потока в Set.

toString() → String

унаследовано

Строковое представление этого объекта.

transform<S>(StreamTransformer<RawSocketEvent, S> streamTransformer) → Stream<S>

унаследовано

Применяет streamTransformer к этому потоку.

where(bool test(RawSocketEvent event)) → Stream<RawSocketEvent>

унаследовано

Создаёт из этого потока новый поток, отбрасывающий некоторые элементы.

write(List<int> buffer, [int offset = 0, int? count]) → int

унаследовано

Записывает в сокет не более count байтов буфера, начиная со смещения offset в буфере.

Операторы

operator ==(Object other) → bool

унаследовано

Оператор равенства.

Статические методы

connect(dynamic host, int port, {SecurityContext? context, bool onBadCertificate(X509Certificate certificate)?, void keyLog(String line)?, List<String>? supportedProtocols, Duration? timeout}) → Future<RawSecureSocket>

переопределено

Создаёт новый защищённый клиентский сокет и подключает его к указанному узлу через указанный порт.

secure(RawSocket socket, {StreamSubscription<RawSocketEvent>? subscription, dynamic host, SecurityContext? context, bool onBadCertificate(X509Certificate certificate)?, void keyLog(String line)?, List<String>? supportedProtocols}) → Future<RawSecureSocket>

Инициирует TLS для существующего соединения.

secureServer(RawSocket socket, SecurityContext? context, {StreamSubscription<RawSocketEvent>? subscription, List<int>? bufferedData, bool requestClientCertificate = false, bool requireClientCertificate = false, List<String>? supportedProtocols}) → Future<RawSecureSocket>

Инициирует TLS для существующего серверного соединения.

startConnect(dynamic host, int port, {SecurityContext? context, bool onBadCertificate(X509Certificate certificate)?, void keyLog(String line)?, List<String>? supportedProtocols}) → Future<ConnectionTask<RawSecureSocket>>

переопределено

Как и connect, но возвращает Future, который завершается объектом ConnectionTask, отменяемым, если RawSecureSocket больше не нужен.