minio/pkg/storage/storage.go

/*
 * Mini Object Storage, (C) 2014 Minio, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package storage

import (
	"io"
	"regexp"
	"time"
)

type Storage interface {
	// Bucket Operations
	ListBuckets(prefix string) ([]BucketMetadata, error)
	StoreBucket(bucket string) error

	// Object Operations
	CopyObjectToWriter(w io.Writer, bucket string, object string) (int64, error)
	GetObjectMetadata(bucket string, object string) (ObjectMetadata, error)
	ListObjects(bucket, prefix string, count int) ([]ObjectMetadata, bool, error)
	StoreObject(bucket string, key string, data io.Reader) error
}

type BucketMetadata struct {
	Name    string
	Created time.Time
}

type ObjectMetadata struct {
	Bucket  string
	Key     string
	Created time.Time
	Size    int
	ETag    string
}

func IsValidBucket(bucket string) bool {
	if len(bucket) < 3 || len(bucket) > 63 {
		return false
	}
	if bucket[0] == '.' || bucket[len(bucket)-1] == '.' {
		return false
	}
	if match, _ := regexp.MatchString("\\.\\.", bucket); match == true {
		return false
	}
	match, _ := regexp.MatchString("^[a-zA-Z][a-zA-Z0-9\\.\\-]+[a-zA-Z0-9]$", bucket)
	return match
}