TCPListener

[Source]

Listens for new network connections.

The following program creates an echo server that listens for connections on port 8989 and echoes back any data it receives.

use "net"

class MyTCPConnectionNotify is TCPConnectionNotify
  fun ref received(
    conn: TCPConnection ref,
    data: Array[U8] iso,
    times: USize)
    : Bool
  =>
    conn.write(String.from_array(consume data))
    true

  fun ref connect_failed(conn: TCPConnection ref) =>
    None

class MyTCPListenNotify is TCPListenNotify
  fun ref connected(listen: TCPListener ref): TCPConnectionNotify iso^ =>
    MyTCPConnectionNotify

  fun ref not_listening(listen: TCPListener ref) =>
    None

actor Main
  new create(env: Env) =>
    TCPListener(TCPListenAuth(env.root),
      recover MyTCPListenNotify end, "", "8989")

actor tag TCPListener is
  AsioEventNotify tag

Implements

• AsioEventNotify tag

---

Constructors

create

[Source]

Listens for both IPv4 and IPv6 connections.

new tag create(
  auth: TCPListenAuth val,
  notify: TCPListenNotify iso,
  host: String val = "",
  service: String val = "0",
  limit: USize val = 0,
  read_buffer_size: USize val = 16384,
  yield_after_reading: USize val = 16384,
  yield_after_writing: USize val = 16384)
: TCPListener tag^

Parameters

• auth: TCPListenAuth val
• notify: TCPListenNotify iso
• host: String val = ""
• service: String val = "0"
• limit: USize val = 0
• read_buffer_size: USize val = 16384
• yield_after_reading: USize val = 16384
• yield_after_writing: USize val = 16384

Returns

• TCPListener tag^

---

ip4

[Source]

Listens for IPv4 connections.

new tag ip4(
  auth: TCPListenAuth val,
  notify: TCPListenNotify iso,
  host: String val = "",
  service: String val = "0",
  limit: USize val = 0,
  read_buffer_size: USize val = 16384,
  yield_after_reading: USize val = 16384,
  yield_after_writing: USize val = 16384)
: TCPListener tag^

Parameters

• auth: TCPListenAuth val
• notify: TCPListenNotify iso
• host: String val = ""
• service: String val = "0"
• limit: USize val = 0
• read_buffer_size: USize val = 16384
• yield_after_reading: USize val = 16384
• yield_after_writing: USize val = 16384

Returns

• TCPListener tag^

---

ip6

[Source]

Listens for IPv6 connections.

new tag ip6(
  auth: TCPListenAuth val,
  notify: TCPListenNotify iso,
  host: String val = "",
  service: String val = "0",
  limit: USize val = 0,
  read_buffer_size: USize val = 16384,
  yield_after_reading: USize val = 16384,
  yield_after_writing: USize val = 16384)
: TCPListener tag^

Parameters

• auth: TCPListenAuth val
• notify: TCPListenNotify iso
• host: String val = ""
• service: String val = "0"
• limit: USize val = 0
• read_buffer_size: USize val = 16384
• yield_after_reading: USize val = 16384
• yield_after_writing: USize val = 16384

Returns

• TCPListener tag^

---

Public Behaviours

set_notify

[Source]

Change the notifier.

be set_notify(
  notify: TCPListenNotify iso)

Parameters

• notify: TCPListenNotify iso

---

dispose

[Source]

Stop listening.

be dispose()

---

Public Functions

local_address

[Source]

Return the bound IP address.

fun box local_address()
: NetAddress val

Returns

• NetAddress val

---

close

[Source]

Dispose of resources.

fun ref close()
: None val

Returns

• None val

---