Package blobstore provides a client for App Engine's persistent blob storage service.
Functions
func BlobKeyForFile
BlobKeyForFile returns a BlobKey for a Google Storage file. The filename should be of the form "/gs/bucket_name/object_name".
func Delete
Delete deletes a blob.
func DeleteMulti
DeleteMulti deletes multiple blobs.
func ParseUpload
func
ParseUpload
(
req
*
http
.
Request
)
(
blobs
map
[
string
]
[]
*
BlobInfo
,
other
url
.
Values
,
err
error
)
ParseUpload parses the synthetic POST request that your app gets from App Engine after a user's successful upload of blobs. Given the request, ParseUpload returns a map of the blobs received (keyed by HTML form element name) and other non-blob POST parameters.
func Send
func
Send
(
response
http
.
ResponseWriter
,
blobKey
appengine
.
BlobKey
)
Send sets the headers on response to instruct App Engine to send a blob as the response body. This is more efficient than reading and writing it out manually and isn't subject to normal response size limits.
func UploadURL
func
UploadURL
(
c
context
.
Context
,
successPath
string
,
opts
*
UploadURLOptions
)
(
*
url
.
URL
,
error
)
UploadURL creates an upload URL for the form that the user will fill out, passing the application path to load when the POST of the form is completed. These URLs expire and should not be reused. The opts parameter may be 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"
`
}
BlobInfo is the blob metadata that is stored in the datastore. Filename may be empty.
func Stat
Stat returns the BlobInfo for a provided blobKey. If no blob was found for that key, Stat returns datastore.ErrNoSuchEntity.
Reader
Reader is a blob reader.
func NewReader
NewReader returns a reader for a blob. It always succeeds; if the blob does not exist then an error will be reported upon first read.
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 are the options to create an upload URL.
