Cloud Endpoints Frameworks

Cloud Endpoints Frameworks è un web framework per gli ambienti di runtime Python 2.7 e Java 8 standard di App Engine. Cloud Endpoints Frameworks fornisce gli strumenti e le librerie che consentono di generare API REST e librerie client per la tua applicazione.

Come altri framework web, Endpoints Frameworks gestisce le applicazioni i dettagli delle comunicazioni delle richieste e delle risposte HTTP per l'applicazione. Quando un client invia una richiesta alla tua API, Endpoints Frameworks inoltra l'URL della richiesta alla funzione o al metodo nel codice che la elabora. Endpoints Frameworks converte il valore restituito in JSON e invia il valore risposta. Puoi aggiungere i metadati (utilizzando le annotazioni in Java e i decorator in Python) al codice sorgente. I metadati definiscono la piattaforma delle API REST per la tua applicazione.

Java

@ApiMethod(name = "echo")
public Message echo(Message message, @Named("n") @Nullable Integer n) {
  return doEcho(message, n);
}

Nel codice di esempio, il valore annotations iniziano con il carattere @.

Python

@endpoints.method(
    # This method takes a ResourceContainer defined above.
    ECHO_RESOURCE,
    # This method returns an Echo message.
    EchoResponse,
    path="echo",
    http_method="POST",
    name="echo",
)
def echo(self, request):
    output_message = " ".join([request.message] * request.n)
    return EchoResponse(message=output_message)

Nel codice di esempio, il valore decoratori iniziano con il carattere @.

Con Endpoints Frameworks non è necessario eseguire il deployment di un server web di terze parti (ad esempio Apache Tomcat o Gunicorn) con l'applicazione. Aggiungi annotazioni o decorare il codice ed eseguire il deployment dell'applicazione come faresti normalmente Ambiente standard di App Engine.

Gestione delle API

Extensible Service Proxy (ESP) fornisce funzionalità di gestione delle API per Endpoints per OpenAPI e Endpoint per gRPC. ESP viene eseguito in un contenitore insieme a ogni istanza del tuo backend.

Perché l'ambiente standard di App Engine non supportava di deployment multi-container quando Endpoints Frameworks era in fase di sviluppo, Endpoints Frameworks non utilizza ESP. Endpoint Frameworks include invece un modello Gateway API che offre funzionalità di gestione delle API paragonabili alla funzionalità fornite da ESP per Endpoints per OpenAPI e Endpoint per gRPC.

Endpoints Frameworks intercetta tutte le richieste ed esegue i controlli necessari (come l'autenticazione) prima di inoltrare la richiesta al di backend API. Quando il backend risponde, Endpoints Frameworks raccoglie e genera report sulla telemetria. Puoi visualizzare le metriche per l'API negli Endpoint Services nella console Google Cloud.

Puoi utilizzare Endpoints Frameworks con o senza gestione API funzionalità. Utilizzo di Endpoints Frameworks senza gestione API sono disponibili senza costi aggiuntivi. La funzionalità di gestione delle API viene addebitata in base ai prezzi degli endpoint .

Limitazioni

  • Endpoints Frameworks è supportato solo su App Engine ambienti di runtime Python 2.7 e Java 8 standard.
  • Endpoints Frameworks non supporta Node.js, PHP e Go ambienti di runtime nell'ambiente standard di App Engine.
  • Endpoints Frameworks non supporta l'ambiente flessibile di App Engine.
  • Endpoints Frameworks non supporta le funzioni Cloud Run, Compute Engine e Google Kubernetes Engine.

Passaggi successivi