Network

fs2.io.net.Network
See theNetwork companion object
sealed trait Network[F[_]] extends SocketGroup[F] with DatagramSocketGroup[F]

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

Attributes

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
Source:
Network.scala
Graph
Supertypes
trait SocketGroup[F]
class Object
trait Matchable
class Any

Members list

Concise view

Value members

Abstract methods

Returns a builder for TLSContext[F] values.

Returns a builder for TLSContext[F] values.

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

Attributes

Source:
Network.scala

Inherited methods

Opens a TCP connection to the specified server.

Opens a TCP connection to the specified server.

The connection is closed when the resource is released.

Attributes

options

socket options to apply to the underlying socket

to

address of remote server

Inherited from:
SocketGroup
Source:
SocketGroup.scala
def openDatagramSocket(address: Option[Host], port: Option[Port], options: List[DatagramSocketOption], protocolFamily: Option[ProtocolFamily]): Resource[F, DatagramSocket[F]]

Creates a UDP socket bound to the specified address.

Creates a UDP socket bound to the specified address.

Attributes

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
Source:
DatagramSocketGroup.scala
def server(address: Option[Host], port: Option[Port], options: List[SocketOption]): Stream[F, Socket[F]]

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.

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.

Attributes

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
Source:
SocketGroup.scala

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

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.

Attributes

Inherited from:
SocketGroup
Source:
SocketGroup.scala