26b7fe4a91
After consideration, we've changed the main descriptor field name to for number of bytes to "size" to match convention. While this may be a subjective argument, commonly we refer to files by their "size" rather than their "length". This will match other conventions, like `(FileInfo).Size()` and methods on `io.SizeReaderAt`. Under more broad analysis, this argument doesn't necessarily hold up. If anything, "size" is shorter than "length". Signed-off-by: Stephen J Day <stephen.day@docker.com>
35 lines
908 B
Go
35 lines
908 B
Go
// Package cache provides facilities to speed up access to the storage
|
|
// backend.
|
|
package cache
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"github.com/docker/distribution"
|
|
)
|
|
|
|
// BlobDescriptorCacheProvider provides repository scoped
|
|
// BlobDescriptorService cache instances and a global descriptor cache.
|
|
type BlobDescriptorCacheProvider interface {
|
|
distribution.BlobDescriptorService
|
|
|
|
RepositoryScoped(repo string) (distribution.BlobDescriptorService, error)
|
|
}
|
|
|
|
// ValidateDescriptor provides a helper function to ensure that caches have
|
|
// common criteria for admitting descriptors.
|
|
func ValidateDescriptor(desc distribution.Descriptor) error {
|
|
if err := desc.Digest.Validate(); err != nil {
|
|
return err
|
|
}
|
|
|
|
if desc.Size < 0 {
|
|
return fmt.Errorf("cache: invalid length in descriptor: %v < 0", desc.Size)
|
|
}
|
|
|
|
if desc.MediaType == "" {
|
|
return fmt.Errorf("cache: empty mediatype on descriptor: %v", desc)
|
|
}
|
|
|
|
return nil
|
|
}
|