ConnectionMigrationOptions.Builder

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

Define se as conexões podem ser migradas para uma rede alternativa quando o Cronet detecta uma degradação do caminho em uso.

Observação: essa configuração pode resultar no envio de solicitações em redes medidas não padrão. Use redes medidas com moderação e ajuste parâmetros como setMaxPathDegradingNonDefaultNetworkMigrationsCount e setMaxTimeOnNonDefaultNetworkSeconds para limitar o tempo em redes não padrão.

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

Ativa a possibilidade de migrar conexões para um endereço de servidor alternativo a pedido do servidor.

public ConnectionMigrationOptions build()

Cria e retorna a instância final de ConnectionMigrationOptions, com base nos valores desse builder.

public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration(
    boolean enableDefaultNetworkConnectionMigration
)

Ativa a possibilidade de migrar conexões na mudança de rede padrão. Se ativada, as conexões QUIC ativas serão migradas para a nova rede quando a plataforma indicar que a rede padrão está mudando.

public ConnectionMigrationOptions.Builder enablePathDegradationMigration(boolean enable)

Ativa a possibilidade de migrar conexões se o caminho atual tiver um desempenho ruim.

Dependendo de outras configurações, isso pode resultar na migração das conexões na mesma rede padrão ou para uma rede não padrão.

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

Configura se a migração de conexões inativas precisa ser ativada ou não.

Se definido como verdadeiro, as conexões inativas também serão migradas, desde que não estejam inativas por muito tempo. A configuração é compartilhada para todos os tipos de migração de conexão. O período máximo de inatividade para o qual as conexões ainda serão migradas pode ser personalizado usando setIdleConnectionMigrationPeriodSeconds.

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

Define se as conexões com erros de pré-handshake precisam ser repetidas em uma rede alternativa.

Se for verdadeiro, uma nova conexão poderá ser estabelecida em uma rede alternativa se falhar na rede padrão antes que o handshake seja confirmado.

Observação: assim como allowNonDefaultNetworkUsage, essa configuração pode resultar no envio de solicitações em redes medidas não padrão. Use com cuidado!

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

Define o período máximo de inatividade para o qual as conexões ainda serão migradas, em segundos. A configuração é compartilhada para todos os tipos de migração de conexão.

Relevante apenas se migrateIdleConnections estiver ativado.

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

Define o número máximo de migrações para a rede não padrão ao encontrar degradação de caminho para a conexão atual. Contado cumulativamente por rede por conexão.

Relevante apenas se allowNonDefaultNetworkUsage estiver ativado.

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

Define o período máximo em que as conexões migradas com urgência precisam permanecer na rede não padrão antes de serem migradas de volta. Esse tempo não é cumulativo. Cada migração da rede padrão para cada conexão é medida e comparada a esse valor separadamente.

Relevante apenas se allowNonDefaultNetworkUsage estiver ativado.

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

Define o número máximo de migrações para a rede não padrão ao encontrar erros de gravação. Contado cumulativamente por rede por conexão.

Relevante apenas se allowNonDefaultNetworkUsage estiver ativado.