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

Le package Blobstore fournit un client pour le service de stockage de blobs persistant d'App Engine.

Fonctions

func BlobKeyForFile

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

La fonction BlobKeyForFile renvoie une clé "BlobKey" pour un fichier Google Storage. Le nom de fichier respecter le format suivant : "/gs/nom_bucket/nom_objet".

func Delete

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

La fonction Delete permet d'effacer un objet blob.

func DeleteMulti

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

La fonction DeleteMulti permet d'effacer plusieurs objets blob.

func ParseUpload

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

La fonction ParseUpload analyse la requête POST synthétique que votre application obtient d'App Engine après l'importation réussie de blobs par un utilisateur. Compte tenu de la requête, ParseUpload affiche un mappage des blobs reçus (associés par le nom d'élément de formulaire HTML) et des paramètres POST autres que blob.

func Send

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

La fonction Send définit les en-têtes sur la réponse pour qu'App Engine envoie un blob en tant que corps de réponse. Cette méthode est plus efficace que la lecture et l'écriture manuelle, et n'est pas soumise aux limites de taille des réponses normales.

func UploadURL

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

La fonction UploadURL crée une URL d'importation pour le formulaire à remplir par l'utilisateur, en transmettant le chemin d'accès de l'application à charger lorsque la publication du formulaire est terminée. Ces URL expirent et ne doivent pas être réutilisées. Le paramètre "opts" peut être "nil".

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"`
}

Le type BlobInfo correspond aux métadonnées de blob stockées dans le datastore. Le nom de fichier peut être vide.

func Stat

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

La fonction Stat affiche l'objet BlobInfo d'un paramètre blobKey fourni. Si aucun objet blob n'est trouvé pour cette clé, la fonction Stat renvoie datastore.ErrNoSuchEntity.

Lecteur

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

Le type Reader représente un lecteur de blob.

func NewReader

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

La fonction NewReader affiche un lecteur pour un objet blob. L'opération réussit toujours. Si le blob n'existe pas, une erreur est signalée à la première lecture.

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
}

Le type UploadURLOptions représente les options permettant de créer une URL d'importation.