ConnectionMigrationOptions.Builder

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

Cronet이 현재 사용 중인 경로의 성능 저하를 감지할 때 연결을 대체 네트워크로 이전할 수 있는지 설정합니다.

참고: 이 설정을 사용하면 기본값이 아닌 종량제 네트워크에서 요청이 전송될 수 있습니다. 종량제 네트워크를 드물게 사용하고 setMaxPathDegradingNonDefaultNetworkMigrationsCount 및 setMaxTimeOnNonDefaultNetworkSeconds와 같은 매개변수를 미세 조정하여 기본값이 아닌 네트워크의 시간을 제한하세요.

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

서버의 요청에 따라 연결을 대체 서버 주소로 이전할 수 있도록 합니다.

public ConnectionMigrationOptions build()

이 빌더의 값을 기반으로 최종 ConnectionMigrationOptions 인스턴스를 만들고 반환합니다.

public ConnectionMigrationOptions.Builder enableDefaultNetworkMigration(
    boolean enableDefaultNetworkConnectionMigration
)

기본 네트워크 변경 시 연결을 이전할 수 있도록 합니다. 사용 설정된 경우 플랫폼에서 기본 네트워크가 변경되고 있음을 나타내면 활성 QUIC 연결이 새 네트워크로 이전됩니다.

public ConnectionMigrationOptions.Builder enablePathDegradationMigration(boolean enable)

현재 경로의 성능이 저하되는 경우 연결을 이전할 수 있도록 합니다.

다른 구성에 따라 동일한 기본 네트워크 내에서 연결을 이전하거나 기본값이 아닌 네트워크로 이전할 수 있습니다.

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

유휴 연결의 이전을 사용 설정할지 구성합니다.

true로 설정하면 유휴 연결이 너무 오래되지 않은 경우 유휴 연결도 이전됩니다. 이 설정은 모든 연결 이전 유형에 공유됩니다. setIdleConnectionMigrationPeriodSeconds를 사용하여 연결이 계속 이전되는 최대 유휴 기간을 맞춤설정할 수 있습니다.

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

핸드셰이크 오류가 발생한 연결을 대체 네트워크에서 재시도할지 설정합니다.

true인 경우 핸드셰이크가 확인되기 전에 기본 네트워크에서 실패하면 대체 네트워크에서 새 연결이 설정될 수 있습니다.

참고: allowNonDefaultNetworkUsage와 마찬가지로 이 설정을 사용하면 기본값이 아닌 종량제 네트워크에서 요청이 전송될 수 있습니다. 주의해서 사용하세요.

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

연결이 계속 이전되는 최대 유휴 기간을 초 단위로 설정합니다. 이 설정은 모든 연결 이전 유형에 공유됩니다.

migrateIdleConnections가 사용 설정된 경우에만 관련이 있습니다.

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

기존 연결의 경로 성능 저하가 발생할 때 기본값이 아닌 네트워크로의 최대 이전 수를 설정합니다. 연결당 네트워크별로 누적 집계됩니다.

allowNonDefaultNetworkUsage가 사용 설정된 경우에만 관련이 있습니다.

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

기본값이 아닌 네트워크에서 다시 이전되기 전에 적극적으로 이전된 연결이 유지되어야 하는 최대 기간을 설정합니다. 이 시간은 누적되지 않습니다. 각 연결의 기본 네트워크에서 벗어나는 각 이전은 이 값을 개별적으로 측정하고 비교합니다.

allowNonDefaultNetworkUsage가 사용 설정된 경우에만 관련이 있습니다.

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

쓰기 오류가 발생할 때 기본값이 아닌 네트워크로의 최대 이전 수를 설정합니다. 연결당 네트워크별로 누적 집계됩니다.

allowNonDefaultNetworkUsage가 사용 설정된 경우에만 관련이 있습니다.