Ügyfél (Client) osztály

Az Arduino-hoz a kliens számára dokumentált metódusok

A lentebb leírt metódusok és tulajdonságok az ESP8266-ra vonatkoznak. Az Arduino WiFi könyvtár dokumentációja nem foglalkozik velük. Mielőtt teljes körűen dokumentálnák, olvassa el az alábbi információkat.

flush és stop

A flush(timeoutMs) és a stop(timeoutMs) most már rendelkezik egy opcionális argumentummal: timeoutMs ezredmásodpercben, és mindkettő boolean értéket ad vissza.

Az alapértelmezett 0 bemeneti érték azt jelenti, hogy az effektív értéket a megvalósító belátása szerint hagyják.

A flush() true visszaadott értéke azt jelzi, hogy a kimeneti adatok ténylegesen el lettek küldve, és false, ha időtúllépés történt.

A stop() false értéket ad vissza, ha probléma merül fel a kliens bezárásakor (például egy időkorlát flush). A megvalósítástól függően a paramétere átadható a flush()-nak.

setNoDelay


setNoDelay(nodelay)

Ha a nodelay true-ra van állítva, ez a függvény letiltja a Nagle algoritmust.

Ennek az algoritmusnak a célja, hogy csökkentse a hálózaton keresztül küldött kis csomagok TCP/IP-forgalmát azáltal, hogy több kis kimenő üzenetet kombinál, és egyszerre küld el. Az ilyen megközelítés hátránya, hogy hatékonyan késlelteti az egyes üzeneteket, amíg egy elég nagy csomagot nem állítanak össze.


client.setNoDelay(true)

getNoDelay

Visszaadja, hogy a NoDelay engedélyezve van-e vagy sem az aktuális kapcsolathoz.

setSync

Ez egy kísérleti API, amely szinkronizált módba állítja az ügyfelet. Ebben a módban minden write() kiürül. Ez azt jelenti, hogy a write() hívás után az adatok biztosan oda érkeznek, ahová küldték (azaz ez szemantikai flush).

Ha true-ra van állítva a WiFiClient implementációban,

lelassítja az átvitelt, és implicit módon letiltja a Nagle algoritmust.
lehetővé teszi továbbá az adatok ideiglenes másolatának elkerülését, amely egyébként kapcsolatonként legfeljebb TCP_SND_BUF = (2 * MSS) bájtot fogyaszt.

getSync

Visszaadja, hogy a Sync engedélyezve van-e az aktuális kapcsolatnál.

setDefaultNoDelay és setDefaultSync

Ezek beállítják a setSync és a setNoDelay alapértelmezett értékét a WiFiClient minden jövőbeli példányához (beleértve azokat is, amelyek alapértelmezés szerint a WiFiServer.available()-től származnak).

Az alapértelmezett érték a false mind a NoDelay, mind a Sync esetében.

Ez azt jelenti, hogy a Nagle alapértelmezés szerint minden új kapcsolathoz engedélyezve van.

getDefaultNoDelay és getDefaultSync

Visszaadja a NoDelay és Sync alapértelmezett értékeit az összes jövőbeli kapcsolathoz.

Egyéb függvényhívások


uint8_t  status ()
virtual size_t  write (const uint8_t *buf, size_t size)
size_t  write_P (PGM_P buf, size_t size)
size_t  write (Stream &amt;stream)
size_t  write (Stream &amt;stream, size_t unitSize) __attribute__((deprecated))
virtual int  read (uint8_t *buf, size_t size)
virtual int  peek ()
virtual size_t  peekBytes (uint8_t *buffer, size_t length)
size_t  peekBytes (char *buffer, size_t length)
virtual  operator bool ()
IPAddress  remoteIP ()
uint16_t  remotePort ()
IPAddress  localIP ()
uint16_t  localPort ()

A fenti függvényekhez még nem áll rendelkezésre dokumentáció.