Hinweis: Python 2.7 hat am 31. Januar 2024 das Ende des Supports erreicht. Ihre vorhandenen Python 2.7-Anwendungen werden weiterhin ausgeführt und erhalten Traffic. App Engine kann die erneute Bereitstellung von Anwendungen, die Laufzeiten verwenden, jedoch nach dem Enddatum des Supports blockieren. Wir empfehlen die Migration zur neuesten unterstützten Version von Python.

Modul "google.appengine.ext.blobstore.blobstore"

Übersicht

Eine von Anwendungsentwicklern verwendete Python Blobstore API.

Dieses Modul enthält Methoden zum Herstellen einer Schnittstelle mit der Blobstore API. Das Modul enthält eine db.Model-ähnliche Klasse, die einen Verweis auf ein sehr großes Blob darstellt. Das Modul importiert eine db.Key-ähnliche Klasse, die einen Blob-Schlüssel darstellt.

Inhalt

Ausnahme google.appengine.ext.blobstore.blobstore.BlobFetchSizeTooLargeErrorQuelle

Basiert auf: google.appengine.api.blobstore.blobstore.Error

Der Block konnte nicht abgerufen werden, da er zu groß war.

Klasse google.appengine.ext.blobstore.blobstore.BlobInfo(entity_or_blob_key, _values=None)Quelle

Basiert auf: object

Informationen zu Blobs in Blobstore.

Dies ist eine db.Model-ähnliche Klasse, die Informationen zu Blobs enthält, die von einer Anwendung gespeichert werden. Wie db.Model wird diese Klasse von einer Datenspeicherentität unterstützt. BlobInfo-Instanzen sind jedoch schreibgeschützt und haben eine viel eingeschränktere Schnittstelle.

Jeder BlobInfo ist ein Schlüssel vom Typ BlobKey zugeordnet. Dieser Schlüssel ist für die Blobstore API spezifisch und nicht mit db.get kompatibel. Der Schlüssel kann für eine schnelle Suche verwendet werden, indem er an BlobInfo.get übergeben wird. Dieser Schlüssel kann mühelos in einen websicheren String umgewandelt werden, der in URLs eingebettet werden kann.

Attribute:

content_type: Der Inhaltstyp des Blobs.
creation: Das Erstellungsdatum des Blobs oder der Zeitpunkt des Uploads.
filename: Der Dateiname, den der Nutzer von seinem Computer ausgewählt hat.
size: Die Größe des unkomprimierten Blobs.
md5_hash: Der MD5-Hashwert des hochgeladenen Blobs.

gs_object_name: Der Name des Objekts, wenn das Blob: im Format /[bucket-name]/[object-name] in Google Cloud Storage gespeichert wurde.

Alle Attribute sind schreibgeschützt. Bei dem Versuch, einen Wert einem Attribut zuzuweisen, wird ein NotImplementedError ausgegeben.

Klassenmethode all()Quelle

Erstellt eine Abfrage für alle BlobInfo-Objekte, die der Anwendung zugeordnet sind.

Gibt zurück

Ein db.Query-Objekt, das die Datenspeicherart von BlobInfo abfragt.

content_type

Gibt den Inhaltstyp des Blobs zurück.

Gibt zurück

Den Inhaltstyp des Blobs.

creation

Gibt das Erstellungsdatum oder den Zeitpunkt des Uploads für den Blob zurück.

Gibt zurück

Das Erstellungsdatum oder den Zeitpunkt des Uploads für den Blob.

delete(_token=None)Quelle: Löscht ein Blob dauerhaft aus Blobstore.

filename

Gibt den Dateinamen zurück, den der Nutzer von seinem Computer ausgewählt hat.

Gibt zurück

Den Dateinamen, den der Nutzer ausgewählt hat.

Klassenmethode from_entity(entity)Quelle

Konvertiert eine Entität in BlobInfo.

Parameter

entity – Die Entität, die Sie umwandeln möchten.

Gibt zurück

Die BlobInfo, in die die Entität umgewandelt wurde.

Klassenmethode get(blob_keys)Quelle

Ruft eine BlobInfo nach Schlüssel oder Schlüsselliste ab.

Parameter

blob_keys – Ein Schlüssel oder eine Liste von Schlüsseln. Schlüssel können als String, Unicode oder BlobKey formatiert sein.

Gibt zurück

Eine BlobInfo-Instanz, die dem bereitgestellten Schlüssel zugeordnet ist, oder eine Liste mit BlobInfo-Instanzen, wenn eine Liste mit Schlüsseln bereitgestellt wurde. Für nicht in Blobstore gefundene Schlüssel wird None zurückgegeben.

Klassenmethode gql(query_string, *args, **kwds)Quelle

Gibt eine Abfrage mit einem GQL-Abfragestring zurück.

Weitere Informationen zu GQL finden Sie unter GQL source.

Parameter

query_string – Ein ordnungsgemäß formatierter GQL-Abfragestring ohne SELECT * FROM <entity>
*args – Rest der Positionsargumente, die zum Binden von numerischen Referenzen in der Abfrage verwendet werden.
**kwds – Wörterbuchbasierte Argumente für benannte Parameter.

Gibt zurück

Ein gql.GqlQuery-Objekt, das die Datenspeicherart von BlobInfo abfragt.

gs_object_name

key()Quelle

Ruft den Schlüssel für ein Blob ab.

Gibt zurück

Die BlobKey-Instanz, die dieses Blob identifiziert.

classmethod kind()source

Ruft die Art der Entität für die BlobInfo ab.

Gibt zurück

Der Entitätstyp für BlobInfo.

md5_hash

Gibt den MD5-Hashwert des unkomprimierten Blobs zurück.

Gibt zurück

Den Hashwert des unkomprimierten Blobs.

open(*args, **kwargs)Quelle

Gibt einen BlobReader für dieses Blob zurück.

Parameter

*args – An den BlobReader-Konstruktor zu übergebende Argumente.
**kwargs – Schlüsselwortargumente, die an den BlobReader-Konstruktor übergeben werden sollen.

Gibt zurück

Eine BlobReader-Instanz.

Klassenmethode properties()Quelle

Definiert die Attribute, die zu BlobInfo gehören.

Gibt zurück

Alle Attribute, die zu BlobInfo gehören.

Größe

Gibt die Größe des unkomprimierten Blobs zurück.

Gibt zurück

Die Größe des unkomprimierten Blobs.

Ausnahme google.appengine.ext.blobstore.blobstore.BlobInfoParseErrorQuelle

Basiert auf: google.appengine.api.blobstore.blobstore.Error

Der CGI-Parameter enthält keinen gültigen BlobInfo-Datensatz.

Klasse google.appengine.ext.blobstore.blobstore.BlobKey(blob_key)Quelle

Basiert auf: object

Schlüssel zum Identifizieren eines Blobs in Blobstore.

Dieses Objekt bettet einen String ein, der von der Blobstore API intern verwendet wird, um Anwendungs-Blobs zu identifizieren. Der BlobKey entspricht dem Entitätsnamen der zugrunde liegenden BlobReference-Entität.

Diese Klasse wird in der API sowohl in google.appengine.ext.db als auch in google.appengine.ext.blobstore zur Verfügung gestellt.

ToXml()source

Klasse google.appengine.ext.blobstore.blobstore.BlobMigrationRecord(parent=None, key_name=None, _app=None, _from_entity=False, **kwds)Quelle

Basis: google.appengine.ext.db.Model

Definiert ein Modell, das das Ergebnis einer Blob-Migration aufzeichnet.

Klassenmethode get_by_blob_key(old_blob_key)Quelle

Ruft den BlobMigrationRecord für den jeweiligen Blobschlüssel ab.

Parameter

old_blob_key – Der Blob-Schlüssel, der in der vorherigen Anwendung verwendet wurde.

Gibt zurück

Eine Instanz von blobstore.BlobMigrationRecord oder None.

Klassenmethode get_new_blob_key(old_blob_key)Quelle

Sucht den neuen Schlüssel für ein Blob.

Parameter

old_blob_key – Der ursprüngliche Blob-Schlüssel.

Gibt zurück

Der blobstore.BlobKey des migrierten Blobs.

classmethod kind()source

Gibt die Art des Blobs an, das Sie migrieren.

Gibt zurück

Die Art des Blobs, das Sie migrieren.

new_blob_ref

Mit db.Model-Klassen kompatibles Attribut

So fügen Sie mithilfe von BlobReferenceProperty Verweise von Blobs zu Domainmodellen hinzu:

class Picture(db.Model):
  title = db.StringProperty()
  image = blobstore.BlobReferenceProperty()
  thumbnail = blobstore.BlobReferenceProperty()

So ermitteln Sie die Größe eines Bildes mit diesem Modell:

picture = Picture.get(picture_key)
print picture.image.size

BlobInfo-Objekte werden langsam geladen, damit die Iteration über Modelle für BlobKeys effizient ist. Der folgende Beispielcode muss nicht für jeden Bildschlüssel einen Treffer im Datenspeicher erzielen:

list_of_untitled_blobs = []
for picture in Picture.gql("WHERE title=''"):
  list_of_untitled_blobs.append(picture.image.key())

Ausnahme google.appengine.ext.blobstore.blobstore.BlobNotFoundErrorQuelle

Basiert auf: google.appengine.api.blobstore.blobstore.Error

Das Blob ist nicht vorhanden.

Klasse google.appengine.ext.blobstore.blobstore.BlobReferenceProperty(verbose_name=None, name=None, default=None, required=False, validator=None, choices=None, indexed=True)Quelle

Basiert auf: google.appengine.ext.db.Property

Mit db.Model-Klassen kompatibles Attribut

So fügen Sie mithilfe von BlobReferenceProperty Verweise von Blobs zu Domainmodellen hinzu:

class Picture(db.Model):
  title = db.StringProperty()
  image = blobstore.BlobReferenceProperty()
  thumbnail = blobstore.BlobReferenceProperty()

So ermitteln Sie die Größe eines Bildes mit diesem Modell:

picture = Picture.get(picture_key)
print picture.image.size

list_of_untitled_blobs = []
for picture in Picture.gql("WHERE title=''"):
  list_of_untitled_blobs.append(picture.image.key())

data_type: Alias von BlobInfo

get_value_for_datastore(model_instance)Quelle

Gibt eine Modell-Property zurück, die in einen Datenspeicherwert übersetzt wurde.

Parameter

model_instance – Die Modell-Property, die übersetzt werden soll.

Gibt zurück

Die Modell-Property, die aus dem Datenspeicher übersetzt wurde.

make_value_from_datastore(value)Quelle

Gibt einen Datenspeicherwert an BlobInfo zurück.

Parameter

value – Der Datenspeicherwert, den Sie übersetzen möchten.

Gibt zurück

Eine BlobInfo, die aus dem Datenspeicher übersetzt wurde.

validate(value)Quelle

Validiert, dass ein zugewiesener Wert BlobInfo ist.

Diese Methode wandelt Strings und BlobKey-Instanzen automatisch um.

Parameter

value – Der Wert, den Sie validieren möchten.

Gibt zurück

Information darüber, ob ein zugewiesener Wert BlobInfo ist.

Klasse google.appengine.ext.blobstore.blobstore.BlobReader(blob, buffer_size=131072, position=0)Quelle

Basiert auf: object

Stellt eine schreibgeschützte dateiähnliche Schnittstelle zu einem Blobstore-Blob bereit.

SEEK_CUR = 1

SEEK_END = 2

SEEK_SET = 0

blob_info

Gibt die BlobInfo für diese Datei zurück.

Gibt zurück

Einen String, der das BlobInfo enthält.

close()Quellcode

Schließt die Datei.

Eine geschlossene Datei kann nicht mehr gelesen oder beschrieben werden. Ein Vorgang, der erfordert, dass die Datei geöffnet ist, gibt einen ValueError aus, nachdem die Datei geschlossen wurde. Das mehrmalige Aufrufen von close() ist zulässig.

geschlossen

Bestimmt, ob eine Datei geschlossen ist.

Gibt zurück

True, wenn diese Datei geschlossen ist; geöffnete Dateien geben False zurück.

flush()Quelle

next()Quelle

Gibt die nächste Zeile aus der Datei zurück.

Gibt zurück

Einen String, der mit \n endet. Die letzte Zeile darf nicht mit \n enden. Wenn das Ende der Datei erreicht ist, wird eine leere Zeichenfolge zurückgegeben.

Löst aus

StopIteration – Wenn keine weiteren Zeilen zu lesen sind.

read(size=-1)Quelle

Liest höchstens size Byte aus der Datei.

Es werden weniger Byte gelesen, wenn der Lesevorgang das Ende der Datei erreicht, bevor size Byte verbraucht wurden. Wenn das Argument size negativ ist oder ausgelassen wird, werden alle Daten gelesen, bis das Ende der Datei erreicht ist. Die Byte werden als Stringobjekt zurückgegeben. Ein leerer String wird sofort zurückgegeben, wenn das Ende der Datei erreicht ist.

Wenn read() ohne Angabe von size aufgerufen wird, ist Vorsicht geboten, da möglicherweise zu viele Daten gelesen werden.

Parameter

size – Optional. Die maximale Anzahl der zu lesenden Byte. Wenn ausgelassen, gibt read() alle in der Datei verbleibenden Daten zurück.

Gibt zurück

Die gelesenen Daten als String.

readline(size=-1)Quelle

Liest eine ganze Zeile aus der Datei.

Ein nachgestelltes Zeilenumbruchzeichen wird im String beibehalten, kann aber fehlen, wenn eine Datei mit einer unvollständigen Zeile endet. Wenn das Argument size vorhanden und nicht negativ ist, stellt es eine maximale Bytezahl dar, einschließlich des nachgestellten Zeilenumbruchs. Möglicherweise wird auch eine unvollständige Zeile zurückgegeben. Ein leerer String wird nur dann sofort zurückgegeben, wenn das Ende der Datei erreicht wurde.

Parameter

size – Optional. Die maximale Anzahl der zu lesenden Byte.

Gibt zurück

Die gelesenen Daten als String.

readlines(sizehint=None)Quelle

Liest bis zum Ende der Datei mit readline().

Eine Liste der gelesenen Zeilen wird zurückgegeben.

Wenn das optionale Argument sizehint vorhanden ist, wird nicht bis zum Ende der Datei gelesen. Stattdessen werden ganze Zeilen gelesen, die insgesamt ungefähr sizehint Byte entsprechen. Der Lesevorgang erfolgt möglicherweise nach Rundung auf eine interne Puffergröße.

Parameter

sizehint – Ein Hinweis auf die maximale Anzahl der zu lesenden Byte.

Gibt zurück

Eine Liste von Strings, wobei jede eine einzelne Zeile aus der Datei darstellt.

seek(offset, whence=0)Quelle

Legt die aktuelle Position der Datei fest, wie z. B. fseek() von stdio.

Parameter

offset – Das relative Offset, zu dem gesprungen werden soll.
whence – Optional. Definiert, zu welchem Wert das Offset relativ ist. Dieses Argument nutzt standardmäßig os.SEEK_SET oder 0, um die absolute Dateiposition zu verwenden. Andere gültige Werte sind os.SEEK_CUR oder 1, um relativ zur aktuellen Position zu suchen, und os.SEEK_END oder 2, um relativ zum Ende der Datei zu suchen.

tell()Quellcode

Ruft die aktuelle Position der Datei ab, wie z. B. ftell() von stdio.

Gibt zurück

Die aktuelle Position der Datei.

truncate(size)Quelle

Gibt einen Fehler aus, wenn versucht wird, die Datei zu kürzen.

Parameter

size – Die Größe, auf die Sie die Datei kürzen möchten.

Löst aus

IOError – Wenn Sie versuchen, eine Datei in BlobReader zu kürzen.

write(str)Quelle

Gibt einen Fehler aus, wenn Sie versuchen, in die Datei zu schreiben.

Parameter

str – Der String, in den Sie schreiben möchten.

Löst aus

IOError – Wenn Sie versuchen, in eine Datei in BlobReader zu schreiben.

writelines(sequence)Quelle

Gibt einen Fehler aus, wenn Sie versuchen, in die Datei zu schreiben.

Parameter

sequence – Die Reihenfolge der Strings, die Sie schreiben möchten.

Löst aus

IOError – Wenn Sie versuchen, Zeilen in eine Datei in BlobReader zu schreiben.

Klasse google.appengine.ext.blobstore.blobstore.FileInfo(filename=None, content_type=None, creation=None, size=None, md5_hash=None, gs_object_name=None)Quelle

Basiert auf: object

Enthält Informationen zu hochgeladenen Dateien.

Diese Klasse enthält Informationen zu Blobs, die von einer Anwendung gespeichert werden.

Diese Klasse ähnelt BlobInfo. Die Methode verwendet jedoch keinen Schlüssel und die Informationen werden nicht im Datenspeicher gespeichert.

Attribute:

content_type: Der Inhaltstyp der hochgeladenen Datei.
creation: Das Erstellungsdatum der hochgeladenen Datei oder wann sie hochgeladen

wurde.
filename: Der Dateiname, den der Nutzer von seinem Computer ausgewählt hat.
size: Die Größe der unkomprimierten Datei.
md5_hash: Der MD5-Hashwert der hochgeladenen Datei.
gs_object_name: Der Name der Datei, die in Google Cloud Storage geschrieben wurde, oder None, wenn die Datei nicht in Google Cloud Storage hochgeladen wurde.

Alle Attribute sind schreibgeschützt. Bei dem Versuch, einen Wert einem Attribut zuzuweisen, wird ein AttributeError ausgegeben.

content_type

Gibt den Inhaltstyp der hochgeladenen Datei zurück.

Gibt zurück

Den Inhaltstyp der Datei.

creation

Gibt das Erstellungsdatum oder den Zeitpunkt des Uploads der Datei zurück.

Gibt zurück

Das Erstellungsdatum oder den Zeitpunkt des Uploads der Datei.

filename

Gibt den Dateinamen zurück, den der Nutzer ausgewählt hat.

Gibt zurück

Den Dateinamen, den der Nutzer ausgewählt hat.

gs_object_name

Gibt den Namen der Datei zurück, die in Cloud Storage geschrieben wurde.

Gibt zurück

Den Namen der Datei, die in Cloud Storage geschrieben wurde.

md5_hash

Gibt den MD5-Hashwert der hochgeladenen Datei zurück.

Gibt zurück

Den Hashwert für die hochgeladene Datei.

Größe

Gibt die Größe der unkomprimierten Datei zurück.

Gibt zurück

Die Größe der unkomprimierten Datei.

Ausnahme google.appengine.ext.blobstore.blobstore.FileInfoParseErrorQuelle

Basiert auf: google.appengine.api.blobstore.blobstore.Error

Der CGI-Parameter enthält keinen gültigen FileInfo-Datensatz.

Ausnahme google.appengine.ext.blobstore.blobstore.DataIndexOutOfRangeErrorQuelle

Basiert auf: google.appengine.api.blobstore.blobstore.Error

Auf die Indexe konnte nicht zugegriffen werden.

Die angegebenen Indexe waren außerhalb des zulässigen Bereichs oder in der falschen Reihenfolge.

Ausnahme google.appengine.ext.blobstore.blobstore.PermissionDeniedErrorQuelle

Basiert auf: google.appengine.api.blobstore.blobstore.Error

Der Vorgang wurde nicht abgeschlossen. Überprüfen Sie die erforderlichen Berechtigungen.

Ausnahme google.appengine.ext.blobstore.blobstore.ErrorQuelle

Basiert auf: exceptions.Exception

Grundlegender Blobstore-Fehlertyp

Ausnahme google.appengine.ext.blobstore.blobstore.InternalErrorQuelle

Basiert auf: google.appengine.api.blobstore.blobstore.Error

Ein interner Fehler ist aufgetreten.

google.appengine.ext.blobstore.blobstore.create_rpc(deadline=None, callback=None)Quelle

Erstellt ein RPC-Objekt zur Verwendung mit der Blobstore API.

Parameter

deadline: Optionale Frist für den Vorgang. Der Standardwert ist eine systemspezifische Frist, die normalerweise 5 Sekunden beträgt.
callback: Optionales bei Abschluss auszuführendes Callable.

Gibt zurück

Ein apiproxy_stub_map.UserRPC-Objekt, das speziell für diesen Dienst gilt.

google.appengine.ext.blobstore.blobstore.create_upload_url(success_path, max_bytes_per_blob=None, max_bytes_total=None, rpc=None, gs_bucket_name=None)Quelle

Erstellt die Upload-URL für ein POST-Formular.

Parameter

success_path: Pfad innerhalb der Anwendung, der aufgerufen wird, wenn der POST-Aufruf erfolgreich war und das Upload abgeschlossen ist.
max_bytes_per_blob – Die maximale Größe in Byte für ein einzelnes Blob im Upload bzw. None, wenn keine maximale Größe vorhanden ist.
max_bytes_total – Die maximale Größe in Byte aller Blobs im Upload bzw. None, wenn keine maximale Größe vorhanden ist.
rpc – Optionales UserRPC-Objekt.
gs_bucket_name: Der Name des Google Cloud Storage-Buckets, in den die Blobs hochgeladen werden sollen. Das Dienstkonto der Anwendung muss die entsprechenden Berechtigungen zum Schreiben in diesen Bucket haben. Der Bucket-Name kann das Format bucket/path/ haben. In diesem Fall wird der enthaltene Pfad dem Namen des hochgeladenen Objekts vorangestellt.

Gibt zurück

Upload-URL

Löst aus

TypeError – Wenn max_bytes_per_blob oder max_bytes_total keine Integrationstypen sind.
ValueError – Wenn max_bytes_per_blob oder max_bytes_total keine positiven Werte sind.

google.appengine.ext.blobstore.blobstore.create_upload_url_async(success_path, max_bytes_per_blob=None, max_bytes_total=None, rpc=None, gs_bucket_name=None)Quelle

Erstellt asynchron die Upload-URL für ein POST-Formular.

Parameter

success_path: Pfad innerhalb der Anwendung, der aufgerufen wird, wenn der POST-Aufruf erfolgreich war und das Upload abgeschlossen ist.
max_bytes_per_blob – Die maximale Größe in Byte für ein einzelnes Blob im Upload bzw. None, wenn keine maximale Größe vorhanden ist.
max_bytes_total – Die maximale Größe in Byte aller Blobs im Upload bzw. None, wenn keine maximale Größe vorhanden ist.
rpc – Optionales UserRPC-Objekt.
gs_bucket_name: Der Name des Google Cloud Storage-Buckets, in den die Blobs hochgeladen werden sollen. Das Dienstkonto der Anwendung muss die entsprechenden Berechtigungen zum Schreiben in diesen Bucket haben. Der Bucket-Name kann das Format bucket/path/ haben. In diesem Fall wird der enthaltene Pfad dem Namen des hochgeladenen Objekts vorangestellt.

Gibt zurück

UserRPC, dessen Ergebnis die Upload-URL ist

Löst aus

TypeError – Wenn max_bytes_per_blob oder max_bytes_total keine Integrationstypen sind.
ValueError – Wenn max_bytes_per_blob oder max_bytes_total keine positiven Werte sind.

google.appengine.ext.blobstore.blobstore.delete(blob_keys, rpc=None, _token=None)Quelle

Löscht ein Blob aus Blobstore.

Parameter

blob_keys – Einzelne BlobKey-Instanz oder Liste mit Blob-Schlüsseln. Ein Blob-Schlüssel kann entweder ein String oder eine Instanz von BlobKey sein.
rpc – Optionales UserRPC-Objekt.

Gibt zurück

Nichts

google.appengine.ext.blobstore.blobstore.delete_async(blob_keys, rpc=None, _token=None)Quelle

Löscht asynchron ein Blob aus Blobstore.

Parameter

blob_keys – Einzelne BlobKey-Instanz oder Liste mit Blob-Schlüsseln. Ein Blob-Schlüssel kann entweder ein String oder eine Instanz von BlobKey sein.
rpc – Optionales UserRPC-Objekt.

Gibt zurück

Ein UserRPC, dessen Ergebnis None ist.

google.appengine.ext.blobstore.blobstore.fetch_data(blob, start_index, end_index, rpc=None)Quelle

Ruft Daten für ein Blob ab.

Ruft ein Fragment eines Blobs bis zur Länge MAX_BLOB_FETCH_SIZE ab. Wenn Sie versuchen, ein Fragment abzurufen, das über die Grenzen des Blobs hinausreicht, wird die Datenmenge ab start_index bis zum Ende des Blobs zurückgegeben. Diese Menge ist kleiner als die angeforderte Größe. Wenn Sie ein Fragment anfordern, das vollständig außerhalb der Grenzen des Blobs liegt, wird ein leerer String zurückgegeben. Der Versuch, einen negativen Index abzurufen, löst eine Ausnahme aus.

Parameter

blob – Eine BlobInfo-, BlobKey-, String- oder Unicode-Darstellung des BlobKey des Blobs, aus dem Sie Daten abrufen möchten.
start_index – Der Startindex der abzurufenden Blob-Daten. Dieser Wert darf nicht negativ sein.
end_index – Der Endindex (einschließlich) der abzurufenden Blob-Daten. Dieser Wert muss größer oder gleich start_index sein.
rpc – Optionales UserRPC-Objekt.

Gibt zurück

Einen String, der einen Teil der Daten eines Blobs enthält. Wenn die Indexe zwar zulässig sind, aber außerhalb der Grenzen des Blobs liegen, wird ein leerer String zurückgegeben.

Löst aus

TypeError – Wenn start_index oder end_index keine Indexe sind oder blob kein String ist, BlobKey oder BlobInfo.
DataIndexOutOfRangeError – Wenn start_index auf einen Wert gesetzt ist, der kleiner als 0 ist, oder end_index kleiner als start_index ist.
BlobFetchSizeTooLargeError – Wenn das angeforderte Blob-Fragment größer als MAX_BLOB_FETCH_SIZE ist.
BlobNotFoundError – Wenn das Blob nicht vorhanden ist.

google.appengine.ext.blobstore.blobstore.fetch_data_async(blob, start_index, end_index, rpc=None)Quelle

Ruft asynchron Daten für ein Blob ab.

Parameter

blob – Eine BlobInfo-, BlobKey-, String- oder Unicode-Darstellung des BlobKey des Blobs, aus dem Sie Daten abrufen möchten.
start_index – Der Startindex der abzurufenden Blob-Daten. Dieser Wert darf nicht negativ sein.
end_index – Der Endindex (einschließlich) der abzurufenden Blob-Daten. Dieser Wert muss größer oder gleich start_index sein.
rpc – Optionales UserRPC-Objekt.

Gibt zurück

UserRPC, dessen Ergebnis ein String ist, der von fetch_data() zurückgegeben wird.

Löst aus

TypeError – Wenn start_index oder end_index keine Indexe sind oder blob kein String ist, BlobKey oder BlobInfo.
DataIndexOutOfRangeError – Wenn start_index auf einen Wert gesetzt ist, der kleiner als 0 ist, oder end_indexbeim Aufrufen von rpc.get_result() kleiner als start_index ist.
BlobFetchSizeTooLargeError – Wenn das angeforderte Blob-Fragment beim Aufrufen von rpc.get_result() größer als MAX_BLOB_FETCH_SIZE ist.
BlobNotFoundError – Wenn das Blob beim Aufrufen von rpc.get_result() nicht vorhanden ist.

google.appengine.ext.blobstore.blobstore.create_gs_key(filename, rpc=None)Quelle

Erstellt einen codierten Schlüssel für eine Google Cloud Storage-Datei.

Es stellt kein Sicherheitsrisiko dar, diesen Schlüssel für die spätere Verwendung beizubehalten.

Parameter

filename: Dateiname des Google Cloud Storage-Objekts, für das Sie den Schlüssel erstellen möchten.
rpc – Optionales UserRPC-Objekt.

Gibt zurück

Einen verschlüsselten BlobKey-String.

google.appengine.ext.blobstore.blobstore.create_gs_key_async(filename, rpc=None)Quelle

Erstellt asynchron einen codierten Schlüssel für eine Google Cloud Storage-Datei.

Es stellt kein Sicherheitsrisiko dar, diesen Schlüssel für die spätere Verwendung beizubehalten.

Parameter

filename: Dateiname des Google Cloud Storage-Objekts, für das Sie den Schlüssel erstellen möchten.
rpc – Optionales UserRPC-Objekt.

Gibt zurück

UserRPC, dessen Ergebnis ein String ist, der von create_gs_key() zurückgegeben wird.

Löst aus

TypeError – Wenn filename kein String ist.
ValueError – Wenn filename nicht das Format /gs/bucket_name/object_name hat.

google.appengine.ext.blobstore.blobstore.get(blob_key)Quelle

Ruft einen BlobInfo-Datensatz aus Blobstore ab.

Entspricht BlobInfo.get.

Parameter

blob_key – Der BlobKey des Datensatzes, den Sie abrufen möchten.

Gibt zurück

google.appengine.ext.blobstore.blobstore.parse_blob_info(field_storage)Quelle

Parst einen BlobInfo-Datensatz aus dem Dateiupload field_storage.

Parameter

field_storage – cgi.FieldStorage, das ein hochgeladenes Blob darstellt.

Gibt zurück

Einen BlobInfo-Datensatz, der von der field_storage-Instanz geparst wurde. Diese Methode gibt None zurück, wenn field_storage nicht angegeben wurde.

Löst aus

BlobInfoParseError – wenn der bereitgestellte field_storage nicht genügend Informationen enthält, um ein BlobInfo-Objekt zu erstellen.

google.appengine.ext.blobstore.blobstore.parse_file_info(field_storage)Quelle

Parst einen FileInfo-Datensatz aus dem Dateiupload field_storage.

Parameter

field_storage – cgi.FieldStorage, der die hochgeladene Datei darstellt.

Gibt zurück

FileInfo-Datensatz, der von der field_storage-Instanz geparst wurde. Diese Methode gibt None zurück, wenn field_storage nicht angegeben wurde.

Löst aus

FileInfoParseError – Wenn field_storage nicht genügend Informationen enthält, um ein FileInfo-Objekt zu erstellen.