Main build (Jenkins)

ci/clitesten

@@ -1924,7 +1924,7 @@ def test_tcp(){
 					
 
                catchError(buildResult: 'FAILURE', stageResult: 'FAILURE') {   
-					powershell encoding: 'UTF-8', script:'./oint.exe tcp ConnectAndReceiveData --address "test" --ssl "test" --timeout "test" --size "test" --string "test" --enc "test" --debug --test '
+					powershell encoding: 'UTF-8', script:'./oint.exe tcp ConnectAndReceiveData --address "test" --ssl "test" --timeout "test" --attempts "test" --size "test" --string "test" --enc "test" --debug --test '
                }
 
 }

ci/clitestru

@@ -1924,7 +1924,7 @@ def test_tcp(){
 					
 
                catchError(buildResult: 'FAILURE', stageResult: 'FAILURE') {   
-					powershell encoding: 'UTF-8', script:'./oint.exe tcp ПодключитьсяИПолучитьДанные --address "test" --ssl "test" --timeout "test" --size "test" --string "test" --enc "test" --debug --test '
+					powershell encoding: 'UTF-8', script:'./oint.exe tcp ПодключитьсяИПолучитьДанные --address "test" --ssl "test" --timeout "test" --attempts "test" --size "test" --string "test" --enc "test" --debug --test '
                }
 
 }

docs/en/md/TCP/Tcp-client/Connect-and-receive-data.mdx

@@ -10,14 +10,15 @@ import TabItem from '@theme/TabItem';
 
 
 
-`Function ConnectAndReceiveData(Val Address, Val SSL = False, Val Timeout = 0, Val Size = 0, Val AsString = True, Val Encoding = "UTF-8") Export`
+`Function ConnectAndReceiveData(Val Address, Val SSL = False, Val AttemptDuration = 0, Val Attempts = 5, Val MaxSize = 0, Val AsString = True, Val Encoding = "UTF-8") Export`
 
   | Parameter | CLI option | Type | Required | Description |
   |-|-|-|-|-|
   | Address | --address | String | ✔ | Address and port |
   | SSL | --ssl | Boolean | ✖ | Flag for using a secure connection |
-  | Timeout | --timeout | Number | ✖ | Data reading time (sec). 0 > until the end of the message |
+  | AttemptDuration | --timeout | Number | ✖ | Interval between data retrieval attempts |
-  | Size | --size | Number | ✖ | Maximum data size. 0 > no limit |
+  | Attempts | --attempts | Number | ✖ | Max number of data retrieval attempts |
+  | MaxSize | --size | Number | ✖ | Maximum data size. 0 > no limit |
   | AsString | --string | Boolean | ✖ | True > returns string, False > binary data |
   | Encoding | --enc | String | ✖ | Encoding of received data |
 
@@ -27,7 +28,9 @@ import TabItem from '@theme/TabItem';
 <br/>
 
 :::tip
-When the Timeout and Size parameters are set to 0, reading is performed until the message ends
+The method tries to read the data in intervals, the duration of which is specified in the AttemptDuration parameter. The Attempts parameter is responsible for the maximum number of attempts. If the new data is successfully received, the number of attempts is reset.
+
+When working with an infinite stream of incoming data, it is obligatory to specify the MaxSize parameter, because infinite resetting of attempts when receiving data can lead to hangs
 :::
 <br/>
 

docs/ru/md/TCP/Tcp-client/Connect-and-receive-data.mdx

@@ -10,14 +10,15 @@ import TabItem from '@theme/TabItem';
 
 
 
-`Функция ПодключитьсяИПолучитьДанные(Знач Адрес, Знач SSL = Ложь, Знач Таймаут = 0, Знач Размер = 0, Знач Строкой = Истина, Знач Кодировка = "UTF-8") Экспорт`
+`Функция ПодключитьсяИПолучитьДанные(Знач Адрес, Знач SSL = Ложь, Знач ДлительностьПопытки = 0, Знач ЧислоПопыток = 5, Знач МаксимальныйРазмер = 0, Знач Строкой = Истина, Знач Кодировка = "UTF-8") Экспорт`
 
   | Параметр | CLI опция | Тип | Обяз. | Назначение |
   |-|-|-|-|-|
   | Адрес | --address | Строка | ✔ | Адрес и порт для подключения |
   | SSL | --ssl | Булево | ✖ | Признак использования защищенного соединения |
-  | Таймаут | --timeout | Число | ✖ | Время чтения данных (сек). 0 > до конца сообщения |
+  | ДлительностьПопытки | --timeout | Число | ✖ | Интервал между попытками получения данных |
-  | Размер | --size | Число | ✖ | Максимальный размер данных. 0 > без ограничений |
+  | ЧислоПопыток | --attempts | Число | ✖ | Максимальное число попыток получения данных |
+  | МаксимальныйРазмер | --size | Число | ✖ | Максимальный размер данных. 0 > без ограничений |
   | Строкой | --string | Булево | ✖ | Истина > возвращает строку, Ложь > двоичные данные |
   | Кодировка | --enc | Строка | ✖ | Кодировка получаемых данных |
 
@@ -27,7 +28,9 @@ import TabItem from '@theme/TabItem';
 <br/>
 
 :::tip
-При установке параметров Таймаут и Размер в 0, чтение производится до окончания сообщения
+Метод пытается прочесть данные интервалами, длительность которых указана в параметре ДлительностьПопытки. За максимальное число попыток отвечает параметр ЧислоПопыток. При успешном получении новых данных число попыток сбрасывается.
+
+При работе с бесконечным потоком входящих данных обязательно указание параметра МаксимальныйРазмер, так как бесконечный сброс попыток при получении данных может привести к зависанию
 :::
 <br/>
 

src/en/OInt/core/Modules/OPI_TCP.os

@@ -89,21 +89,29 @@ EndFunction
 // Reads data from the specified connection
 //
 // Note
-// When the Timeout and Size parameters are set to 0, reading is performed until the message ends
+// The method tries to read the data in intervals, the duration of which is specified in the AttemptDuration parameter.^^
+// The Attempts parameter is responsible for the maximum number of attempts. If the new data is successfully received, the number of attempts is reset.
+// When working with an infinite stream of incoming data, it is obligatory to specify the MaxSize parameter, because^^
+// infinite resetting of attempts when receiving data can lead to hangs
 //
 // Parameters:
 // Connection - Arbitrary - Connection, see. CreateConnection - tcp
-// Timeout - Number - Data reading time (sec). 0 > until the end of the message - timeout
+// AttemptDuration - Number - Interval between data retrieval attempts - timeout
-// Size - Number - Maximum data size. 0 > no limit - size
+// Attempts - Number - Max number of data retrieval attempts - attempts
+// MaxSize - Number - Maximum data size. 0 > no limit - size
 //
 // Returns:
 // BinaryData - Received data
-Function ReceiveData(Val Connection, Val Timeout = 0, Val Size = 0) Export
+Function ReceiveData(Val Connection
+    , Val AttemptDuration = 200
+    , Val Attempts = 5
+    , Val MaxSize = 0) Export
 
-    OPI_TypeConversion.GetNumber(Timeout);
+    OPI_TypeConversion.GetNumber(AttemptDuration);
-    OPI_TypeConversion.GetNumber(Size);
+    OPI_TypeConversion.GetNumber(Attempts);
+    OPI_TypeConversion.GetNumber(MaxSize);
 
-    Return Connection.Read(1024, 150, Size, Timeout);
+    Return Connection.Read(AttemptDuration, Attempts, MaxSize);
 
 EndFunction
 
@@ -111,13 +119,17 @@ EndFunction
 // Establishes a connection and reads data until completion or by limits
 //
 // Note
-// When the Timeout and Size parameters are set to 0, reading is performed until the message ends
+// The method tries to read the data in intervals, the duration of which is specified in the AttemptDuration parameter.^^
+// The Attempts parameter is responsible for the maximum number of attempts. If the new data is successfully received, the number of attempts is reset.
+// When working with an infinite stream of incoming data, it is obligatory to specify the MaxSize parameter, because^^
+// infinite resetting of attempts when receiving data can lead to hangs
 //
 // Parameters:
 // Address - String - Address and port - address
 // SSL - Boolean - Flag for using a secure connection - ssl
-// Timeout - Number - Data reading time (sec). 0 > until the end of the message - timeout
+// AttemptDuration - Number - Interval between data retrieval attempts - timeout
-// Size - Number - Maximum data size. 0 > no limit - size
+// Attempts - Number - Max number of data retrieval attempts - attempts
+// MaxSize - Number - Maximum data size. 0 > no limit - size
 // AsString - Boolean - True > returns string, False > binary data - string
 // Encoding - String - Encoding of received data - enc
 //
@@ -125,15 +137,14 @@ EndFunction
 // String, BinaryData - Received data
 Function ConnectAndReceiveData(Val Address
     , Val SSL = False
-    , Val Timeout = 0
+    , Val AttemptDuration = 0
-    , Val Size = 0
+    , Val Attempts = 5
+    , Val MaxSize = 0
     , Val AsString = True
     , Val Encoding = "UTF-8") Export
 
     OPI_TypeConversion.GetBoolean(AsString);
     OPI_TypeConversion.GetLine(Encoding);
-    OPI_TypeConversion.GetNumber(Size);
-    OPI_TypeConversion.GetNumber(Timeout);
 
     Connection = CreateConnection(Address, SSL);
 
@@ -141,7 +152,7 @@ Function ConnectAndReceiveData(Val Address
         Raise "Failed to create Connection";
     EndIf;
 
-    Message = ReceiveData(Connection, Timeout, Size);
+    Message = ReceiveData(Connection, AttemptDuration, Attempts, MaxSize);
 
     If AsString Then
         Message = ПолучитьСтрокуИзДвоичныхДанных(Message);

src/en/OPI/src/CommonModules/OPI_TCP/Module.bsl

@@ -89,21 +89,29 @@ EndFunction
 // Reads data from the specified connection
 //
 // Note
-// When the Timeout and Size parameters are set to 0, reading is performed until the message ends
+// The method tries to read the data in intervals, the duration of which is specified in the AttemptDuration parameter.^^
+// The Attempts parameter is responsible for the maximum number of attempts. If the new data is successfully received, the number of attempts is reset.
+// When working with an infinite stream of incoming data, it is obligatory to specify the MaxSize parameter, because^^
+// infinite resetting of attempts when receiving data can lead to hangs
 //
 // Parameters:
 // Connection - Arbitrary - Connection, see. CreateConnection - tcp
-// Timeout - Number - Data reading time (sec). 0 > until the end of the message - timeout
+// AttemptDuration - Number - Interval between data retrieval attempts - timeout
-// Size - Number - Maximum data size. 0 > no limit - size
+// Attempts - Number - Max number of data retrieval attempts - attempts
+// MaxSize - Number - Maximum data size. 0 > no limit - size
 //
 // Returns:
 // BinaryData - Received data
-Function ReceiveData(Val Connection, Val Timeout = 0, Val Size = 0) Export
+Function ReceiveData(Val Connection
+    , Val AttemptDuration = 200
+    , Val Attempts = 5
+    , Val MaxSize = 0) Export
 
-    OPI_TypeConversion.GetNumber(Timeout);
+    OPI_TypeConversion.GetNumber(AttemptDuration);
-    OPI_TypeConversion.GetNumber(Size);
+    OPI_TypeConversion.GetNumber(Attempts);
+    OPI_TypeConversion.GetNumber(MaxSize);
 
-    Return Connection.Read(1024, 150, Size, Timeout);
+    Return Connection.Read(AttemptDuration, Attempts, MaxSize);
 
 EndFunction
 
@@ -111,13 +119,17 @@ EndFunction
 // Establishes a connection and reads data until completion or by limits
 //
 // Note
-// When the Timeout and Size parameters are set to 0, reading is performed until the message ends
+// The method tries to read the data in intervals, the duration of which is specified in the AttemptDuration parameter.^^
+// The Attempts parameter is responsible for the maximum number of attempts. If the new data is successfully received, the number of attempts is reset.
+// When working with an infinite stream of incoming data, it is obligatory to specify the MaxSize parameter, because^^
+// infinite resetting of attempts when receiving data can lead to hangs
 //
 // Parameters:
 // Address - String - Address and port - address
 // SSL - Boolean - Flag for using a secure connection - ssl
-// Timeout - Number - Data reading time (sec). 0 > until the end of the message - timeout
+// AttemptDuration - Number - Interval between data retrieval attempts - timeout
-// Size - Number - Maximum data size. 0 > no limit - size
+// Attempts - Number - Max number of data retrieval attempts - attempts
+// MaxSize - Number - Maximum data size. 0 > no limit - size
 // AsString - Boolean - True > returns string, False > binary data - string
 // Encoding - String - Encoding of received data - enc
 //
@@ -125,15 +137,14 @@ EndFunction
 // String, BinaryData - Received data
 Function ConnectAndReceiveData(Val Address
     , Val SSL = False
-    , Val Timeout = 0
+    , Val AttemptDuration = 0
-    , Val Size = 0
+    , Val Attempts = 5
+    , Val MaxSize = 0
     , Val AsString = True
     , Val Encoding = "UTF-8") Export
 
     OPI_TypeConversion.GetBoolean(AsString);
     OPI_TypeConversion.GetLine(Encoding);
-    OPI_TypeConversion.GetNumber(Size);
-    OPI_TypeConversion.GetNumber(Timeout);
 
     Connection = CreateConnection(Address, SSL);
 
@@ -141,7 +152,7 @@ Function ConnectAndReceiveData(Val Address
         Raise "Failed to create Connection";
     EndIf;
 
-    Message = ReceiveData(Connection, Timeout, Size);
+    Message = ReceiveData(Connection, AttemptDuration, Attempts, MaxSize);
 
     If AsString Then
         Message = GetStringFromBinaryData(Message);

src/en/cli/data/Classes/internal/Classes/tcp.os

@@ -37,7 +37,17 @@
     NewLine.Метод       = "ConnectAndReceiveData";
     NewLine.МетодПоиска = "CONNECTANDRECEIVEDATA";
     NewLine.Параметр    = "--timeout";
-    NewLine.Описание    = "Data reading time (sec). 0 > until the end of the message (optional, def. val. - Empty value)";
+    NewLine.Описание    = "Interval between data retrieval attempts (optional, def. val. - Empty value)";
+    NewLine.Область     = "Tcp client";
+
+
+    NewLine = CompositionTable.Add();
+    NewLine.Библиотека  = "tcp";
+    NewLine.Модуль      = "OPI_TCP";
+    NewLine.Метод       = "ConnectAndReceiveData";
+    NewLine.МетодПоиска = "CONNECTANDRECEIVEDATA";
+    NewLine.Параметр    = "--attempts";
+    NewLine.Описание    = "Max number of data retrieval attempts (optional, def. val. - 5)";
     NewLine.Область     = "Tcp client";
 
 

src/ru/OInt/core/Modules/OPI_TCP.os

@@ -103,9 +103,9 @@
 // Возвращаемое значение:
 //  ДвоичныеДанные - Полученные данные
 Функция ПолучитьДанные(Знач Соединение
-	, Знач ДлительностьПопытки = 200
+    , Знач ДлительностьПопытки = 200
-	, Знач ЧислоПопыток = 5
+    , Знач ЧислоПопыток = 5
-	, Знач МаксимальныйРазмер = 0) Экспорт
+    , Знач МаксимальныйРазмер = 0) Экспорт
 
     OPI_ПреобразованиеТипов.ПолучитьЧисло(ДлительностьПопытки);
     OPI_ПреобразованиеТипов.ПолучитьЧисло(ЧислоПопыток);
@@ -139,7 +139,7 @@
     , Знач SSL = Ложь
     , Знач ДлительностьПопытки = 0
     , Знач ЧислоПопыток = 5
-	, Знач МаксимальныйРазмер = 0
+    , Знач МаксимальныйРазмер = 0
     , Знач Строкой = Истина
     , Знач Кодировка = "UTF-8") Экспорт
 

src/ru/OInt/tools/Modules/OPI_ПолучениеДанныхТестов.os

@@ -2038,9 +2038,9 @@
 КонецФункции
 
 Функция ПолучитьОбщийМодуль(Знач Имя)
-    
+
     Модуль = Вычислить(Имя);
-    
+
     Возврат Модуль;
 КонецФункции
 

src/ru/OPI/src/CommonModules/OPI_TCP/Module.bsl

@@ -103,9 +103,9 @@
 // Возвращаемое значение:
 //  ДвоичныеДанные - Полученные данные
 Функция ПолучитьДанные(Знач Соединение
-	, Знач ДлительностьПопытки = 200
+    , Знач ДлительностьПопытки = 200
-	, Знач ЧислоПопыток = 5
+    , Знач ЧислоПопыток = 5
-	, Знач МаксимальныйРазмер = 0) Экспорт
+    , Знач МаксимальныйРазмер = 0) Экспорт
 
     OPI_ПреобразованиеТипов.ПолучитьЧисло(ДлительностьПопытки);
     OPI_ПреобразованиеТипов.ПолучитьЧисло(ЧислоПопыток);
@@ -139,7 +139,7 @@
     , Знач SSL = Ложь
     , Знач ДлительностьПопытки = 0
     , Знач ЧислоПопыток = 5
-	, Знач МаксимальныйРазмер = 0
+    , Знач МаксимальныйРазмер = 0
     , Знач Строкой = Истина
     , Знач Кодировка = "UTF-8") Экспорт
 

src/ru/cli/data/Classes/internal/Classes/tcp.os

@@ -37,7 +37,17 @@
     НоваяСтрока.Метод       = "ПодключитьсяИПолучитьДанные";
     НоваяСтрока.МетодПоиска = "ПОДКЛЮЧИТЬСЯИПОЛУЧИТЬДАННЫЕ";
     НоваяСтрока.Параметр    = "--timeout";
-    НоваяСтрока.Описание    = "Время чтения данных (сек). 0 > до конца сообщения (необяз. по ум. - Пустое значение)";
+    НоваяСтрока.Описание    = "Интервал между попытками получения данных (необяз. по ум. - Пустое значение)";
+    НоваяСтрока.Область     = "Tcp клиент";
+
+
+    НоваяСтрока = ТаблицаСостава.Добавить();
+    НоваяСтрока.Библиотека  = "tcp";
+    НоваяСтрока.Модуль      = "OPI_TCP";
+    НоваяСтрока.Метод       = "ПодключитьсяИПолучитьДанные";
+    НоваяСтрока.МетодПоиска = "ПОДКЛЮЧИТЬСЯИПОЛУЧИТЬДАННЫЕ";
+    НоваяСтрока.Параметр    = "--attempts";
+    НоваяСтрока.Описание    = "Максимальное число попыток получения данных (необяз. по ум. - 5)";
     НоваяСтрока.Область     = "Tcp клиент";