Datos de caché cargados por componentes

Completado

El rendimiento es una de las características clave de las mejores aplicaciones. Es aceptable que una aplicación tarde un momento en cargar sus datos al principio. Pero para que se perciba como rápida, la aplicación debe minimizar la cantidad de datos que necesita recuperar inicialmente. Además, una vez que la aplicación recupera sus datos, debe almacenarlos en caché siempre que sea razonable que esos datos permanezcan actualizados.

Por ejemplo, supongamos que quiere mostrar información sobre una persona en su aplicación:

Para mostrar esta información, tendría que llamar a Microsoft Graph tres veces. En primer lugar, recuperaría la información sobre la persona, después su imagen y, por último, su presencia.

Ahora, supongamos que quiere mostrar esta información no para una persona, sino para cinco personas. La aplicación tendría que ejecutar 15 solicitudes. Si necesita mostrar información sobre los usuarios en varios lugares de la aplicación (por ejemplo, para mostrar mensajes, autores de archivos o asistentes a la reunión), puede emitir llamadas para los datos que ya fueron recuperados.

Para evitar la carga de datos que ya tiene, puede considerar la posibilidad de crear un mecanismo personalizado de almacenamiento en caché. Pero antes de hacerlo, considere la posibilidad de usar el Kit de herramientas de Microsoft Graph en su lugar.

Configuración de la memoria caché para los componentes del Kit de herramientas de Microsoft Graph

Los componentes del Kit de herramientas de Microsoft Graph almacenan automáticamente en caché los datos que recuperan. Si necesita un fragmento determinado de información en la aplicación, se descarga una sola vez y se almacena en la memoria caché hasta que expire. De forma predeterminada, el Kit de herramientas de Microsoft Graph almacena los datos en caché durante 1 hora. La información sobre la presencia del usuario se almacena en caché durante solo 5 minutos, ya que esta tiende a cambiar con frecuencia.

Puede controlar la memoria caché globalmente, pero también invalidar la configuración de una carga de trabajo específica, si es necesario. La configuración de caché se expone a través de la clase CacheService.

Para cambiar la duración de la memoria caché de todos los componentes, cambie el valor de la propiedad defaultInvalidationPeriod:

import { CacheService } from '@microsoft/mgt';

// set cache expiration for all components to 30 minutes
CacheService.config.defaultInvalidationPeriod = 1800000;

Nota:

Si carga el Kit de herramientas de Microsoft Graph desde una red de entrega de contenido, podrá acceder a la configuración de CacheService a través de la variable global mgt, como se indica a continuación:

<script src="https://unpkg.com/@microsoft/mgt@3/dist/bundle/mgt-loader.js"></script>
<script>
  mgt.CacheService.config.defaultInvalidationPeriod = 1800000;
</script>

Para deshabilitar la memoria caché de todos los componentes, establezca la propiedad isEnabled en false:

import { CacheService } from '@microsoft/mgt';

// disable cache for all Microsoft Graph Toolkit components
CacheService.config.isEnabled = false;

Importante

Si deshabilita la memoria caché de todos los componentes en el Kit de herramientas de Microsoft Graph, es posible que la aplicación descargue los mismos datos varias veces desde Microsoft Graph. Esto tendrá un impacto negativo en el rendimiento de la aplicación.

Para deshabilitar los componentes del almacenamiento en caché de los datos de personas, establezca la propiedad isEnabled de la caché de personas en false:

import { CacheService } from '@microsoft/mgt';

// disable people cache for all Microsoft Graph Toolkit components
CacheService.config.people.isEnabled = false;

Configuración de la memoria caché para el componente mgt-get

Los componentes del Kit de herramientas de Microsoft Graph almacenan en caché sus datos por carga de trabajo, como contactos, fotos o grupos. Esta organización de la memoria caché permite que un componente cargue los datos y otros componentes para recuperarlos de la memoria caché sin ejecutar solicitudes duplicadas. El único componente que funciona de forma diferente es mgt-get.

Con el componente mgt-get, puede cargar y mostrar los datos de Microsoft Graph en la aplicación. Dado que mgt-get puede mostrar datos arbitrarios, tiene su propia memoria caché denominada contestación. Al igual que con cualquier otro objeto de caché, puede configurar si la memoria caché de contestación está habilitada y por cuánto tiempo debe conservar los datos. Ningún otro componente del Kit de herramientas de Microsoft Graph usa la memoria caché de contestación.

Próximos pasos

Vamos a poner en práctica lo aprendido y a cambiar la configuración de los componentes del Kit de herramientas de Microsoft Graph.