ConnectionMigrationOptions.Builder

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder allowNonDefaultNetworkUsage(boolean enable)

Indique si les connexions peuvent être migrées vers un autre réseau lorsque Cronet détecte une dégradation du chemin actuellement utilisé.

Remarque : Ce paramètre peut entraîner l'envoi de requêtes sur des réseaux limités non par défaut. Veillez à utiliser les réseaux limités avec parcimonie et à ajuster les paramètres tels que setMaxPathDegradingNonDefaultNetworkMigrationsCount et setMaxTimeOnNonDefaultNetworkSeconds pour limiter le temps passé sur les réseaux non par défaut.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder allowServerMigration(boolean allowServerMigration)

Permet de migrer les connexions vers une autre adresse de serveur à la demande du serveur.

public ConnectionMigrationOptions build()

Crée et renvoie l'instance ConnectionMigrationOptions finale, en fonction des valeurs de ce compilateur.

public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration(
    boolean enableDefaultNetworkConnectionMigration
)

Permet de migrer les connexions lors du changement de réseau par défaut. Si cette option est activée, les connexions QUIC actives seront migrées vers le nouveau réseau lorsque la plate-forme indique que le réseau par défaut est en cours de modification.

public ConnectionMigrationOptions.Builder enablePathDegradationMigration(boolean enable)

Permet de migrer les connexions si le chemin actuel est peu performant.

En fonction de la configuration, cela peut entraîner la migration des connexions au sein du même réseau par défaut ou vers un réseau non par défaut.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder migrateIdleConnections(boolean migrateIdleConnections)

Configure si la migration des connexions inactives doit être activée ou non.

Si la valeur est définie sur "true", les connexions inactives seront également migrées, à condition qu'elles ne soient pas inactives depuis trop longtemps. Le paramètre est partagé pour tous les types de migration de connexion. La période d'inactivité maximale pendant laquelle les connexions seront toujours migrées peut être personnalisée à l'aide de setIdleConnectionMigrationPeriodSeconds.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder retryPreHandshakeErrorsOnNonDefaultNetwork(
    boolean retryPreHandshakeErrorsOnAlternateNetwork
)

Indique si les connexions présentant des erreurs de pré-établissement doivent être retentées sur un autre réseau.

Si la valeur est "true", une nouvelle connexion peut être établie sur un autre réseau si elle échoue sur le réseau par défaut avant que l'établissement ne soit confirmé.

Remarque : Comme pour allowNonDefaultNetworkUsage, ce paramètre peut entraîner l'envoi de requêtes sur des réseaux limités non par défaut. À utiliser avec précaution !

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setIdleConnectionMigrationPeriodSeconds(
    long idleConnectionMigrationPeriodSeconds
)

Définit la période d'inactivité maximale pendant laquelle les connexions seront toujours migrées, en secondes. Le paramètre est partagé pour tous les types de migration de connexion.

Ne s'applique que si migrateIdleConnections est activé.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setMaxPathDegradingNonDefaultNetworkMigrationsCount(
    int maxPathDegradingEagerMigrationsCount
)

Définit le nombre maximal de migrations vers le réseau non par défaut en cas de dégradation du chemin pour la connexion existante. Comptabilisé de manière cumulative par réseau et par connexion.

Ne s'applique que si allowNonDefaultNetworkUsage est activé.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setMaxTimeOnNonDefaultNetworkSeconds(
    long maxTimeOnNonDefaultNetworkSeconds
)

Définit la période maximale pendant laquelle les connexions migrées de manière anticipée doivent rester sur le réseau non par défaut avant d'être migrées à nouveau. Cette durée n'est pas cumulative : chaque migration hors du réseau par défaut pour chaque connexion est mesurée et comparée à cette valeur séparément.

Ne s'applique que si allowNonDefaultNetworkUsage est activé.

@ConnectionMigrationOptions.Experimental
public ConnectionMigrationOptions.Builder setMaxWriteErrorNonDefaultNetworkMigrationsCount(
    int maxWriteErrorEagerMigrationsCount
)

Définit le nombre maximal de migrations vers le réseau non par défaut en cas d'erreurs d'écriture. Comptabilisé de manière cumulative par réseau et par connexion.

Ne s'applique que si allowNonDefaultNetworkUsage est activé.