mirror of
https://github.com/ipfs/kubo.git
synced 2026-02-23 03:17:43 +08:00
0e494690b3
Rather than pushing errors back down to lower layers, propagate the
errors upward.
This commit adds a `ReceiveError` method to BitSwap's network receiver.
Still TODO: rm the error return value from:
net.service.handler.HandleMessage
This is inspired by delegation patterns in found in the wild.
56 lines
1.6 KiB
Go
56 lines
1.6 KiB
Go
package network
|
|
|
|
import (
|
|
context "github.com/jbenet/go-ipfs/Godeps/_workspace/src/code.google.com/p/go.net/context"
|
|
netservice "github.com/jbenet/go-ipfs/net/service"
|
|
|
|
bsmsg "github.com/jbenet/go-ipfs/exchange/bitswap/message"
|
|
netmsg "github.com/jbenet/go-ipfs/net/message"
|
|
peer "github.com/jbenet/go-ipfs/peer"
|
|
u "github.com/jbenet/go-ipfs/util"
|
|
)
|
|
|
|
// Adapter provides network connectivity for BitSwap sessions
|
|
type Adapter interface {
|
|
|
|
// SendMessage sends a BitSwap message to a peer.
|
|
SendMessage(
|
|
context.Context,
|
|
*peer.Peer,
|
|
bsmsg.BitSwapMessage) error
|
|
|
|
// SendRequest sends a BitSwap message to a peer and waits for a response.
|
|
SendRequest(
|
|
context.Context,
|
|
*peer.Peer,
|
|
bsmsg.BitSwapMessage) (incoming bsmsg.BitSwapMessage, err error)
|
|
|
|
// SetDelegate registers the Reciver to handle messages received from the
|
|
// network.
|
|
SetDelegate(Receiver)
|
|
}
|
|
|
|
type Receiver interface {
|
|
ReceiveMessage(
|
|
ctx context.Context, sender *peer.Peer, incoming bsmsg.BitSwapMessage) (
|
|
destination *peer.Peer, outgoing bsmsg.BitSwapMessage)
|
|
|
|
ReceiveError(error)
|
|
}
|
|
|
|
// TODO(brian): move this to go-ipfs/net package
|
|
type NetMessageService interface {
|
|
SendRequest(ctx context.Context, m netmsg.NetMessage) (netmsg.NetMessage, error)
|
|
SendMessage(ctx context.Context, m netmsg.NetMessage) error
|
|
SetHandler(netservice.Handler)
|
|
}
|
|
|
|
// TODO rename -> Router?
|
|
type Routing interface {
|
|
// FindProvidersAsync returns a channel of providers for the given key
|
|
FindProvidersAsync(context.Context, u.Key, int) <-chan *peer.Peer
|
|
|
|
// Provide provides the key to the network
|
|
Provide(context.Context, u.Key) error
|
|
}
|