object

type CommonPrefix struct {
	Prefix string `xml:"Prefix"`
}

type CopyOption func(*CopyOptions)

type CopyOptions struct {
	// 源版本 ID
	SourceVersionID string

	// 目标元数据
	UserMetadata map[string]string
	UserTags     map[string]string

	// 替换元数据
	ReplaceMetadata bool
	ReplaceTagging  bool

	// 内容类型
	ContentType        string
	ContentEncoding    string
	ContentDisposition string
	CacheControl       string
	Expires            time.Time

	// 存储类
	StorageClass string

	// 匹配条件
	MatchETag     string
	NotMatchETag  string
	MatchModified time.Time
	NotModified   time.Time

	// 自定义头
	CustomHeaders http.Header
}

type DeleteOption func(*DeleteOptions)

type DeleteOptions struct {
	// 版本 ID
	VersionID string

	// 强制删除
	ForceDelete bool

	// 自定义头
	CustomHeaders http.Header
}

type GetOption func(*GetOptions)

type GetOptions struct {
	// Range 请求范围
	RangeStart int64
	RangeEnd   int64
	SetRange   bool

	// 版本 ID
	VersionID string

	// 匹配条件
	MatchETag     string
	NotMatchETag  string
	MatchModified time.Time
	NotModified   time.Time

	// 自定义头
	CustomHeaders http.Header
}

type ListBucketV2Result struct {
	XMLName               xml.Name           `xml:"ListBucketResult"`
	Name                  string             `xml:"Name"`
	Prefix                string             `xml:"Prefix"`
	KeyCount              int                `xml:"KeyCount"`
	MaxKeys               int                `xml:"MaxKeys"`
	Delimiter             string             `xml:"Delimiter"`
	IsTruncated           bool               `xml:"IsTruncated"`
	Contents              []types.ObjectInfo `xml:"Contents"`
	CommonPrefixes        []CommonPrefix     `xml:"CommonPrefixes"`
	ContinuationToken     string             `xml:"ContinuationToken"`
	NextContinuationToken string             `xml:"NextContinuationToken"`
	StartAfter            string             `xml:"StartAfter"`
}

type ListOption func(*ListOptions)

type ListOptions struct {
	// 前缀
	Prefix string

	// 递归列出
	Recursive bool

	// 最大键数
	MaxKeys int

	// 起始位置
	StartAfter string

	// 使用 V2 API
	UseV2 bool

	// 包含版本
	WithVersions bool

	// 包含元数据
	WithMetadata bool

	// 自定义头
	CustomHeaders http.Header
}

type PutOption func(*PutOptions)

type PutOptions struct {
	// 内容类型
	ContentType string

	// 内容编码
	ContentEncoding string

	// 内容处置
	ContentDisposition string

	// 内容语言
	ContentLanguage string

	// 缓存控制
	CacheControl string

	// 过期时间
	Expires time.Time

	// 用户元数据
	UserMetadata map[string]string

	// 用户标签
	UserTags map[string]string

	// 存储类
	StorageClass string

	// 自定义头
	CustomHeaders http.Header

	// 发送 Content-MD5
	SendContentMD5 bool

	// 禁用 Content-SHA256
	DisableContentSHA256 bool

	// 分片大小
	PartSize uint64

	// 并发数
	NumThreads uint
}

type Service interface {
	// Put 上传对象
	Put(ctx context.Context, bucketName, objectName string, reader io.Reader, objectSize int64, opts ...PutOption) (types.UploadInfo, error)

	// Get 下载对象
	Get(ctx context.Context, bucketName, objectName string, opts ...GetOption) (io.ReadCloser, types.ObjectInfo, error)

	// Stat 获取对象信息
	Stat(ctx context.Context, bucketName, objectName string, opts ...StatOption) (types.ObjectInfo, error)

	// Delete 删除对象
	Delete(ctx context.Context, bucketName, objectName string, opts ...DeleteOption) error

	// List 列出对象
	List(ctx context.Context, bucketName string, opts ...ListOption) <-chan types.ObjectInfo

	// Copy 复制对象
	Copy(ctx context.Context, destBucket, destObject, srcBucket, srcObject string, opts ...CopyOption) (types.CopyInfo, error)
}

type StatOption func(*StatOptions)

type StatOptions struct {
	// 版本 ID
	VersionID string

	// 自定义头
	CustomHeaders http.Header
}