TCP-basisprincipes

TCP werkt via IPv4 of IPv6. socket.tcp() kiest de familie pas wanneer dat nodig is, terwijl socket.tcp4() en socket.tcp6() er één afdwingen.

Gebruik socket.dns.toip(host) om een hostnaam om te zetten naar een numeriek adres voordat je verbinding maakt, als je expliciete controle nodig hebt.

conn:connect(host, port) voert de drievoudige TCP-handshake uit. Bij succes geeft de functie 1 terug; bij een fout geeft ze nil en een foutmelding terug, zoals "connection refused" of "timeout".

De handige functie socket.connect(host, port) maakt in één aanroep een socket en brengt de verbinding tot stand.

conn:send(data) schrijft bytes naar de socket. De functie geeft de index van de laatst verzonden byte terug. Bij een blokkerende socket is dat meestal de volledige lengte van data.

TCP is een bytestroom en geen berichtenprotocol. Eén send kan onderweg worden opgesplitst of samengevoegd. Je moet je eigen berichtenindeling definiëren.

conn:receive(pattern) leest uit de stroom. Het standaardpatroon "*l" leest één regel zonder de regeleinde. "*a" leest totdat de verbinding wordt gesloten.

Je kunt ook een getal doorgeven om precies zoveel bytes te lezen. Bij een fout geeft de functie nil, een fouttekenreeks en eventueel gedeeltelijk ontvangen gegevens terug.

Roep altijd conn:close() aan wanneer je klaar bent om de bestandsdescriptor vrij te geven en een TCP FIN te verzenden.

Je kunt de verbinding gedeeltelijk sluiten met conn:shutdown("send") om het einde van de gegevensstroom aan te geven terwijl je nog steeds het antwoord van de andere kant leest. Dit is handig voor aanvraag-antwoordprotocollen die "*a" gebruiken.

Sockets blokkeren standaard voor onbepaalde tijd. conn:settimeout(seconds) begrenst hoelang een aanroep wacht. Met de waarde 0 maak je de socket niet-blokkerend.

Wanneer een time-out optreedt, geeft de aanroep nil en de tekenreeks "timeout" terug. Stel in productie altijd een time-out in om vastgelopen verbindingen te voorkomen.

TCP is verbindingsgericht, geordend en betrouwbaar: bytes komen één keer en in de juiste volgorde aan, ten koste van handshake-uitwisselingen en hertransmissies.

UDP (socket.udp()) is verbindingsloos en onbetrouwbaar, maar lichtgewicht en geschikt voor telemetrie of games. Deze cursus richt zich op TCP, omdat het de basis vormt voor HTTP.

Op niet-blokkerende sockets kan send slechts een deel van je buffer verzenden. Het retourneert nil, "timeout" en de index van de laatste byte die tot nu toe is geschreven.

Een betrouwbare verzender gebruikt een lus en gaat verder bij de byte na de laatst verzonden byte totdat de hele buffer is verzonden.

conn:getpeername() retourneert het externe IP-adres en de poort, terwijl conn:getsockname() het lokale uiteinde retourneert. Dit helpt bij logregistratie en foutopsporing.

conn:setoption("keepalive", true) en conn:setoption("tcp-nodelay", true) stemmen het gedrag van de onderliggende socket af.

Je hebt het TCP-hoofdobject van LuaSocket leren kennen, geleerd hoe je sockets maakt, verbindt, gegevens verzendt en ontvangt en sockets sluit, en gezien hoe time-outs en halfsluiting het gedrag bepalen.

Onthoud dat TCP een bytestroom is, dat elke aanroep nil, err kan retourneren en dat een socket in productie altijd een time-out instelt. Vervolgens voeg je deze onderdelen samen tot een werkende client.