OpenComputers/Internet API

Этот интерфейс реализует функциональность интернет плат.

Для передачи информации между компьютерами внутри игры смотрите: Сетевая плата, Беспроводная сетевая плата.

Интерфейс

• internet.request(url: string[, data: string or table]): function

Посылает HTTP-запрос по заданному URL, с заданными POST данными. Если данные не определены, будет произведен GET запрос. Данные POST могут быть в одном из двух форматов: если это строка, она будет передана "как есть". Если это таблица — она будет конвертирована в строку, предполагая, что каждый ключ — название переменной POST, а значение ключа — её значение. К примеру:

internet.request(url, {some = "variable", another = 1})

Будет послана строка some=variable&another=1

Возвращаемое значение — итератор чанков (фрагментов) результата. Пример использования:

for chunk in internet.request(...) do stuff() end

Важно: не вызывайте os.sleep, event.pull или другую функцию, которая работает с событиями, в процессе обработки строк результата. Это связано с тем, что каждая такая строка — это сигнал (таким образом программа избегает ошибок переполнения памяти при больших ответах).

• internet.socket(address:string[, port:number]):table

Открывает TCP сокет, используя метод интернет-компонента (см. далее) connect и создавая таблицу с теми же методами, что и при открытии файла через filesystem.open: read, write и close (а также seek, который будет всегда выдавать ошибку). Рекомендуется использовать вместо нее internet.open, которая создает буферизованную обертку (аналогично io.open при работе с файлами).

• internet.open(address:string[, port:number]):table

Открывает сокет по заданному адресу в виде буферизованного потока. Поток можно читать и писать в него методами s:read и s:write. В общем случае это происходит так же как при работе с файлами через io.open. Во многих случаях также удобно установить таймаут на чтение буфера функцией s:setTimeout(seconds) чтобы избежать блокирования на неопределенное время. Пример использования:

local internet = require("internet") local handle = internet.open("example.com", 1337) local data = handle:read(10) handle:write("1234") handle:close()

Интернет компонент

Набор функций более низкого уровня (например, проверка доступности запросов HTTP и TCP функциональность)

Примечание: Для того, чтобы воспользоваться низкоуровневыми функциями, обращайтесь к интернет-плате как к компоненту. Например:

local com = require('component') local internet = com.internet

• internet.isHttpEnabled():boolean

Проверяет, доступны ли запросы HTTP на сервере (настройка конфигурации).

• internet.isTcpEnabled():boolean

Проверяет, доступны ли TCP сокеты на сервере (настройка конфигурации).

• internet.request(url:string[, postData:string]):boolean

Запускает HTTP запрос по заданному URL с заданными POST данными (если есть). Ответ обрабатывается как http_response сигнал. Возможно использование вместо нее "обертки" с итератором internet.request.

• internet.connect(address:string[, port:number]):number

Открывает новое TCP соединение. Возвращает его заголовок (handle), который используется для взаимодействия с открытым сокетом при помощи других функций. Может вызвать ошибку, если TCP сокеты не разрешены, существует слишком много открытых соединений, либо произошла другая ошибка ввода/вывода (I/O error). Удобнее использовать буферизованную функцию internet.open.

• internet.read(handle:number, n:number):string

Читает данные из потока. Возвращает массив прочитанных байтов. Использует заголовок (handle), полученный при соединении (internet.connect).

• internet.write(handle:number, data:string): number

Пишет данные в поток. Возвращает число записанных байт. Использует заголовок (handle), полученный при соединении (internet.connect).

• internet.close(handle:number)

Закрывает сокет с заданным заголовком (handle). Использует заголовок (handle), полученный при соединении (internet.connect).

Пример

Этот пример — базовый IRC бот, который возвращает обратно все, что вы ему скажете. Написан с использованием сокетов и Internet API.

--this is just a basic split function we'll use to split the messages function split(data, pat) local ret = {} for i in string.gmatch(data,pat) do table.insert(ret,i) end return ret end --config local nickname = "myircbot" local channel = "#mybotchannel" local net = require("internet") local con = net.open("irc.esper.net",6667) --define server / port here, this will connect to the server if(con) then local line,png,linesplt,msgfrom = "" while(true) do line = con:read() --read a line from the socket print(line) linesplt = split(line,"[^:]+") if #linesplt >= 2 and string.find(linesplt[2], "No Ident response") ~= nil then print("JOIN") con:write("USER " .. nickname .. " 0 * :" .. nickname .. "\r\n") --con:write(msg) is used to send messages, con:read() will read a line con:write("NICK " .. nickname .. "\r\n") --for IRC, remember to append the \r\n on the end of all messages con:write("JOIN :" .. channel .. "\r\n") elseif linesplt[1] == "PING" or linesplt[1] == "PING " then print("PING") png = split(line,"[^:]+") con:write("PONG :"..png[#png].."\r\n") --respond to pings so we don't get disconnected elseif string.find(linesplt[1], "PRIVMSG #") ~= nil then msgfrom = split(linesplt[1],"[^ ]+") msgfrom = msgfrom[3] con:write("PRIVMSG "..msgfrom.." :"..linesplt[2].."\r\n") end end else print("Connection failed.") end

Более продвинутый пример — IRC клиент, который доступен в последней сборке OpenComputers: irc.lua