forked from mtusi2026/mtusi2026lab5
35 lines
1.7 KiB
Go
35 lines
1.7 KiB
Go
// Package objectstore — хранилище байтов вложений. Интерфейс не зависит от конкретного сервера.
|
|
package objectstore
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"io"
|
|
"time"
|
|
)
|
|
|
|
// ErrNotFound — в bucket нет объекта. Метаданные пишутся после объекта, поэтому для существующего
|
|
// вложения это нарушение согласованности, а не обычная ошибка клиента.
|
|
var ErrNotFound = errors.New("objectstore: object not found")
|
|
|
|
// ObjectInfo — то, что очистителю нужно знать об объекте из листинга.
|
|
type ObjectInfo struct {
|
|
Key string
|
|
LastModified time.Time
|
|
}
|
|
|
|
type Store interface {
|
|
// Put передаёт объект потоком: size байт из body, без чтения всего файла в память.
|
|
Put(ctx context.Context, key, contentType string, body io.Reader, size int64) error
|
|
// Get возвращает поток и размер объекта. Поток обязательно закрыть.
|
|
Get(ctx context.Context, key string) (io.ReadCloser, int64, error)
|
|
Delete(ctx context.Context, key string) error
|
|
}
|
|
|
|
// Lister обходит объекты bucket. Право на листинг есть только у очистителя, поэтому метод вынесен
|
|
// из Store: API не может и не должно перечислять объекты.
|
|
type Lister interface {
|
|
// List вызывает visit для каждого объекта с заданным префиксом.
|
|
List(ctx context.Context, prefix string, visit func(ObjectInfo) error) error
|
|
}
|