класс TCPSocket

Родитель:: IPSocket

TCPSocket представляет собой сокет клиента TCP/IP.

Простой клиент может выглядеть так:

require 'socket'

s = TCPSocket.new 'localhost', 2000

while line = s.gets # Read lines from socket
  puts line         # and print them
end

s.close             # close socket when done

Методы публичного класса

gethostbyname(hostname) → [official_hostname, alias_hostnames, address_family, *address_list]

Исходный код

static VALUE
tcp_s_gethostbyname(VALUE obj, VALUE host)
{
    rb_warn("TCPSocket.gethostbyname is deprecated; use Addrinfo.getaddrinfo instead.");
    struct rb_addrinfo *res =
        rsock_addrinfo(host, Qnil, AF_UNSPEC, SOCK_STREAM, AI_CANONNAME);
    return rsock_make_hostent(host, res, tcp_sockaddr);
}

Используйте Addrinfo.getaddrinfo вместо него. Этот метод устарел по следующим причинам:

Третий элемент результата — семейство адресов первого адреса. Семейства адресов остальных адресов не возвращаются.
gethostbyname() может занимать много времени и может заблокировать другие потоки. (GVL не может быть освобожден, так как gethostbyname() не потокобезопасен.)
Этот метод использует функцию gethostbyname(), которая уже удалена из POSIX.

Этот метод выполняет поиск информации об узле по имени узла.

TCPSocket.gethostbyname("localhost")
#=> ["localhost", ["hal"], 2, "127.0.0.1"]

new(remote_host, remote_port, local_host=nil, local_port=nil, resolv_timeout: nil, connect_timeout: nil, fast_fallback: true)

Исходный код

static VALUE
tcp_init(int argc, VALUE *argv, VALUE sock)
{
    VALUE remote_host, remote_serv;
    VALUE local_host, local_serv;
    VALUE opt;
    static ID keyword_ids[4];
    VALUE kwargs[4];
    VALUE resolv_timeout = Qnil;
    VALUE connect_timeout = Qnil;
    VALUE fast_fallback = Qnil;
    VALUE test_mode_settings = Qnil;

    if (!keyword_ids[0]) {
        CONST_ID(keyword_ids[0], "resolv_timeout");
        CONST_ID(keyword_ids[1], "connect_timeout");
        CONST_ID(keyword_ids[2], "fast_fallback");
        CONST_ID(keyword_ids[3], "test_mode_settings");
    }

    rb_scan_args(argc, argv, "22:", &remote_host, &remote_serv,
                        &local_host, &local_serv, &opt);

    if (!NIL_P(opt)) {
        rb_get_kwargs(opt, keyword_ids, 0, 4, kwargs);
        if (kwargs[0] != Qundef) { resolv_timeout = kwargs[0]; }
        if (kwargs[1] != Qundef) { connect_timeout = kwargs[1]; }
        if (kwargs[2] != Qundef) { fast_fallback = kwargs[2]; }
        if (kwargs[3] != Qundef) { test_mode_settings = kwargs[3]; }
    }

    if (fast_fallback == Qnil) {
        fast_fallback = rb_ivar_get(rb_cSocket, tcp_fast_fallback);
        if (fast_fallback == Qnil) fast_fallback = Qtrue;
    }

    return rsock_init_inetsock(sock, remote_host, remote_serv,
                               local_host, local_serv, INET_CLIENT,
                               resolv_timeout, connect_timeout, fast_fallback,
                               test_mode_settings);
}

Открывает TCP-соединение с remote_host на remote_port. Если local_host и local_port указаны, эти параметры используются на локальном конце для установления соединения.

Начиная с Ruby 3.4, этот метод по умолчанию работает в соответствии с алгоритмом Happy Eyeballs Version 2 (RFC 8305), за исключением Windows.

Подробности об алгоритме Happy Eyeballs Version 2 см. в Socket.tcp_fast_fallback=.

Чтобы заставить его работать так же, как в Ruby 3.3 и ранее, явно укажите параметр fast_fallback:false. Или установка Socket.tcp_fast_fallback=false отключит алгоритм Happy Eyeballs Version 2 не только для этого метода, но и для всех Socket глобально.

При использовании TCPSocket.new на Windows алгоритм Happy Eyeballs Version 2 не предоставляется, и он ведет себя так же, как в Ruby 3.3 и ранее.

:resolv_timeout: Указывает тайм-аут в секундах с момента начала разрешения имени узла.
:connect_timeout: Этот метод последовательно пытается подключиться ко всем кандидатам в конечные адреса.
Параметр connect_timeout указывает тайм-аут в секундах с момента начала попытки соединения до последнего кандидата.
По умолчанию все попытки соединения продолжаются до истечения тайм-аута.
При явном указании fast_fallback:false для каждой попытки соединения устанавливается тайм-аут, и любая попытка соединения, превысившая его, будет отменена.
:fast_fallback: Включает алгоритм Happy Eyeballs Version 2 (включен по умолчанию).

Ruby Core © 1993–2024 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.