forked from TrueCloudLab/frostfs-node
47 lines
1.7 KiB
Go
47 lines
1.7 KiB
Go
package netmap
|
|
|
|
import (
|
|
"context"
|
|
|
|
"git.frostfs.info/TrueCloudLab/frostfs-sdk-go/netmap"
|
|
)
|
|
|
|
// Source is an interface that wraps
|
|
// basic network map receiving method.
|
|
type Source interface {
|
|
// GetNetMap reads the diff-th past network map from the storage.
|
|
// Calling with zero diff returns the latest network map.
|
|
// It returns the pointer to the requested network map and any error encountered.
|
|
//
|
|
// GetNetMap must return exactly one non-nil value.
|
|
// GetNetMap must return ErrNotFound if the network map is not in the storage.
|
|
//
|
|
// Implementations must not retain the network map pointer and modify
|
|
// the network map through it.
|
|
GetNetMap(ctx context.Context, diff uint64) (*netmap.NetMap, error)
|
|
|
|
// GetNetMapByEpoch reads network map by the epoch number from the storage.
|
|
// It returns the pointer to the requested network map and any error encountered.
|
|
//
|
|
// Must return exactly one non-nil value.
|
|
//
|
|
// Implementations must not retain the network map pointer and modify
|
|
// the network map through it.
|
|
GetNetMapByEpoch(ctx context.Context, epoch uint64) (*netmap.NetMap, error)
|
|
|
|
// Epoch reads the current epoch from the storage.
|
|
// It returns thw number of the current epoch and any error encountered.
|
|
//
|
|
// Must return exactly one non-default value.
|
|
Epoch(ctx context.Context) (uint64, error)
|
|
}
|
|
|
|
// GetLatestNetworkMap requests and returns the latest network map from the storage.
|
|
func GetLatestNetworkMap(ctx context.Context, src Source) (*netmap.NetMap, error) {
|
|
return src.GetNetMap(ctx, 0)
|
|
}
|
|
|
|
// GetPreviousNetworkMap requests and returns previous from the latest network map from the storage.
|
|
func GetPreviousNetworkMap(ctx context.Context, src Source) (*netmap.NetMap, error) {
|
|
return src.GetNetMap(ctx, 1)
|
|
}
|