Every Blobstore value has a corresponding entity in the datastore containing information about the blob, such as its filename and size. The BlobInfo class provides a
interface to this read-only entity. You can retrieve BlobInfo objects using a Blobstore key.
BlobInfo is provided by the
- Class methods:
- Instance methods:
- Instance properties:
Every Blobstore value has a corresponding BlobInfo entity in the datastore that contains information about the blob, such as its filename and size. The Blobstore creates this entity when the blob is uploaded. Unlike other datastore entities, BlobInfo entities are read-only, and cannot be modified by the application.
An application can query for BlobInfo entities by their properties, and can fetch an entity using the Blobstore key. Note that a query over multiple properties on a BlobInfo entity may require a custom index, just as with other entities.
When a blob is uploaded, the Blobstore passes the metadata to the upload handler in the headers of the MIME part for the file. The upload handler can parse this information into a BlobInfo object without calling the datastore using the
function. If you're using the webapp or webapp2 application framework, you can
for more convenient parsing of this information.
The BlobInfo class has the following class methods:
Queryobject that represents all BlobInfo entities for the application. Methods on the Query object can apply filters and sort orders to the query before it is executed. See
Queryfor more information.
Gets the BlobInfo object (or objects) for the given
BlobKeyvalue, or a list of
If given a single
BlobKey, returns a
Noneif there is no Blobstore value for that key. If given a list of
BlobKeyvalues, returns a list with one value for each given key, each of which is either a
- BlobInfo.gql(query_string, *args, **kwds)
Performs a GQL query over
- The part of the GQL query following
SELECT * FROM model(which is implied by using this class method).
- Positional parameter bindings, similar to the
- Keyword parameter bindings, similar to the
The return value is a
GqlQueryobject, which can be used to access the results.
- Returns the kind name used for
- Returns a dictionary of all of the properties defined for
A BlobInfo instance has the following methods:
Deletes the Blobstore value represented by this BlobInfo object, and also deletes the corresponding BlobInfo entity from the datastore.
Deleting a Blobstore value occurs separately from datastore transactions. If you call this method during a datastore transaction, it takes effect immediately, regardless of whether the transaction commits successfully or is retried.
BlobKeyof the Blobstore value described by this
BlobReaderfor this blob.
- The MIME content type of the Blobstore value, as provided by the client that uploaded the value. A string.
- The date and time the Blobstore value was created. A
- The filename of the Blobstore value, as provided by the client that uploaded the value. A string.
- The size of the Blobstore value, as a number of bytes. An integer.
- The md5 hash value of the uploaded blob (in hex).