Reland "Refactor the regathering of candidates in P2PTransportChannel."

This is a reland of 14f8aba9967ac2f1789ede12ff66107962757fb5

Original change's description:
> Refactor the regathering of candidates in P2PTransportChannel.
> 
> The functionality of regathering candidates is refactored to a separate
> regathering controller owned by P2PTransportChannel. This refactoring
> is part of a long-term plan to restructure a modularied
> P2PTransportChannel and it would also benefit the addition of autonomous
> regathering of candidates that is proactive to the ICE states in the
> near future.
> 
> Bug: None
> Change-Id: I74cea974ea628430c77b5d51b7c9179ddffc690d
> Reviewed-on: https://webrtc-review.googlesource.com/75820
> Commit-Queue: Qingsi Wang <qingsi@google.com>
> Reviewed-by: Taylor Brandstetter <deadbeef@webrtc.org>
> Cr-Commit-Position: refs/heads/master@{#23588}

Bug: None
Change-Id: I7308e2aef692edd4f0bf9717a88ba2dfba4383a6
Reviewed-on: https://webrtc-review.googlesource.com/83360
Commit-Queue: Qingsi Wang <qingsi@google.com>
Reviewed-by: Taylor Brandstetter <deadbeef@webrtc.org>
Cr-Commit-Position: refs/heads/master@{#23607}
diff --git a/p2p/base/regatheringcontroller.cc b/p2p/base/regatheringcontroller.cc
new file mode 100644
index 0000000..c358e6a
--- /dev/null
+++ b/p2p/base/regatheringcontroller.cc
@@ -0,0 +1,157 @@
+/*
+ *  Copyright 2018 The WebRTC Project Authors. All rights reserved.
+ *
+ *  Use of this source code is governed by a BSD-style license
+ *  that can be found in the LICENSE file in the root of the source
+ *  tree. An additional intellectual property rights grant can be found
+ *  in the file PATENTS.  All contributing project authors may
+ *  be found in the AUTHORS file in the root of the source tree.
+ */
+
+#include "p2p/base/regatheringcontroller.h"
+
+namespace webrtc {
+
+using Config = BasicRegatheringController::Config;
+
+Config::Config(const rtc::Optional<rtc::IntervalRange>&
+                   regather_on_all_networks_interval_range,
+               int regather_on_failed_networks_interval)
+    : regather_on_all_networks_interval_range(
+          regather_on_all_networks_interval_range),
+      regather_on_failed_networks_interval(
+          regather_on_failed_networks_interval) {}
+
+Config::Config(const Config& other) = default;
+
+Config::~Config() = default;
+Config& Config::operator=(const Config& other) = default;
+
+BasicRegatheringController::BasicRegatheringController(
+    const Config& config,
+    cricket::IceTransportInternal* ice_transport,
+    rtc::Thread* thread)
+    : config_(config),
+      ice_transport_(ice_transport),
+      thread_(thread),
+      rand_(rtc::SystemTimeNanos()) {
+  RTC_DCHECK(ice_transport_);
+  RTC_DCHECK(thread_);
+  ice_transport_->SignalStateChanged.connect(
+      this, &BasicRegatheringController::OnIceTransportStateChanged);
+  ice_transport->SignalWritableState.connect(
+      this, &BasicRegatheringController::OnIceTransportWritableState);
+  ice_transport->SignalReceivingState.connect(
+      this, &BasicRegatheringController::OnIceTransportReceivingState);
+  ice_transport->SignalNetworkRouteChanged.connect(
+      this, &BasicRegatheringController::OnIceTransportNetworkRouteChanged);
+}
+
+BasicRegatheringController::~BasicRegatheringController() = default;
+
+void BasicRegatheringController::Start() {
+  ScheduleRecurringRegatheringOnFailedNetworks();
+  if (config_.regather_on_all_networks_interval_range) {
+    ScheduleRecurringRegatheringOnAllNetworks();
+  }
+}
+
+void BasicRegatheringController::SetConfig(const Config& config) {
+  bool need_cancel_on_all_networks =
+      has_recurring_schedule_on_all_networks_ &&
+      (config_.regather_on_all_networks_interval_range !=
+       config.regather_on_all_networks_interval_range);
+  bool need_reschedule_on_all_networks =
+      config.regather_on_all_networks_interval_range &&
+      (config_.regather_on_all_networks_interval_range !=
+       config.regather_on_all_networks_interval_range);
+  bool need_cancel_and_reschedule_on_failed_networks =
+      has_recurring_schedule_on_failed_networks_ &&
+      (config_.regather_on_failed_networks_interval !=
+       config.regather_on_failed_networks_interval);
+  config_ = config;
+  if (need_cancel_on_all_networks) {
+    CancelScheduledRecurringRegatheringOnAllNetworks();
+  }
+  if (need_reschedule_on_all_networks) {
+    ScheduleRecurringRegatheringOnAllNetworks();
+  }
+  if (need_cancel_and_reschedule_on_failed_networks) {
+    CancelScheduledRecurringRegatheringOnFailedNetworks();
+    ScheduleRecurringRegatheringOnFailedNetworks();
+  }
+}
+
+void BasicRegatheringController::ScheduleRecurringRegatheringOnAllNetworks() {
+  RTC_DCHECK(config_.regather_on_all_networks_interval_range &&
+             config_.regather_on_all_networks_interval_range.value().min() >=
+                 0);
+  int delay_ms = SampleRegatherAllNetworksInterval(
+      config_.regather_on_all_networks_interval_range.value());
+  CancelScheduledRecurringRegatheringOnAllNetworks();
+  has_recurring_schedule_on_all_networks_ = true;
+  invoker_for_all_networks_.AsyncInvokeDelayed<void>(
+      RTC_FROM_HERE, thread(),
+      rtc::Bind(
+          &BasicRegatheringController::RegatherOnAllNetworksIfDoneGathering,
+          this, true),
+      delay_ms);
+}
+
+void BasicRegatheringController::RegatherOnAllNetworksIfDoneGathering(
+    bool repeated) {
+  // Only regather when the current session is in the CLEARED state (i.e., not
+  // running or stopped). It is only possible to enter this state when we gather
+  // continually, so there is an implicit check on continual gathering here.
+  if (allocator_session_ && allocator_session_->IsCleared()) {
+    allocator_session_->RegatherOnAllNetworks();
+  }
+  if (repeated) {
+    ScheduleRecurringRegatheringOnAllNetworks();
+  }
+}
+
+void BasicRegatheringController::
+    ScheduleRecurringRegatheringOnFailedNetworks() {
+  RTC_DCHECK(config_.regather_on_failed_networks_interval >= 0);
+  CancelScheduledRecurringRegatheringOnFailedNetworks();
+  has_recurring_schedule_on_failed_networks_ = true;
+  invoker_for_failed_networks_.AsyncInvokeDelayed<void>(
+      RTC_FROM_HERE, thread(),
+      rtc::Bind(
+          &BasicRegatheringController::RegatherOnFailedNetworksIfDoneGathering,
+          this, true),
+      config_.regather_on_failed_networks_interval);
+}
+
+void BasicRegatheringController::RegatherOnFailedNetworksIfDoneGathering(
+    bool repeated) {
+  // Only regather when the current session is in the CLEARED state (i.e., not
+  // running or stopped). It is only possible to enter this state when we gather
+  // continually, so there is an implicit check on continual gathering here.
+  if (allocator_session_ && allocator_session_->IsCleared()) {
+    allocator_session_->RegatherOnFailedNetworks();
+  }
+  if (repeated) {
+    ScheduleRecurringRegatheringOnFailedNetworks();
+  }
+}
+
+void BasicRegatheringController::
+    CancelScheduledRecurringRegatheringOnAllNetworks() {
+  invoker_for_all_networks_.Clear();
+  has_recurring_schedule_on_all_networks_ = false;
+}
+
+void BasicRegatheringController::
+    CancelScheduledRecurringRegatheringOnFailedNetworks() {
+  invoker_for_failed_networks_.Clear();
+  has_recurring_schedule_on_failed_networks_ = false;
+}
+
+int BasicRegatheringController::SampleRegatherAllNetworksInterval(
+    const rtc::IntervalRange& range) {
+  return rand_.Rand(range.min(), range.max());
+}
+
+}  // namespace webrtc