Flussi di dati per richieste e risposte

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Che cosa imparerai in questo argomento

Dopo aver letto questo argomento, saprai quanto segue:

  • Che cos'è lo streaming di richieste e risposte su Apigee
  • Quando utilizzare lo streaming di richieste e risposte
  • Come attivare lo streaming di richieste e risposte

Che cos'è lo streaming di richieste e risposte?

Per impostazione predefinita, lo streaming HTTP è disattivato e i payload delle richieste e delle risposte HTTP vengono scritti in un buffer in memoria prima di essere elaborati dalla pipeline del proxy API. Puoi modificare questo comportamento attivando lo streaming. Con lo streaming abilitato, i payload di richiesta e risposta vengono trasmessi in streaming senza modifiche all'app client (per le risposte) e all'endpoint di destinazione (per le richieste).

Quando devo attivare lo streaming?

Se il proxy API gestisce richieste e/o risposte di grandi dimensioni (per i limiti di dimensioni, consulta Che cos'altro devo sapere sullo streaming), potresti attivare lo streaming.

Che cos'altro devo sapere sullo streaming?

La dimensione del payload del messaggio è limitata a 10 MB. Nelle richieste e nelle risposte non in streaming, il superamento di queste dimensioni comporta un errore protocol.http.TooBigBody.

Dati codificati

Quando lo streaming è abilitato, Apigee non codifica o decodifica i payload di richiesta o risposta prima di inviarli al client che si connette ad Apigee o a un server di destinazione di backend. Per ulteriori informazioni, consulta le righe relative a request.streaming.enabled e response.streaming.enabled nella tabella Specifiche della proprietà di trasporto TargetEndpoint.

Come attivare lo streaming di richieste e risposte

Per attivare lo streaming delle richieste, devi aggiungere la proprietà request.streaming.enabled alle definizioni di ProxyEndpoint e TargetEndpoint nel bundle del proxy e impostarla su true. Analogamente, imposta la proprietà response.streaming.enabled per attivare lo streaming delle risposte.

Puoi trovare questi file di configurazione nell'interfaccia utente di Apigee nella visualizzazione Sviluppa per il tuo proxy. Se esegui lo sviluppo localmente, questi file di definizione si trovano in apiproxy/proxies e apiproxy/targets.

Questo esempio mostra come attivare lo streaming sia della richiesta sia della risposta nella definizione di TargetEndpoint.

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <URL>http://mocktarget.apigee.net</URL>
    <Properties>
      <Property name="response.streaming.enabled">true</Property>
      <Property name="request.streaming.enabled">true</Property>
      <Property name="supports.http10">true</Property>
      <Property name="request.retain.headers">User-Agent,Referer,Accept-Language</Property>
      <Property name="retain.queryparams">apikey</Property>
    </Properties>
  </HTTPTargetConnection>
</TargetEndpoint>

Questo esempio mostra come attivare lo streaming di risposte e richieste nella definizione di ProxyEndpoint:

<ProxyEndpoint name="default">
  <HTTPProxyConnection>
    <BasePath>/v1/weather</BasePath>
    <Properties>
      <Property name="allow.http10">true</Property>
      <Property name="response.streaming.enabled">true</Property>
      <Property name="request.streaming.enabled">true</Property>
    </Properties>
  </HTTPProxyConnection>
</ProxyEndpoint>

Per ulteriori informazioni sulla configurazione delle definizioni degli endpoint, consulta Riferimento per le proprietà degli endpoint.

Esempi di codice correlati

Gli esempi di proxy API su GitHub sono facili da scaricare e utilizzare.

Ecco alcuni esempi di proxy che supportano lo streaming: