Le package Blobstore fournit un client pour le service de stockage de blobs persistant d'App Engine.
Fonctions
func BlobKeyForFile
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
La fonction Delete permet d'effacer un objet blob.
func DeleteMulti
La fonction DeleteMulti permet d'effacer plusieurs objets blob.
func ParseUpload
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
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
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
Le type Reader représente un lecteur de blob.
func NewReader
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.