Paket google.golang.org/appengine/blobstore (v1.6.8)

Das Paket "blobstore" bietet einen Client für den persistenten Blob-Speicherdienst von App Engine.

Funktionen

func BlobKeyForFile 

func BlobKeyForFile(c context.Context, filename string) (appengine.BlobKey, error)

BlobKeyForFile gibt einen BlobKey für eine Google Storage-Datei zurück. Der Dateiname muss das Format "/gs/Bucket-Name/Objektname" haben.

func Delete 

func Delete(c context.Context, blobKey appengine.BlobKey) error

"Delete" löscht einen Blob.

func DeleteMulti 

func DeleteMulti(c context.Context, blobKey []appengine.BlobKey) error

"DeleteMulti" löscht mehrere Blobs.

func ParseUpload 

func ParseUpload(req *http.Request) (blobs map[string][]*BlobInfo, other url.Values, err error)

"ParseUpload" analysiert die synthetische POST-Anfrage, die Ihre Anwendung nach dem erfolgreichen Hochladen von Blobs durch einen Nutzer von App Engine empfängt. Bei dieser Anfrage gibt "ParseUpload" eine Zuordnung der empfangenen Blobs (mit dem Namen des HTML-Formularelements als Schlüssel) und anderer nicht Blob-bezogener POST-Parameter zurück.

func Send 

func Send(response http.ResponseWriter, blobKey appengine.BlobKey)

"Send" legt die Header für die Antwort fest, um App Engine anzuweisen, einen Blob als Antworttext zu senden. Diese Vorgehensweise ist effizienter als das manuelle Lesen und Schreiben und unterliegt nicht den normalen Limits für die Größe der Antwort.

func UploadURL 

func UploadURL(c context.Context, successPath string, opts *UploadURLOptions) (*url.URL, error)

"UploadURL" erstellt eine Upload-URL für das Formular, das der Nutzer ausfüllt, indem der zu ladende Anwendungspfad bei Abschluss des POST-Teils des Formulars übergeben wird. Diese URLs laufen ab und sollten nicht wiederverwendet werden. Der Parameter "opts" kann null sein.

BlobInfo

type BlobInfo struct {
	BlobKey      appengine.BlobKey
	ContentType  string    `datastore:"content_type"`
	CreationTime time.Time `datastore:"creation"`
	Filename     string    `datastore:"filename"`
	Size         int64     `datastore:"size"`
	MD5          string    `datastore:"md5_hash"`

	// ObjectName is the Google Cloud Storage name for this blob.
	ObjectName string `datastore:"gs_object_name"`
}

BlobInfo sind die im Datenspeicher gespeicherten Blob-Metadaten. Der Dateiname kann leer sein.

func Stat 

func Stat(c context.Context, blobKey appengine.BlobKey) (*BlobInfo, error)

"Stat" gibt die "BlobInfo" für einen angegebenen "blobKey" zurück. Wenn kein Blob für den betreffenden Schlüssel gefunden wurde, gibt "Stat" "datastore.ErrNoSuchEntity" zurück.

Leser

type Reader interface {
	io.Reader
	io.ReaderAt
	io.Seeker
}

"Reader" ist ein Blob-Reader.

func NewReader 

func NewReader(c context.Context, blobKey appengine.BlobKey) Reader

"NewReader" gibt einen Reader für einen Blob zurück. Die Funktion übergibt immer ein Ergebnis: Wenn der Blob nicht vorhanden ist, wird beim ersten Lesen ein Fehler gemeldet.

UploadURLOptions

type UploadURLOptions struct {
	MaxUploadBytes        int64 // optional
	MaxUploadBytesPerBlob int64 // optional

	// StorageBucket specifies the Google Cloud Storage bucket in which
	// to store the blob.
	// This is required if you use Cloud Storage instead of Blobstore.
	// Your application must have permission to write to the bucket.
	// You may optionally specify a bucket name and path in the format
	// "bucket_name/path", in which case the included path will be the
	// prefix of the uploaded object's name.
	StorageBucket string
}

UploadURLOptions sind die Optionen zum Erstellen einer Upload-URL.