Anuncio de Cloud Firestore (Beta): Prueba la nueva base de datos escalable y exible de Firebase y Google Cloud Platform.

Obtén más información sobre

Cloud Firestore (/docs/ restore).

Cómo habilitar funciones sin conexión en Android

Las aplicaciones de Firebase funcionan incluso si tu app pierde temporalmente la conexión de red. Además, Firebase proporciona
herramientas para la persistencia local de los datos, la administración de la presencia y el control de la latencia.

Persistencia en disco

Las apps de Firebase controlan las interrupciones temporales de red de manera automática. Los datos almacenados en caché están
disponibles sin conexión y Firebase vuelve a enviar cualquier escritura cuando se restablece la conectividad de red.

Cuando habilitas la persistencia en disco, la app escribe los datos de manera local en el dispositivo para que la app pueda mantener su
estado mientras está sin conexión, incluso si el usuario o el sistema operativo reinicia la app.

Puedes habilitar la persistencia en disco con una sola línea de código.

FirebaseDatabase.getInstance().setPersistenceEnabled(true); 

Compo amiento de la persistencia

Si habilitas la persistencia, los datos que el cliente de Firebase Realtime Database sincroniza mientras está en línea persisten en el disco y
están disponibles sin conexión, incluso cuando el usuario o el sistema operativo reinicia la app. Esto signi ca que la app funciona como lo
haría en línea mediante el uso de los datos locales almacenados en la caché. Las devoluciones de llamada de los agentes de escucha
continuarán activándose para las actualizaciones locales.

El cliente de Firebase Realtime Database conserva automáticamente una la de todas las operaciones de escritura ejecutadas mientras la
app está sin conexión. Cuando la persistencia se habilita, esta la persiste en el disco, de manera que todas las escrituras están disponibles
cuando el usuario o el sistema operativo reinicia la app. Cuando la app vuelve a conectarse, todas las operaciones se envían al servidor.

Si tu app usa Firebase Authentication (https:// rebase.google.com/docs/auth/android/manage-users/), el cliente de Firebase Realtime Database

conserva el token de autenticación del usuario cuando la app se reinicia. Si el token de autenticación vence mientras la app está sin
conexión, el cliente pausa las operaciones de escritura hasta que la app vuelva a autenticar el usuario. De lo contrario, las operaciones de
escritura podrían fallar debido a las reglas de seguridad.

Mantén los datos actualizados

Firebase Realtime Database sincroniza y almacena una copia local de los datos para los agentes de escucha activos. Además, puedes
mantener ubicaciones especí cas sincronizadas.

DatabaseReference scoresRef = FirebaseDatabase.getInstance().getReference("scores"); 

scoresRef.keepSynced(true);

El cliente de Firebase Realtime Database descarga los datos a estas ubicaciones automáticamente y las mantiene sincronizadas, incluso si
la referencia no tiene agentes de escucha activos. Puedes volver a desactivar la sincronización con la siguiente línea de código.

scoresRef.keepSynced(false); 
De forma predeterminada, 10 MB de datos sincronizados con anterioridad se almacenan en caché. Esto debería ser su ciente para la
mayoría de las aplicaciones. Si la memoria caché sobrepasa el tamaño con gurado, Firebase Realtime Database borra de nitivamente los
datos que se usaron con menor frecuencia recientemente. Los datos que se mantienen sincronizados no se borran de la memoria caché.

Consulta datos sin conexión

Firebase Realtime Database almacena los datos que muestra una consulta para usarlos sin conexión. En el caso de las consultas que se
crean sin conexión, Firebase Realtime Database continúa trabajando con los datos cargados con anterioridad. Si los datos solicitados no se
cargaron, Firebase Realtime Database cargará datos de la memoria caché local. Cuando la conectividad de red vuelva a estar disponible, se
cargarán los datos y re ejarán la consulta.

Por ejemplo, este código consulta los últimos cuatro elementos de una base de datos de Firebase Realtime Database de puntuaciones

DatabaseReference scoresRef = FirebaseDatabase.getInstance().getReference("scores"); 

scoresRef.orderByValue().limitToLast(4).addChildEventListener(new ChildEventListener() {
    @Override
    public void onChildAdded(DataSnapshot snapshot, String previousChild) {
      System.out.println("The " + snapshot.getKey() + " dinosaur's score is " + snapshot.getValue());
    }
});

Supongamos que la conectividad falla y el usuario se desconecta y reinicia la app. Mientras está sin conexión, la app consulta los últimos
dos elementos de la misma ubicación. Esta consulta dará como resultado los dos últimos elementos correctamente, porque la app cargó
los cuatro elementos en la consulta anterior.

scoresRef.orderByValue().limitToLast(2).addChildEventListener(new ChildEventListener() { 
    @Override
    public void onChildAdded(DataSnapshot snapshot, String previousChild) {
        System.out.println("The " + snapshot.getKey() + " dinosaur's score is " + snapshot.getValue());
      }
});

En el ejemplo anterior, el cliente de Firebase Realtime Database genera eventos de tipo "child added" para los dos dinosaurios con
puntuaciones más altas, a partir de la memoria caché que persistió. Sin embargo, no generará un evento "value", ya que la app nunca ejecutó
esa consulta mientras estaba en línea.

Si la aplicación solicitara los últimos seis elementos mientras está sin conexión, obtendría los eventos "child added" de inmediato para los
cuatro elementos en caché. Cuando el dispositivo vuelva a estar en línea, el cliente de Firebase Realtime Database se sincronizará con el
servidor y obtendrá los dos últimos eventos "child added" y el "value" para la app.

Administra transacciones sin conexión

Todas las transacciones que se ejecutan mientras la app está sin conexión, se agregan a la la. Cuando la app recupere la conectividad, las
transacciones se enviarán al servidor de Realtime Database.

Las transacciones no persisten cuando se reinicia la app

Incluso cuando la persistencia está habilitada, las transacciones no persisten entre reinicios de la app. Por lo tanto, no puedes con ar en que las transacciones
hechas sin conexión se con rmen en Firebase Realtime Database. Para brindarle una experiencia óptima al usuario, la app debe mostrar que una transacción
todavía no se guardó en Firebase Realtime Database, o debes asegurarte de que tu app las recuerde manualmente y vuelva a ejecutarlas después de reiniciarse.

Firebase Realtime Database tiene muchas funciones para abordar situaciones en las que no hay conexión a la red o esta presenta problemas. El resto de esta
guía se aplica a tu app sin importar si habilitaste la persistencia.
Administra la presencia

En aplicaciones en tiempo real, detectar en qué momento se conectan y desconectan los clientes suele ser útil. Por ejemplo, tal vez sea
conveniente marcar un usuario como "sin conexión" cuando su cliente se desconecta.

Los clientes de Firebase Database proporcionan primitivas simples que puedes usar para escribir en la base de datos cuando un cliente se
desconecta de los servidores de Firebase Database. Estas actualizaciones ocurren sin importar si el cliente se desconecta de manera limpia
o no, de modo que puedes con ar en ellos y limpiar los datos, incluso si se pierde la conexión o un cliente falla. Todas las operaciones de
escritura (que incluyen con gurar, actualizar y quitar) se pueden ejecutar cuando ocurre una desconexión.

A continuación, se muestra un ejemplo de escritura de datos cuando ocurre una desconexión, mediante la primitiva onDisconnect:

DatabaseRef presenceRef = FirebaseDatabase.getInstance().getReference("disconnectmessage"); 

// Write a string when this client loses connection
presenceRef.onDisconnect().setValue("I disconnected!");

Cómo funciona onDisconnect

Cuando estableces una operación onDisconnect(), esta se aloja en el servidor de Firebase Realtime Database. El servidor veri ca la
seguridad para asegurarse de que el usuario pueda ejecutar el evento de escritura solicitado y le informa a ti app si no es válida. Después, el
servidor supervisa la conexión. Si en algún momento se agota el tiempo de espera de la conexión o el cliente de Realtime Database la cierra,
el servidor veri ca la seguridad por segunda vez (para asegurarse de que la operación todavía sea válida) y después invoca el evento.

Tu app puede usar la devolución de llamada en la operación de escritura para asegurarse de que la operación onDisconnect se adjuntó
correctamente:

presenceRef.onDisconnect().removeValue(new DatabaseReference.CompletionListener() { 
    @Override
    public void onComplete(DatabaseError error, DatabaseReference firebase) {
        if (error != null) {
            System.out.println("could not establish onDisconnect event:" + error.getMessage());
        }
    }
});

Un evento onDisconnect también se puede cancelar mediante la invocación de .cancel():

OnDisconnect onDisconnectRef = presenceRef.onDisconnect(); 

onDisconnectRef.setValue("I disconnected");
// some time later when we change our minds
onDisconnectRef.cancel();

Detecta el estado de conexión

Para muchas funciones relacionadas con la presencia, es útil que la app sepa si está en línea o sin conexión. Firebase Realtime Database
proporciona una ubicación especial en /.info/connected, que se actualiza cada vez que cambia el estado de conexión del cliente de
Firebase Realtime Database. A continuación, se muestra un ejemplo:

DatabaseReference connectedRef = FirebaseDatabase.getInstance().getReference(".info/connected"); 

connectedRef.addValueEventListener(new ValueEventListener() {
  @Override
  public void onDataChange(DataSnapshot snapshot) {
    boolean connected = snapshot.getValue(Boolean.class);
    if (connected) {
      System.out.println("connected");
    } else {
      System.out.println("not connected");
    }
  }

  @Override
  public void onCancelled(DatabaseError error) {
    System.err.println("Listener was cancelled");
  }
});

/.info/connected es un valor booleano que no se sincroniza entre clientes de Realtime Database, ya que el valor depende del estado del
cliente. En otras palabras, si un cliente lee que /.info/connected es falso, no se garantiza que otro cliente también lo lea como falso.

En Android, Firebase administra el estado de conexión de forma automática para reducir el uso del ancho de banda y la batería. Cuando un
cliente no tiene agentes de escucha activos ni operaciones de escritura o de onDisconnect pendientes, ni se desconecta de manera
explícita con el método goOffline
 (https:// rebase.google.com/docs/reference/android/com/google/ rebase/database/FirebaseDatabase.html#goO ine()), Firebase naliza la conexión
después de 60 segundos de inactividad.

Administra la latencia

Marcas de tiempo del servidor

Los servidores de Firebase Realtime Database proporcionan un mecanismo de inserción de marcas de tiempo que se generan en el servidor
como datos. Esta función, combinada con onDisconnect, proporciona una manera simple y con able de tomar nota de la hora a la que el
cliente de Realtime Database se desconectó:

DatabaseReference userLastOnlineRef = FirebaseDatabse.getInstance().getReference("users/joe/lastOnline"); 

userLastOnlineRef.onDisconnect().setValue(ServerValue.TIMESTAMP);

Sesgo de reloj

Si bien firebase.database.ServerValue.TIMESTAMP es mucho más preciso y se pre ere para la mayoría de las operaciones de lectura y
escritura, ocasionalmente, puede ser útil hacer un cálculo aproximado del sesgo de reloj del cliente en relación con los servidores de
Firebase Realtime Database. Se puede adjuntar una devolución de llamada a la ubicación /.info/serverTimeOffset para obtener el valor
en milisegundos que los clientes de Firebase Realtime Database agregan a la hora local informada (tiempo Unix en milisegundos) para
calcular de manera aproximada la hora del servidor. Ten en cuenta que la precisión de este ajuste horario puede verse afectada por la
latencia de la red, por lo que es útil principalmente para descubrir discrepancias signi cativas en la hora del reloj (de más de 1 segundo).

DatabaseReference offsetRef = FirebaseDatabase.getInstance().getReference(".info/serverTimeOffset"); 

offsetRef.addValueEventListener(new ValueEventListener() {
  @Override
  public void onDataChange(DataSnapshot snapshot) {
    double offset = snapshot.getValue(Double.class);
    double estimatedServerTimeMs = System.currentTimeMillis() + offset;
  }

  @Override
  public void onCancelled(DatabaseError error) {
    System.err.println("Listener was cancelled");
  }
});
Ejemplo de app con presencia

Puedes combinar operaciones de desconexión con la supervisión del estado de conexión y las marcas de tiempo del servidor para compilar
un sistema de presencia del usuario. En este sistema, cada usuario almacena datos en una ubicación de la base de datos para indicar si el
cliente de Realtime Database está en línea. Los clientes con guran esta ubicación con el valor verdadero cuando están en línea y dejan una
marca de tiempo cuando se desconectan. La marca de tiempo indica la hora en que el usuario estuvo en línea por última vez.

Ten en cuenta que la app debe poner en la las operaciones de desconexión antes de que se marque a un usuario como "en línea", a n de
evitar cualquier condición de carrera en caso de que la conexión de red del cliente se pierda antes de que los dos comandos se envíen al
servidor.

A continuación, se muestra un sistema simple de presencia del usuario:

// since I can connect from multiple devices, we store each connection instance separately 
// any time that connectionsRef's value is null (i.e. has no children) I am offline
final FirebaseDatabase database = FirebaseDatabase.getInstance();
final DatabaseReference myConnectionsRef = database.getReference("users/joe/connections");

// stores the timestamp of my last disconnect (the last time I was seen online)
final DatabaseReference lastOnlineRef = database.getReference("/users/joe/lastOnline");

final DatabaseReference connectedRef = database.getReference(".info/connected");

connectedRef.addValueEventListener(new ValueEventListener() {
  @Override
  public void onDataChange(DataSnapshot snapshot) {
    boolean connected = snapshot.getValue(Boolean.class);
    if (connected) {
      DatabaseReference con = myConnectionsRef.push();

      // when this device disconnects, remove it

      con.onDisconnect().removeValue();

      // when I disconnect, update the last time I was seen online

      lastOnlineRef.onDisconnect().setValue(ServerValue.TIMESTAMP);

      // add this device to my connections list

      // this value could contain info about the device or a timestamp too
      con.setValue(Boolean.TRUE);
    }
  }

  @Override
  public void onCancelled(DatabaseError error) {
    System.err.println("Listener was cancelled at .info/connected");
  }
});

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License (http://creativecommons.org/licenses/by/3.0/), and
code samples are licensed under the Apache 2.0 License (http://www.apache.org/licenses/LICENSE-2.0). For details, see our Site Policies
 (https://developers.google.com/terms/site-policies). Java is a registered trademark of Oracle and/or its a liates.

Última actualización: Febrero 26, 2018