kubo/peer/peer.go
Juan Batiz-Benet 66839fa1de changed logging, in dht and elsewhere
- use log.* instead of u.*
- use automatic type conversions to .String()
  (Peer.String() prints nicely, and avoids calling b58 encoding
  until needed)
2014-10-07 21:33:59 -07:00

111 lines
2.4 KiB
Go

package peer
import (
"sync"
"time"
b58 "github.com/jbenet/go-ipfs/Godeps/_workspace/src/github.com/jbenet/go-base58"
ma "github.com/jbenet/go-ipfs/Godeps/_workspace/src/github.com/jbenet/go-multiaddr"
mh "github.com/jbenet/go-ipfs/Godeps/_workspace/src/github.com/jbenet/go-multihash"
ic "github.com/jbenet/go-ipfs/crypto"
u "github.com/jbenet/go-ipfs/util"
"bytes"
)
// ID is a byte slice representing the identity of a peer.
type ID mh.Multihash
// String is utililty function for printing out peer ID strings.
func (id ID) String() string {
return id.Pretty()
}
// Equal is utililty function for comparing two peer ID's
func (id ID) Equal(other ID) bool {
return bytes.Equal(id, other)
}
// Pretty returns a b58-encoded string of the ID
func (id ID) Pretty() string {
return b58.Encode(id)
}
// DecodePrettyID returns a b58-encoded string of the ID
func DecodePrettyID(s string) ID {
return b58.Decode(s)
}
// Map maps Key (string) : *Peer (slices are not comparable).
type Map map[u.Key]*Peer
// Peer represents the identity information of an IPFS Node, including
// ID, and relevant Addresses.
type Peer struct {
ID ID
Addresses []ma.Multiaddr
PrivKey ic.PrivKey
PubKey ic.PubKey
latency time.Duration
sync.RWMutex
}
// String prints out the peer.
func (p *Peer) String() string {
return "[Peer " + p.ID.String() + "]"
}
// Key returns the ID as a Key (string) for maps.
func (p *Peer) Key() u.Key {
return u.Key(p.ID)
}
// AddAddress adds the given Multiaddr address to Peer's addresses.
func (p *Peer) AddAddress(a ma.Multiaddr) {
p.Lock()
defer p.Unlock()
for _, addr := range p.Addresses {
if addr.Equal(a) {
return
}
}
p.Addresses = append(p.Addresses, a)
}
// NetAddress returns the first Multiaddr found for a given network.
func (p *Peer) NetAddress(n string) ma.Multiaddr {
p.RLock()
defer p.RUnlock()
for _, a := range p.Addresses {
for _, p := range a.Protocols() {
if p.Name == n {
return a
}
}
}
return nil
}
// GetLatency retrieves the current latency measurement.
func (p *Peer) GetLatency() (out time.Duration) {
p.RLock()
out = p.latency
p.RUnlock()
return
}
// SetLatency sets the latency measurement.
// TODO: Instead of just keeping a single number,
// keep a running average over the last hour or so
// Yep, should be EWMA or something. (-jbenet)
func (p *Peer) SetLatency(laten time.Duration) {
p.Lock()
p.latency = laten
p.Unlock()
}