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.

Paket google.appengine.ext.admin

Übersicht

Einfache Datenspeicheransicht und interaktive Konsole zur Verwendung in dev_appserver.

Inhalt

Klasse google.appengine.ext.admin.BackendsPageHandler(*args, **kwargs)Quelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Zeigt Informationen zu den Back-Ends einer Anwendung an

PATH = '/backends'

get()Quelle: Zeigt eine Vorlage mit den Back-Ends einer Anwendung oder einem einzelnen Back-End an

get_backend_entry(backend_name)Quelle: Ruft den BackendEntry für ein einzelnes Back-End ab

post()Quelle

render_backend_page(backend_name)Quelle: Zeigt eine Vorlage mit einem einzelnen Back-End an

render_backends_page()Quelle: Zeigt eine Vorlage mi allen Back-Ends der Anwendung an

Klasse google.appengine.ext.admin.BaseRequestHandlerQuelle

Bases: google.appengine.ext.webapp._webapp25.RequestHandler

Liefert eine gängige Funktion für die Vorlagengenerierung

Wenn Sie generate() aufrufen, erweitern wir die mit dem aktuellen Nutzer in der Variable "user" bereitgestellten Vorlagenvariablen und der aktuellen webapp-Anfrage in der Variablen "request".

base_path()Quelle

Gibt den Basispfad dieser Admin-App zurück, der vom Nutzer ausgewählt wurde.

Der Nutzer gibt in der Datei app.cfg an, welche Pfade dieser Anwendung zugeordnet werden. Sie können den Basispfad mit dieser Methode abrufen. Kombinieren Sie ihn zum Erstellen von URLs mit den konstanten Pfaden, die von den Klassen angegeben werden.

filter_url(args)Quelle

Filtert die aktuelle URL, um nur die angegebene Liste von Argumenten zu erhalten

Ist die URL beispielsweise /search?q=foo&num=100&start=10 lautet, dann

self.filter_url([‘start’, ‘num’]) => /search?num=100&start=10 self.filter_url([‘q’]) => /search?q=10 self.filter_url([‘random’]) => /search?

generate(template_name, template_values={})Quelle

in_production()Quelle

Erkennt, ob die Anwendung in der Produktion ausgeführt wird

Gibt einen booleschen Wert zurück

interactive_console_enabled()Quelle

Klasse google.appengine.ext.admin.BlobKeyTypeQuelle

Basis: google.appengine.ext.admin.StringType

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.BlobTypeQuelle

Basis: google.appengine.ext.admin.StringType

format(value)Quelle

input_field(name, value, sample_values)Quelle

name()Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.BoolTypeQuelle

Basis: google.appengine.ext.admin.DataType

input_field(name, value, sample_values)Quelle

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.ByteStringTypeQuelle

Basis: google.appengine.ext.admin.StringType

format(value)Quelle

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.CategoryTypeQuelle

Basis: google.appengine.ext.admin.StringType

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.CronPageHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Zeigt Informationen zu in dieser Anwendung konfigurierten Cronjobs an

PATH = '/cron'

get(now=None)Quelle: Zeigt eine Vorlage mit den konfigurierten Cronjobs an

Klasse google.appengine.ext.admin.DataTypeQuelle

Basiert auf: object

Ein DataType stellt einen Datentyp im Datenspeicher dar.

Jeder DataType-Untertyp definiert vier Methoden:

format: gibt einen formatierten String für einen Datenspeicherwert zurück input_field: gibt das HTML-Stringelement <input> für diesen DataType zurück name: Anzeigename dieses DataType parse: parst die formatierte Stringdarstellung dieses DataType python_type: kanonischer Python-Typ dieses Datenspeichertyps

Wir zeigen in unseren Ergebnislisten mithilfe von DataType-Instanzen formatierte Werte an. Außerdem verwenden wir input_field/format/parse, um Formulare zu generieren und die Ergebnisse dieser Formulare zu parsen, sodass Entitäten bearbeitet werden können.

additional_short_value_html(unused_value)Quelle

format(value)Quelle

statisch get(value)Quelle

statisch get_by_name(name)Quelle

input_field(name, value, sample_values)Quelle

input_field_size()Quelle

short_format(value)Quelle

Klasse google.appengine.ext.admin.DatastoreAdminHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Lädt den Datastore-Admin-Handler in einen iFrame

PATH = '/datastore_admin'

get()Quelle

Klasse google.appengine.ext.admin.DatastoreBatchEditHandlerQuelle

Basis: google.appengine.ext.admin.DatastoreRequestHandler

Request-Handler für einen Batchvorgang bei Entitäten

Unterstützt das Löschen mehrerer Entitäten nach Schlüssel und die Weiterleitung zu einer anderen URL

PATH = '/datastore/batchedit'

post()Quelle

Klasse google.appengine.ext.admin.DatastoreEditHandlerQuelle

Basis: google.appengine.ext.admin.DatastoreRequestHandler

Request-Handler für das Formular zum Erstellen/Bearbeiten von Entitäten

Um zu ermitteln, wie ein Formular zum Bearbeiten einer Entität generiert werden soll, fragen wir den Entitätstyp ab. Anschließend suchen wir in den Ergebnissen nach einem Satz Schlüssel und dessen Typen. Wir verwenden für diese sich selbst überprüfenden Typen die DataType-Unterklassen, um das Formular zu generieren und die Formularergebnisse zu parsen.

PATH = '/datastore/edit'

get()Quelle

post()Quelle

Klasse google.appengine.ext.admin.DatastoreGetIndexesHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Unser Haupt-Request-Handler, der Indexe anzeigt

PATH = '/datastore_indexes'

get()Quelle

Klasse google.appengine.ext.admin.DatastoreQueryHandlerQuelle

Basis: google.appengine.ext.admin.DatastoreRequestHandler

Unser Haupt-Request-Handler, der Abfragen ausführt und Entitäten auflistet

Wir verwenden in unserem Basis-Request-Handler execute_query (), um URL-Argumente zu parsen und die Datenspeicherabfrage auszuführen.

PATH = '/datastore'

get()Quelle

Formatiert die Ergebnisse von execute_query() für datastore.html.

Das einzig Komplexe an diesem Vorgang ist das Berechnen der Seitenvariablen, um unten auf der Seite die Anzeige der Goooogle-Seitenzahl zu generieren.

get_kinds(namespace)Quelle

Ruft eine sortierte Liste mit Typnamen ab, die der Datenspeicher kennt.

Dieser Aufruf sollte nur in der Entwicklungsumgebung durchgeführt werden, da Metadatenabfragen teuer sind und nicht im Cache gespeichert werden.

Parameter

Namespace – Der Namespace zum Abrufen des Schemas, z.B. für "google.com". Es wird ein Fehler ausgegeben, wenn "None" übergeben wird.

Gibt Folgendes zurück:

Eine sortierte Liste von Arten, z.B. ['Buch', 'Gast', Post'] (in utf-8 codiert).

Klasse google.appengine.ext.admin.DatastoreRequestHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Basis-Request-Handler für unsere Datenspeicher-Admin-Seiten

Wir bieten Dienstprogrammfunktionen zum Abfragen des Datenspeichers und zum Ableiten der Typen von Entitäts-Properties.

execute_query(start=0, num=0, no_order=False)Quelle

Parst die URL-Argumente und führt die Abfrage aus

Parameter

start: Gibt an, wie viele Entitäten am Anfang der Ergebnisliste bei der Abfrage übersprungen werden sollten.
num: Gibt an, wie viele Entitäten zurückgegeben werden sollen. Mit 0 (Standard) wird eine angemessene Standardanzahl gewählt.

Gibt Folgendes zurück:

Ein Tupel in Form von (Liste der Entitäten, Gesamtzahl der Entitäten). Bei unangemessenen URL-Argumenten geben wir eine leere Ergebnismenge und 0 für die Anzahl der Entitäten zurück.

get_key_values(entities)Quelle

Gibt die Vereinigung der Schlüsselnamen zurück, die von der angegebenen Liste von Entitäten verwendet werden.

Wir geben die Vereinigung als Wörterbuch zurück, das die Schlüsselnamen einem Beispielwert von einer der Entitäten für den Schlüsselnamen zuordnet.

num()Quelle: Gibt das bereinigte Argument "num" von der URL zurück

redirect_with_message(message)Quelle: Leitet zur nächsten URL weiter und fügt eine Nachricht als msg-Parameter hinzu

start()Quelle: Gibt das bereinigte Argument "start" von der URL zurück

Klasse google.appengine.ext.admin.DatastoreStatsHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Ermöglicht die Berechnung von Datenspeicherstatistiken

PATH = '/datastore_stats'

generate_stats(_app=None)Quelle: Generiert Datenspeicherstatistiken

get()Quelle: Zeigt die Schaltfläche zum Generieren von Datenspeicherstatistiken an

post()Quelle

Klasse google.appengine.ext.admin.DefaultPageHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Leitet die Datenspeicheranwendung standardmäßig weiter

PATH = '/'

get()Quelle

Klasse google.appengine.ext.admin.Document(doc_id)Quelle

Basiert auf: object

Einfache Darstellung des Dokuments

Klasse google.appengine.ext.admin.EmailTypeQuelle

Basis: google.appengine.ext.admin.StringType

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.EmbeddedEntityTypeQuelle

Basis: google.appengine.ext.admin.BlobType

name()Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.FloatTypeQuelle

Basis: google.appengine.ext.admin.NumberType

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.GeoPtTypeQuelle

Basis: google.appengine.ext.admin.DataType

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.ImTypeQuelle

Basis: google.appengine.ext.admin.DataType

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.ImageHandlerQuelle

Bases: google.appengine.ext.webapp._webapp25.RequestHandler

Bedient ein statisches Image

Wir möchten damit dem Nutzer das Festlegen eines statischen Datei-Handlers für die vom Admin-Tool verwendeten Image-ResQuellen abnehmen.

PATH = '/images/.*'

get()Quelle

Klasse google.appengine.ext.admin.InboundMailPageHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Testet Mail-Anfragen

PATH = '/inboundmail'

get()Quelle: Zeigt die Vorlage mit dem Formular für eingehende E-Mails an

Klasse google.appengine.ext.admin.IntTypeQuelle

Basis: google.appengine.ext.admin.NumberType

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.InteractiveExecuteHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Führt den in einem POST in diesem Kontext übergebenen Python-Code aus.

Aus naheliegenden Gründen sollte dies nur für Administratoren der Anwendungen verfügbar sein.

PATH = '/interactive/execute'

post()Quelle

Klasse google.appengine.ext.admin.InteractivePageHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Zeigt unsere interaktive Konsolen-HTML

PATH = '/interactive'

get()Quelle

Klasse google.appengine.ext.admin.LinkTypeQuelle

Basis: google.appengine.ext.admin.StringType

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.ListTypeQuelle

Basis: google.appengine.ext.admin.DataType

format(value)Quelle

input_field(name, value, sample_values)Quelle

name()Quelle

python_type()Quelle

short_format(value)Quelle

short_format_orig(value)Quelle

utf8_short_format(value)Quelle

Klasse google.appengine.ext.admin.LongTypeQuelle

Basis: google.appengine.ext.admin.NumberType

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.MemcachePageHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Zeigt Statistiken zum Memcache- und Abfrageformular an, um Werte abzurufen

DEFAULT_TYPESTR_FOR_NEW = 'String'

PATH = '/memcache'

TYPES = ((<type 'str'>, <type 'str'>, 'String'), (<type 'unicode'>, <type 'unicode'>, 'Unicode String'), (<type 'bool'>, <function <lambda>>, 'Boolean'), (<type 'int'>, <type 'int'>, 'Integer'), (<type 'long'>, <type 'long'>, 'Long Integer'), (<type 'float'>, <type 'float'>, 'Float'))

get()Quelle: Zeigt die Vorlage an und bereitet Statistiken und/oder Schlüssel/Wert-Paare zum Anzeigen bzw. Bearbeiten vor

post()Quelle

Klasse google.appengine.ext.admin.NoneTypeQuelle

Basis: google.appengine.ext.admin.DataType

format(value)Quelle

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.NumberTypeQuelle

Basis: google.appengine.ext.admin.DataType

input_field_size()Quelle

Klasse google.appengine.ext.admin.PhoneNumberTypeQuelle

Basis: google.appengine.ext.admin.StringType

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.PostalAddressTypeQuelle

Basis: google.appengine.ext.admin.StringType

name()Quelle

parse(value)Quelle

python_type()Quelle

google.appengine.ext.admin.PseudoBreadcrumbs(Schlüssel)Quelle

Gibt einen String zurück, der wie der Navigationspfad aussieht (für Schlüssel-Properties)

Parameter

Schlüssel - datastore_types.Key-Objekt.

Gibt Folgendes zurück:

String, der wie ein Navigationspfad aussieht

Klasse google.appengine.ext.admin.QueueBatch(title, run_manual, rate_restricted, content)Quelle

Basiert auf: object

Sammlung von Push- oder Pull-Warteschlangen

Klasse google.appengine.ext.admin.QueuesPageHandler(*args, **kwargs)Quelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Zeigt Informationen zu konfigurierten (und standardmäßigen) Aufgabenwarteschlangen an

PATH = '/queues'

get()Quelle: Zeigt eine Vorlage mit den konfigurierten Aufgabenwarteschlangen an

post()Quelle

Klasse google.appengine.ext.admin.RatingTypeQuelle

Basis: google.appengine.ext.admin.NumberType

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.ReferenceTypeQuelle

Basis: google.appengine.ext.admin.DataType

additional_short_value_html(value)Quelle

input_field(name, value, sample_values)Quelle

input_field_size()Quelle

name()Quelle

parse(value)Quelle

python_type()Quelle

short_format(value)Quelle

Klasse google.appengine.ext.admin.SearchBatchDeleteHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Handler für FTS-Batch-Löschvorgang

PATH = '/search_batch_delete'

post()Quelle

Klasse google.appengine.ext.admin.SearchDocumentHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

FTS-Dokumentinformationen

PATH = '/search_document'

get()Quelle: Zeigt das FTS-Dokument an.

Klasse google.appengine.ext.admin.SearchIndexHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

FTS-Indexinformationen

PATH = '/search_index'

get()Quelle: Zeigt Dokumente in einem FTS-Index an

Klasse google.appengine.ext.admin.SearchIndexesListHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

FTS-Hauptseite mit einer Liste von Indexen

PATH = '/search'

get()Quelle: Zeigt eine Liste von FTS-Indexen an

Klasse google.appengine.ext.admin.StringTypeQuelle

Basis: google.appengine.ext.admin.DataType

format(value)Quelle

input_field(name, value, sample_values)Quelle

input_field_size()Quelle

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.TaskQueueHelperQuelle

Basiert auf: object

RPC-Wrapper für die Aufgabenwarteschlange

delete_task(queue_name, task_name)Quelle

Löscht die benannte Aufgabe

Parameter

queue_name: Name der Warteschlange
task_name: Name der Aufgabe

get_number_tasks_in_queue(queue_name)Quelle

Gibt die Anzahl der Aufgaben in der benannten Warteschlange zurück

Parameter

queue_name: Name der Warteschlange

Gibt Folgendes zurück:

Anzahl der Aufgaben in der Warteschlange

get_queues(now)Quelle

Ruft eine Liste der Warteschlangen in der Anwendung ab

Parameter

now: Aktuelle Zeit. Ein datetime.datetime-Objekt mit einer UTC-Zeitzone.

Gibt Folgendes zurück:

Liste von Warteschlangenwörterbüchern entsprechend den Aufgaben für diese Anwendung

get_tasks(now, queue_name, start_eta_usec, start_task_name, num_tasks)Quelle

Ruft die angegebenen Aufgaben aus der Aufgabenwarteschlange ab

Hinweis: Hiermit wird nur nach "eta" gesucht.

Parameter

now: Aktuelle Zeit. Hiermit wird EtaFromNow berechnen. Muss ein datetime.datetime-Objekt in der UTZ-Zeitzone sein.
queue_name: Nach Aufgaben zu durchsuchende Warteschlange.
start_eta_usec: Früheste zurückzugebende "eta".
start_task_name: Für Aufgaben mit demselben Wert für eta_usec als "Stichfrage" verwendet.
num_tasks: Maximale Anzahl von Aufgaben, die zurückgegeben werden sollen.

Gibt Folgendes zurück:

Liste von Aufgabenwörterbüchern (wie etwa zurückgegeben von: taskqueue_stub.QueryTasksResponseToDict).

purge_queue(queue_name)Quelle

Löscht die benannte Warteschlange

Parameter

queue_name: Name der Warteschlange

Klasse google.appengine.ext.admin.TasksPageHandler(*args, **kwargs)Quelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Zeigt Informationen zu den Aufgaben einer Warteschlange an

MAX_TASKS_TO_FETCH = 1000

MIN_TASKS_TO_FETCH = 200

PAGE_SIZE = 20

PATH = '/tasks'

generate_page_dicts(start_tasks, end_tasks)Quelle

Generiert die Seitenwörterbücher anhand einer Liste von Aufgaben

Parameter

tasks: Liste von Aufgabenwörterbüchern, sortiert nach "eta"

Gibt Folgendes zurück:

'start_name', 'start_eta', 'number', 'has_gap'

Rückgabetyp

Eine Liste von Seitenwörterbüchern mit den folgenden Schlüsseln

get()Quelle: Zeigt eine Vorlage mit den Aufgaben der Warteschlange an

parse_arguments()Quelle: Parst die an die Anfrage übergebenen Argumente und speichert sie in sich selbst

post()Quelle

redirect_to_tasks(keep_offset=True)Quelle

Leitet zur Aufgabenseite weiter

Parameter

keep_offset: Wenn "true", werden die Felder "start_eta", "start_name" und "page_no" beibehalten

Klasse google.appengine.ext.admin.TextTypeQuelle

Basis: google.appengine.ext.admin.StringType

input_field(name, value, sample_values)Quelle

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.TimeTypeQuelle

Basis: google.appengine.ext.admin.DataType

format(value)Quelle

name()Quelle

parse(value)Quelle

python_type()Quelle

google.appengine.ext.admin.TruncateValue(value)Quelle: Kürzt potenziell sehr lange Strings auf eine feste maximale Länge

Klasse google.appengine.ext.admin.UserTypeQuelle

Basis: google.appengine.ext.admin.DataType

input_field_size()Quelle

name()Quelle

parse(value)Quelle

python_type()Quelle

Klasse google.appengine.ext.admin.XMPPPageHandlerQuelle

Basis: google.appengine.ext.admin.BaseRequestHandler

Testet XMPP-Anfragen.

PATH = '/xmpp'

get()Quelle: Zeigt eine Vorlage mit dem XMPP an

google.appengine.ext.admin.get_xsrf_token()Quelle

Gib das XSRF-Token zurück.

Dies wird vom Datenspeicher gelesen. Wenn im Datenspeicher kein Token vorhanden ist, erstellen wir ein Token nach dem Zufallsprinzip und fügen es ein.

google.appengine.ext.admin.main()Quelle

google.appengine.ext.admin.urepr(value)Quelle: Entspricht repr() mit dem Unterschied, dass Unicode in einer Liste mit UTF-8 codiert wird

google.appengine.ext.admin.ustr(value)Quelle: Entspricht str() mit dem Unterschied, dass anstelle eines Fehlers Unicode mit UTF-8 codiert wird

google.appengine.ext.admin.xsrf_required(method)Quelle: Decorator zum Schutz von post()-Handlern vor XSRF-Angriffen