4.3 KiB
Vendored
id, sidebar_class_name, keywords
| id | sidebar_class_name | keywords | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| TCP | TCP |
|
<img src={require('../../static/img/APIs/TCP.png').default} width='64px' />
TCP (Клиент)
Этот раздел посвящен библиотеке для работы с протоколом TCP в 1С:Предприятие, OneScript и CLI. На данной странице описаны все действия, необходимые для полноценного начала работы
<img src={require('../../static/img/addin.png').default} class="tipimage" />
Пожалуйста, ознакомьтесь с разделом ["О внешних компонентах"](/docs/Start/Component-requirements) перед началом работы
<img src={require('../../static/img/lock.png').default} class="tipimage" />
Узнать больше: "Об использовании OpenSSL во внешних компонентах"
О реализованных методах
Данная библиотека предоставляет несколько готовых методов для работы в качестве TCP клиента. Стандартная схема взаимодействия с сервером выглядит следующим образом:
1. Создание объекта и подключение к серверу производится при помощи функции `ОткрытьСоединение`. Туда передается строка подключения в формате `<адрес>:<порт>`
2. При необходимости, серверу можно отправить сообщение при помощи функций `ОтправитьДвоичныеДанные` и `ОтправитСтроку`
3. Для получения данных от сервера, используются функции `ПрочитатьДвоичныеДанные` и `ПрочитатьСтроку`. Они имеют различные параметры для ограничения получаемых данных по размеру, маркеру и ожиданию ввода (таймауту)
4. При окончании работы желательно явно завершать соединение при помощи функции `ЗакрытьСоединение`
Для простого сценария со стандартными настройками, также существует функция ОбработатьЗапрос - она отправляет данные на указанный адрес и ждет ответа, завершая чтение при нахождении стандартного маркера \\n. Также это единственная функция, которая доступна в CLI версии ОПИ
TLS
Библиотека поддерживает работу в режиме TLS. Для его включения необходимо сформировать настройки TLS при помощи функции ПолучитьНастройкиTls, и передать их как соответствующий параметр в функцию ОткрытьСоединение или ОбработатьЗапрос. Если параметр TLS при вызове этих функций не передан, соединение инициализируется в незащищенном режиме