Network

sealed trait Network[F[_]] extends NetworkPlatform[F] with SocketGroup[F] with DatagramSocketGroup[F]

Provides the ability to work with TCP, UDP, and TLS.

Example

import fs2.Stream
import fs2.io.net.{Datagram, Network}
def send[F[_]: Network](datagram: Datagram): F[Unit] =
 Network[F].openDatagramSocket().use { socket =>
   socket.write(packet)
 }

In this example, the F[_] parameter to send requires the Network constraint instead of requiring the much more powerful Async constraint. The Network instance has a set of global resources used for managing sockets. Alternatively, use the socketGroup and datagramSocketGroup operations to manage the lifecycle of underlying resources. An instance of Network is available for any effect F which has an Async[F] instance.

Companion

object

trait DatagramSocketGroup[F]

trait SocketGroup[F]

trait NetworkPlatform[F]

class Object

trait Matchable

class Any

Value members

Abstract methods

Returns a builder for TLSContext[F] values.

For example, Network[IO].tlsContext.system returns a F[TLSContext[F]].

Inherited methods

Opens a TCP connection to the specified server.

The connection is closed when the resource is released.

Value Params

options: socket options to apply to the underlying socket
to: address of remote server

Inherited from

SocketGroup

Creates a UDP socket bound to the specified address.

Value Params

address: address to bind to; defaults to all interfaces
options: socket options to apply to the underlying socket
port: port to bind to; defaults to an ephemeral port
protocolFamily: protocol family to use when opening the supporting DatagramChannel

Inherited from

DatagramSocketGroup

Creates a TCP server bound to specified address/port and returns a stream of client sockets -- one per client that connects to the bound address/port.

When the stream terminates, all open connections will terminate as well. Because of this, make sure to handle errors in the client socket Streams.

Value Params

address: address to accept connections from; none for all interfaces
options: socket options to apply to the underlying socket
port: port to bind

Inherited from

SocketGroup

Like server but provides the SocketAddress of the bound server socket before providing accepted sockets.

Make sure to handle errors in the client socket Streams.

Inherited from: SocketGroup