Files
mtusi2026lab5/app/internal/objectstore/objectstore.go
T

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
}