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 ti consentono di generare API REST e librerie client per la tua applicazione.

Come altri framework web, Endpoints Frameworks gestisce i dettagli di comunicazione di basso livello delle richieste e delle risposte HTTP per la tua 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 la risposta. Aggiungi i metadati (utilizzando le annotazioni in Java e i decoratori 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, le 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, i decoratori iniziano con il carattere @.

Con i framework Endpoints, non è necessario eseguire il deployment di un server web di terze parti (ad esempio Apache Tomcat o Gunicorn) con l'applicazione. Annoti o decori il codice ed esegui il deployment dell'applicazione come faresti normalmente nell'ambiente standard di App Engine.

Gestione delle API

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

Poiché l'ambiente standard di App Engine non supportava gli implementazioni multi-container quando Endpoints Frameworks era in fase di sviluppo, Endpoints Frameworks non utilizza ESP. I framework Endpoints includono invece un gateway API incorporato che fornisce funzionalità di gestione delle API paragonabili alle funzionalità fornite da ESP per Endpoints per OpenAPI e Endpoints per gRPC.

Endpoints Frameworks intercetta tutte le richieste ed esegue tutti i controlli necessari (ad esempio l'autenticazione) prima di inoltrare la richiesta al backend dell'API. Quando il backend risponde, Endpoints Frameworks raccoglie e registra la telemetria. Puoi visualizzare le metriche per la tua API nella pagina Servizi endpoint della console Google Cloud.

Puoi utilizzare i framework Endpoints con o senza la funzionalità di gestione delle API. L'utilizzo di Frameworks Endpoints senza funzionalità di gestione dell'API è offerto senza costi. Le funzionalità di gestione delle API vengono addebitate in base alla pagina relativa ai prezzi di Endpoints.

Limitazioni

  • Endpoints Frameworks è supportato solo negli ambienti di runtime Python 2.7 e Java 8 standard di App Engine.
  • Endpoints Frameworks non supporta gli ambienti di runtime Node.js, PHP e Go 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