Admin: 1 revision imported

2021-11-20T17:07:21Z

1 revision imported

1>Admin at 17:41, 10 November 2021

2021-11-10T17:41:58Z

Admin: 1 revision imported

2021-02-07T06:51:18Z

1 revision imported

Admin at 07:20, 24 April 2020

2020-04-24T07:20:14Z

New page

{{infobox function
|name=Connect
|object=[[Объект IP]]
|caption=Установка соединения
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект IP]]}}
Функция производит соединение TCP/IP с удаленным сервером, после установки соединения никакой дополнительной информации не отсылается.

== Синтаксис ==
<code>
{{Grey|IPConnection.}}'''Connect'''(''<Адрес соединения (STRING)>''{{Optional|,<Блокирующий ли это сокет (INT)>{{Default|{{Eq}}0}},<Тип соединения (INT)>{{Default|{{Eq}}0}}}}):''<Новое соединение или пустое значение (IPOBJECT)>''
</code>

==== Аргументы ====
* <code>''<Адрес соединения (STRING)>''</code> - Адрес соединения задается в виде <code><Доменное имя сервера, адрес IPv4 или IPv6>[:<Номер порта>]</code> (примеры: <code>127.0.0.1:80</code>, <code>en.wikipedia.org:443</code>, <code>москва.рф:443</code>, <code>::1=80</code>). При указании IP адреса (<code>xxx.xxx.xxx.xxx</code> или <code>xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx</code>), можно использовать квадратные скобки '''[''', ''']''' для отделения IP адреса от номера порта. Номер порта можно указывать после знака ''':''' или знака '''=''', для IPv6 адресов можно использовать только знак '''=''' или использовать квадратные скобки, как разделитель, так как ''':''' занят для указания элементов адреса (примеры: <code>127.0.0.1=80</code>, <code>[::1]:443</code>). Если номер порта в адресе не задан, используется порт 80. Доменное имя будет автоматически закодировано в формат Punycode, если в нем присутствуют международные символы, однако, нужно помнить, что при формировании http заголовка поле ''Host'' необходимо также кодировать с помощью Punycode (см. пример ниже).
* <code>''<Блокирующий ли это сокет (INT)>''</code> - {{Optional}} Указание на то, будет ли созданное соединение блокирующим. Блокирующие соединения не имеют доступа к ряду функций (к примеру [[IPConnection.Receive|Receive]] или [[IPConnection.Peek|Peek]]). По умолчанию, используется не блокирующее соединение.
* <code>''<Тип соединения (INT)>''</code> - {{Optional}} Указывает на тип (протокол) соединения. Нужно заметить, что если аргумент ''адрес соединения'' использует нотацию IPv6 или доменное имя возвратит только IPv6 адрес (у сервера отсутствует IPv4 адрес), значение этого аргумента будет проигнорировано и будет использован протокол IPv6, и наоборот, если тип соединения подразумевает IPv6, однако можно осуществить соединение только на IPv4, аргумент будет проигнорирован. Чтобы узнать, по какому протоколу осуществлено соединение, можно использовать атрибут [[IPConnection.IsIPv6|IsIPv6]]. Доступны следующие значения аргумента:
** '''0''' (по умолчанию) -- Будет использован протокол IPv4
** '''1''' -- Будет использован протокол IPv6

==== Возвращаемое значение ====
Возвращается новый объект IP. В случае, если соединение было успешным, объект соединен, иначе объект пустой.

== Примеры ==
<pre>
//Пример показывает, как можно осуществить загрузку веб-страницы по ее адресу.
//Для загрузки по протоколу https требуется указание пути к библиотекам OpenSSL или LibreSSL.

Function LoadPage(URL)
bHTTPs:=pos("https://",Lowercase(URL));
If pos("//",URL)>0 Then
tearStr(URL,"//");
EndIf;
СтрДоб:=URL;
URL:=tearStr(СтрДоб,"/");
//URL может содержать название параграфа
СтрДоб:=TearStr(СтрДоб,"#");
For i:=1 to 3 Do
if bHTTPs Then
tcp:=IPConnection.Connect(URL+?(Pos(":",URL)+Pos("=",URL)=0,"=443"),1);
Else
tcp:=IPConnection.Connect(URL+?(Pos(":",URL)+Pos("=",URL)=0,"=80"));
EndIf;
if tcp.IsConnected Then
Break;
EndIf;
EndDo;
if not tcp.IsConnected Then
Message("Could not connect: "+URL,"!");
Exit;
EndIf;
СтрДоб:="/"+СтрДоб;
if bHTTPs then
//tcp.InitEncryption("LibreSSL","C:\LibreSSL255\libtls-15.dll");
tcp.InitEncryption("OpenSSL","C:\OpenSSL111e\libssl-1_1.dll");
endif;
tcp.HTTPSetOperation("GET "+СтрДоб+" HTTP/1.0");
tcp.HTTPSetHeaderField("Host",tcp.HTTPPunycodeEncode(URL));
tcp.HTTPSetHeaderField("User-Agent","Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0)");
tcp.HTTPSetHeaderField("Accept","text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8");
tcp.HTTPSetHeaderField("Accept-Language","en");
tcp.HTTPSetHeaderField("Connection","Close");
Стр:="";
Try
If tcp.HTTPSendAndReceive Then
Стр:=tcp.HTTPBodyAsString;
If _And(Pos(_NEWLINE,Стр)=0,Pos(Chr(10),Стр)>0) Then
Стр:=Replace(Стр,Chr(10),_NEWLINE);
EndIf;
EndIf;
Except
Message("Could not load: "+URL,"!");
EndTry;
Exit Стр;
EndFunction

s:=LoadPage("https://en.wikipedia.org/wiki/Main_Page");
Message(s);
</pre>

← Older revision	Revision as of 17:07, 20 November 2021
(No difference)

@@ Line 17: / Line 17: @@
 == Синтаксис ==
 <code>
-{{Grey|IPConnection.}}'''Connect'''(''<Адрес соединения (STRING)>''{{Optional|,<Блокирующий ли это сокет (INT)>{{Default|{{Eq}}0}},<Тип соединения (INT)>{{Default|{{Eq}}0}}}}):''<Новое соединение или пустое значение (IPOBJECT)>''
+{{Grey|IPConnection.}}'''Connect'''(''<Адрес соединения (STRING)>''{{Optional|,<Блокирующий ли это сокет (INT)>{{Default|{{Eq}}0}},<Тип соединения (INT)>{{Default|{{Eq}}0}}}}):''<Новое соединение (IPOBJECT)>''
 </code>
@@ Line 28: / Line 28: @@
 ==== Возвращаемое значение ====
-Возвращается новый объект IP. В случае, если соединение было успешным, объект соединен, иначе объект пустой.
+Возвращается новый объект IP. В случае, если соединение было успешным, объект соединен, иначе объект неактивен.
 == Примеры ==

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)

IPConnection.Connect - Revision history

Admin: 1 revision imported

1>Admin at 17:41, 10 November 2021

Admin: 1 revision imported

Admin at 07:20, 24 April 2020